define-architecture

name

define-architecture

description

Generates folder structures, module contracts, middleware pipelines, and frontend/backend boundaries for TypeScript full-stack applications. Use when starting a project, setting up project structure, organizing a monorepo, configuring middleware, defining folder layout, designing backend modules, establishing team conventions, or asking "how should I structure this app", "design the folder structure", or "set up the architecture".

Define Architecture

Define durable, easy-to-change architecture defaults for TypeScript apps.

How to use this skill

Copy and track this checklist:

Architecture progress:
- [ ] Step 1: Determine context (new vs existing codebase) and pick workflow
- [ ] Step 2: Run the chosen workflow end-to-end
- [ ] Step 3: Produce architecture brief using Output template
- [ ] Step 4: Run Validation loop (consistency, quality gates, operability)
- [ ] Step 5: Address any failed checks and re-run Validation loop

1. Determine context:
   • New codebase: follow Architecture setup workflow.
   • Existing codebase: follow Adoption workflow.
2. Produce an architecture brief using Output template.
3. Run Validation loop before finalizing.

Load references only when needed:

• Stack defaults: references/stack-defaults.md
• Shipping and rollout: references/shipping-practices.md
• Engineering quality checklists: references/craftsmanship.md