Define Architecture

Define durable, easy-to-change architecture defaults for TypeScript full-stack apps, and produce an architecture brief the team can enforce.

• IS: designing folder structures, module contracts, middleware pipelines, and frontend/backend boundaries; writing an architecture brief; finding domain-informed deepening opportunities in an existing codebase.
• IS NOT: scaffolding a new repo (use scaffold-nextjs for a Next.js turborepo, scaffold-cli for a TypeScript CLI) or multi-tenant domain, isolation, and routing strategy (use multi-tenant-architecture).

Contents

• Principles
• Workflow and references
• Setup workflow (new codebase)
• Adoption workflow (existing codebase)
• Validation loop
• Output template
• Related skills
• Gotchas

Principles (ordered by priority)