designing-architecture

1# Designing Architecture
2 
3### When to Load
4 
5- **Trigger**: System design, module structure, new project scaffolding, choosing architecture patterns
6- **Skip**: Simple bug fixes or minor code changes that don't affect architecture
7 
8## Architecture Decision Workflow
9 
10Copy this checklist and track progress:
11 
12```
13Architecture Design Progress:
14- [ ] Step 1: Understand requirements and constraints
15- [ ] Step 2: Assess project size and team capabilities
16- [ ] Step 3: Select architecture pattern
17- [ ] Step 4: Define directory structure
18- [ ] Step 5: Document trade-offs and decision
19- [ ] Step 6: Validate against decision framework
20```
21 
22## Pattern Selection Guide
23 
24### By Project Size
25 
26| Size              | Recommended Pattern               |
27| ----------------- | --------------------------------- |
28| Small (<10K LOC)  | Simple MVC/Layered                |
29| Medium (10K-100K) | Clean Architecture                |
30| Large (>100K)     | Modular Monolith or Microservices |
31 
32### By Team Size
33 
34| Team      | Recommended                  |
35| --------- | ---------------------------- |
36| 1-3 devs  | Monolith with clear modules  |
37| 4-10 devs | Modular Monolith             |
38| 10+ devs  | Microservices (if justified) |
39 
40## Common Patterns
41 
42### 1. Layered Architecture
43 
44```
45┌─────────────────────────────┐
46│       Presentation          │  ← UI, API Controllers
47├─────────────────────────────┤
48│       Application           │  ← Use Cases, Services
49├─────────────────────────────┤
50…