DDD Architecture Selector
Architecture selection decision guide that evaluates 5 DDD architecture patterns (Layered, Onion, Hexagonal, Clean, COLA) against project context — team size, business complexity, tech stack, infrastructure change frequency, and ecosystem preference.
Workflow
Step 1: Collect Project Context
- Team size & DDD experience level
- Business complexity (simple CRUD / moderate / high)
- Technical stack (Spring Boot / Go / Node.js / .NET / Python)
- Infrastructure change frequency (low / medium / high)
- Multi-entry needs (REST + CLI + MQ + gRPC?)
- Test coverage requirements (unit / integration / E2E)
- Ecosystem preference (Chinese community / international)
Step 2: Run Decision Matrix
- Compare 5 architectures across 7+ dimensions
Step 3: Apply Decision Tree
- Complexity → Team Size → Tech Stack → Recommended Architecture
Step 4: Recommend CQRS Level
- L0: None, L1: Model Separation, L2: DB Separation, L3: Event Sourcing
Step 5: Classify Domain Types
- Core / Generic / Supporting → Apply different architectures per domain
Step 6: Suggest Microservice Splitting
- One BC → One Service, with merge/split rules
Step 7: Route to Specific Architecture Skill
- Link to detailed implementation guidance
When to Use (and When NOT to)
| ✅ Use When |
❌ Skip When |
| Starting a new project: need architecture decision |
Architecture already decided → go directly to that skill |
| Comparing multiple DDD architectures |
Just need DDD learning → use ddd-architecture-awesome |
| Team unsure which approach fits best |
Need architecture evaluation of existing project → use ddd-architecture-evaluator |
| Planning microservice splitting strategy |
Need domain modeling after selection → use ddd-domain-designer |
| Evaluating CQRS necessity |
Non-DDD project evaluation (consider standard MVC) |
| Chinese enterprise team making tech decisions |
Simple CRUD with no DDD needed → use standard MVC |
| Team size / DDD maturity unknown |
Need code review of existing DDD code → use ddd-code-reviewer |
Boundary
| Category |
Description |
Alternative |
| ✅ Handles |
New project architecture selection (5 DDD architectures) |
— |
| ✅ Handles |
Architecture comparison for migration decisions |
— |
| ✅ Handles |
CQRS / Event Sourcing necessity assessment |
— |
| ✅ Handles |
Domain classification (Core / Generic / Supporting) |
— |
| ✅ Handles |
Microservice splitting based on bounded contexts |
— |
| ✅ Handles |
Team size → architecture mapping |
— |
| ⚠️ Requires |
Basic project context: team size, business complexity, tech stack |
— |
| ⚠️ Requires |
Domain expert or product owner involvement for classification |
— |
| ❌ Out of Scope |
Architecture already decided — do not use this skill |
ddd-architecture-layered / ddd-architecture-onion / ddd-architecture-hexagonal / ddd-architecture-clean / ddd-architecture-cola (Install each with: npx skills add full-stack-skills/ddd-skills --skill <name>) |
| ❌ Out of Scope |
Just need DDD learning & concepts — should not use this skill |
ddd-architecture-awesome (Install: npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-awesome) |
| ❌ Out of Scope |
Evaluate existing architecture health & quality — do not use |
ddd-architecture-evaluator (Install: npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-evaluator) |
| ❌ Out of Scope |
Domain modeling / aggregate design after selection — not use |
ddd-domain-designer (Install: npx skills add full-stack-skills/ddd-skills --skill ddd-domain-designer) |
| ❌ Out of Scope |
Code review for DDD compliance — do not use this skill |
ddd-code-reviewer (Install: npx skills add full-stack-skills/ddd-skills --skill ddd-code-reviewer) |
| ❌ Out of Scope |
Non-DDD / standard MVC projects — not use this skill |
Use standard MVC guides (not DDD skills) |
Audience
This skill is designed for: Backend developers (implementing DDD architectures), Software architects (evaluating and selecting patterns), Tech leads (reviewing team implementations), and DDD beginners (learning domain-driven design fundamentals).
Rules
- Architecture selection must evaluate at least 5 dimensions.
- Never recommend Event Sourcing as default — only after L2 CQRS success.
- Team size and domain complexity must be the primary selection factors.
5-Architecture Decision Matrix
| Dimension |
Layered |
Onion |
Hexagonal |
Clean |
COLA |
| Learning Cost |
★☆☆ |
★★★ |
★★★ |
★★★ |
★★☆ |
| Business Complexity Fit |
★☆☆ |
★★★ |
★★★ |
★★★ |
★★★ |
| CRUD Efficiency |
★★★ |
★☆☆ |
★☆☆ |
★☆☆ |
★★☆ |
| Infrastructure Replaceability |
★☆☆ |
★★★ |
★★★ |
★★★ |
★★☆ |
| Test Friendliness |
★☆☆ |
★★★ |
★★★ |
★★★ |
★★★ |
| Chinese Community |
★★★ |
★☆☆ |
★☆☆ |
★☆☆ |
★★★ |
| Code Generation Support |
Good |
Poor |
Poor |
Poor |
Excellent |
| Module Physical Isolation |
Low |
Medium |
Medium |
High |
High |
| Evolution Path Clarity |
★☆☆ |
★★★ |
★★★ |
★★★ |
★★★ |
| Team Size Fit |
1-5 |
5-15 |
5-15 |
15-50 |
5-50 |
| Origin |
Martin Fowler |
Jeffrey Palermo (2008) |
Alistair Cockburn (2005) |
Robert C. Martin (2012) |
Alibaba (2018) |
| Architecture |
Best For |
Avoid When |
| Layered |
Simple CRUD, small teams, traditional MVC migration |
Complex business rules, frequent infra changes |
| Onion |
High test coverage, changing infrastructure |
CRUD-heavy apps, teams with no abstraction experience |
| Hexagonal |
Multi-entry systems, microservice standardization |
Simple single-entry CRUD, quick prototypes |
| Clean |
Large enterprise systems, strict physical isolation |
Small teams (<5), rapid MVP iterations |
| COLA |
Chinese Spring Boot ecosystem, engineering standards |
Non-Java stacks, international teams |
3-Step Decision Tree
Step 1: Assess Business Complexity
Business Complexity?
│
├── Simple CRUD (80%+ CRUD operations)
│ └── Planning DDD adoption in future?
│ ├── No → LAYERED ARCHITECTURE
│ └── Yes → COLA Simplified (single module)
│
├── Moderate (core business logic with rules)
│ ├── Chinese ecosystem / Spring Boot + MyBatis? → COLA
│ ├── Value domain layer purity most? → HEXAGONAL
│ ├── Multi-entry system (REST + CLI + MQ)? → HEXAGONAL
│ ├── Infrastructure changes often? → HEXAGONAL / ONION
│ └── .NET / Python stack? → ONION
│
└── High (multiple BCs, microservices)
├── Enterprise / international team? → CLEAN ARCHITECTURE
├── Chinese enterprise, per-service standards? → COLA (multi-module)
├── Mixed tech stack per service? → HEXAGONAL per service
└── Need microservice + standard per module? → COLA + HEXAGONAL hybrid
Step 2: Match Team Size
| Team Size |
Recommended Architecture |
Rationale |
| 1-5 |
Layered or COLA simplified |
Lowest ceremony, fastest delivery |
| 5-15 |
Hexagonal / Onion / COLA (single module) |
Balance abstraction and productivity |
| 15-50 |
Clean / COLA (multi-module) |
Physical isolation, parallel team work |
| 50+ |
Microservices + Hexagonal per service |
Autonomous teams, independent deploy |
Evolution Path: Team grows → upgrade architecture progressively: 1-5 (Layered) → 5-15 (Hexagonal) → 15-50 (Clean/COLA) → 50+ (Microservices+Hex).
Step 3: Final Recommendation
| If you have... |
Then choose... |
Why |
| Spring Boot + MyBatis + Chinese team |
COLA |
Ecosystem match, Chinese docs, scaffolding |
| Multi-entry (REST + CLI + MQ + gRPC) |
Hexagonal |
Adapter pattern handles multiple entry points |
| Strict module physical isolation, large enterprise |
Clean |
Entity → UseCase → Adapter enforced isolation |
| Infrastructure changes often (DB, MQ swap) |
Hexagonal or Onion |
Port/Adapter makes swapping trivial |
| Rapid prototype → evolve DDD later |
Layered → upgrade |
Lowest startup cost, clear evolution path |
| Complex business rules + TDD |
Hexagonal |
Domain layer independently testable |
| Team new to DDD, incremental adoption |
Layered |
Closest to traditional 3-tier, gentlest learning curve |
| Microservice internal architecture standard |
Hexagonal + COLA per service |
Port isolation + engineering standards |
| Read-heavy, complex queries |
CQRS L2 |
Read/write separation, independent optimization |
| Full audit trail needed |
Event Sourcing (L3) |
Event stream naturally supports audit |
Domain Partitioning + Microservice Splitting
Domain Classification (Core / Generic / Supporting)
| Domain Type |
Investment Strategy |
Architecture Recommendation |
Examples |
| Core Domain (核心域) |
Max investment, build in-house |
Hexagonal / Clean / COLA with rich domain model |
Order management, Payment processing, Pricing engine |
| Generic Domain (通用域) |
Purchase or open-source reuse |
Layered or off-the-shelf SaaS |
Authentication, Authorization, Notification |
| Supporting Domain (支撑域) |
Outsource or low priority |
Layered or simple CRUD |
Reports, Admin dashboard, Data export |
Key rule: Don't apply Hexagonal or Clean to generic/supporting domains — it wastes effort. Reserve complex architectures for Core domains only.
Microservice Splitting Rules
- Default: One Bounded Context → One Microservice
- Split when: Different deployment cadence, different scaling needs, different team ownership
- Merge when: Strong transactional consistency needed, small context (< 2 weeks dev), same team
- Start conservative: Fewer services, split as needed (proven by need, not anticipation)
- Communication: Events for eventual consistency, RPC for strong consistency (rare)
CQRS Level Suggestion
| Level |
Description |
Cost |
Architecture Support |
When to Use |
| L0 — None |
Single model, single DB |
Zero |
All architectures (default) |
Simple CRUD, no read/write conflict |
| L1 — Model Separation |
CommandService + QueryService, shared DB |
Low |
All architectures |
Moderate read/write disparity |
| L2 — DB Separation |
Command DB + Read DB (ES/slave), sync via events |
Medium |
Hexagonal / Clean / COLA |
High read volume, complex queries |
| L3 — Event Sourcing |
Event Store + Projections, full event replay |
High |
Hexagonal / Clean |
Audit trail, temporal queries, compliance |
Recommendation: Start at L0, prove need for higher levels. L2+ should only be adopted alongside Hexagonal or Clean architectures for proper port isolation.
Architecture Skill Navigation
| Selected |
Next Skill |
| Layered |
ddd-architecture-layered (Install: npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-layered) |
| Onion |
ddd-architecture-onion (Install: npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-onion) |
| Hexagonal |
ddd-architecture-hexagonal (Install: npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-hexagonal) |
| Clean |
ddd-architecture-clean (Install: npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-clean) |
| COLA |
ddd-architecture-cola (Install: npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-cola) |
Related: ddd-cqrs-architecture / ddd-domain-designer / ddd-architecture-evaluator (each installable via npx skills add full-stack-skills/ddd-skills --skill <name>)
Gotchas
See references/gotchas.md for 15 pitfalls.
FAQ
See references/faq.md for 15 Q&A.
Security & Safety
This skill is pure documentation. It does not collect user data, does not access external services or networks, and contains no executable scripts.
References
See references/ for deep comparisons, microservice/domain, clean+DDD+hexagonal, ddd4j analysis, gotchas, FAQ, external resources, and 5 case studies.
1---2name: ddd-architecture-selector3description: Architecture selection decision guide — help users choose from 5 DDD architectures (Layered/Onion/Hexagonal/Clean/COLA) with decision matrix, team size mapping, domain classification (core/generic/supporting), microservice splitting recommendation, and CQRS level suggestion. Use when user asks about architecture selection, 架构选型, COLA vs 六边形, cleaner architecture vs onion, 微服务拆分, or which architecture to use.4license: Apache-2.05---67# DDD Architecture Selector89Architecture selection decision guide that evaluates 5 DDD architecture patterns (Layered, Onion, Hexagonal, Clean, COLA) against project context — team size, business complexity, tech stack, infrastructure change frequency, and ecosystem preference.1011## Workflow1213### Step 1: Collect Project Context14- Team size & DDD experience level15- Business complexity (simple CRUD / moderate / high)16- Technical stack (Spring Boot / Go / Node.js / .NET / Python)17- Infrastructure change frequency (low / medium / high)18- Multi-entry needs (REST + CLI + MQ + gRPC?)19- Test coverage requirements (unit / integration / E2E)20- Ecosystem preference (Chinese community / international)2122### Step 2: Run Decision Matrix23- Compare 5 architectures across 7+ dimensions2425### Step 3: Apply Decision Tree26- Complexity → Team Size → Tech Stack → Recommended Architecture2728### Step 4: Recommend CQRS Level29- L0: None, L1: Model Separation, L2: DB Separation, L3: Event Sourcing3031### Step 5: Classify Domain Types32- Core / Generic / Supporting → Apply different architectures per domain3334### Step 6: Suggest Microservice Splitting35- One BC → One Service, with merge/split rules3637### Step 7: Route to Specific Architecture Skill38- Link to detailed implementation guidance3940## When to Use (and When NOT to)4142| ✅ Use When | ❌ Skip When |43|------------|-------------|44| Starting a new project: need architecture decision | Architecture already decided → go directly to that skill |45| Comparing multiple DDD architectures | Just need DDD learning → use `ddd-architecture-awesome` |46| Team unsure which approach fits best | Need architecture evaluation of existing project → use `ddd-architecture-evaluator` |47| Planning microservice splitting strategy | Need domain modeling after selection → use `ddd-domain-designer` |48| Evaluating CQRS necessity | Non-DDD project evaluation (consider standard MVC) |49| Chinese enterprise team making tech decisions | Simple CRUD with no DDD needed → use standard MVC |50| Team size / DDD maturity unknown | Need code review of existing DDD code → use `ddd-code-reviewer` |5152## Boundary5354| Category | Description | Alternative |55|----------|-------------|------------|56| ✅ **Handles** | New project architecture selection (5 DDD architectures) | — |57| ✅ **Handles** | Architecture comparison for migration decisions | — |58| ✅ **Handles** | CQRS / Event Sourcing necessity assessment | — |59| ✅ **Handles** | Domain classification (Core / Generic / Supporting) | — |60| ✅ **Handles** | Microservice splitting based on bounded contexts | — |61| ✅ **Handles** | Team size → architecture mapping | — |62| ⚠️ **Requires** | Basic project context: team size, business complexity, tech stack | — |63| ⚠️ **Requires** | Domain expert or product owner involvement for classification | — |64| ❌ **Out of Scope** | Architecture already decided — do not use this skill | **`ddd-architecture-layered`** / **`ddd-architecture-onion`** / **`ddd-architecture-hexagonal`** / **`ddd-architecture-clean`** / **`ddd-architecture-cola`** (Install each with: `npx skills add full-stack-skills/ddd-skills --skill <name>`) |65| ❌ **Out of Scope** | Just need DDD learning & concepts — should not use this skill | **`ddd-architecture-awesome`** (Install: `npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-awesome`) |66| ❌ **Out of Scope** | Evaluate existing architecture health & quality — do not use | **`ddd-architecture-evaluator`** (Install: `npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-evaluator`) |67| ❌ **Out of Scope** | Domain modeling / aggregate design after selection — not use | **`ddd-domain-designer`** (Install: `npx skills add full-stack-skills/ddd-skills --skill ddd-domain-designer`) |68| ❌ **Out of Scope** | Code review for DDD compliance — do not use this skill | **`ddd-code-reviewer`** (Install: `npx skills add full-stack-skills/ddd-skills --skill ddd-code-reviewer`) |69| ❌ **Out of Scope** | Non-DDD / standard MVC projects — not use this skill | Use standard MVC guides (not DDD skills) |7071## Audience7273This skill is designed for: **Backend developers** (implementing DDD architectures), **Software architects** (evaluating and selecting patterns), **Tech leads** (reviewing team implementations), and **DDD beginners** (learning domain-driven design fundamentals).7475## Rules76771. Architecture selection must evaluate at least 5 dimensions.782. Never recommend Event Sourcing as default — only after L2 CQRS success.793. Team size and domain complexity must be the primary selection factors.8081## 5-Architecture Decision Matrix8283| Dimension | Layered | Onion | Hexagonal | Clean | COLA |84|-----------|:--:|:--:|:--:|:--:|:--:|85| **Learning Cost** | ★☆☆ | ★★★ | ★★★ | ★★★ | ★★☆ |86| **Business Complexity Fit** | ★☆☆ | ★★★ | ★★★ | ★★★ | ★★★ |87| **CRUD Efficiency** | ★★★ | ★☆☆ | ★☆☆ | ★☆☆ | ★★☆ |88| **Infrastructure Replaceability** | ★☆☆ | ★★★ | ★★★ | ★★★ | ★★☆ |89| **Test Friendliness** | ★☆☆ | ★★★ | ★★★ | ★★★ | ★★★ |90| **Chinese Community** | ★★★ | ★☆☆ | ★☆☆ | ★☆☆ | ★★★ |91| **Code Generation Support** | Good | Poor | Poor | Poor | Excellent |92| **Module Physical Isolation** | Low | Medium | Medium | High | High |93| **Evolution Path Clarity** | ★☆☆ | ★★★ | ★★★ | ★★★ | ★★★ |94| **Team Size Fit** | 1-5 | 5-15 | 5-15 | 15-50 | 5-50 |95| **Origin** | Martin Fowler | Jeffrey Palermo (2008) | Alistair Cockburn (2005) | Robert C. Martin (2012) | Alibaba (2018) |9697| Architecture | Best For | Avoid When |98|-------------|----------|------------|99| **Layered** | Simple CRUD, small teams, traditional MVC migration | Complex business rules, frequent infra changes |100| **Onion** | High test coverage, changing infrastructure | CRUD-heavy apps, teams with no abstraction experience |101| **Hexagonal** | Multi-entry systems, microservice standardization | Simple single-entry CRUD, quick prototypes |102| **Clean** | Large enterprise systems, strict physical isolation | Small teams (<5), rapid MVP iterations |103| **COLA** | Chinese Spring Boot ecosystem, engineering standards | Non-Java stacks, international teams |104105## 3-Step Decision Tree106107### Step 1: Assess Business Complexity108109```110Business Complexity?111│112├── Simple CRUD (80%+ CRUD operations)113│ └── Planning DDD adoption in future?114│ ├── No → LAYERED ARCHITECTURE115│ └── Yes → COLA Simplified (single module)116│117├── Moderate (core business logic with rules)118│ ├── Chinese ecosystem / Spring Boot + MyBatis? → COLA119│ ├── Value domain layer purity most? → HEXAGONAL120│ ├── Multi-entry system (REST + CLI + MQ)? → HEXAGONAL121│ ├── Infrastructure changes often? → HEXAGONAL / ONION122│ └── .NET / Python stack? → ONION123│124└── High (multiple BCs, microservices)125 ├── Enterprise / international team? → CLEAN ARCHITECTURE126 ├── Chinese enterprise, per-service standards? → COLA (multi-module)127 ├── Mixed tech stack per service? → HEXAGONAL per service128 └── Need microservice + standard per module? → COLA + HEXAGONAL hybrid129```130131### Step 2: Match Team Size132133| Team Size | Recommended Architecture | Rationale |134|-----------|------------------------|-----------|135| 1-5 | Layered or COLA simplified | Lowest ceremony, fastest delivery |136| 5-15 | Hexagonal / Onion / COLA (single module) | Balance abstraction and productivity |137| 15-50 | Clean / COLA (multi-module) | Physical isolation, parallel team work |138| 50+ | Microservices + Hexagonal per service | Autonomous teams, independent deploy |139140**Evolution Path**: Team grows → upgrade architecture progressively: 1-5 (Layered) → 5-15 (Hexagonal) → 15-50 (Clean/COLA) → 50+ (Microservices+Hex).141142### Step 3: Final Recommendation143144| If you have... | Then choose... | Why |145|---------------|---------------|-----|146| Spring Boot + MyBatis + Chinese team | **COLA** | Ecosystem match, Chinese docs, scaffolding |147| Multi-entry (REST + CLI + MQ + gRPC) | **Hexagonal** | Adapter pattern handles multiple entry points |148| Strict module physical isolation, large enterprise | **Clean** | Entity → UseCase → Adapter enforced isolation |149| Infrastructure changes often (DB, MQ swap) | **Hexagonal** or **Onion** | Port/Adapter makes swapping trivial |150| Rapid prototype → evolve DDD later | **Layered** → upgrade | Lowest startup cost, clear evolution path |151| Complex business rules + TDD | **Hexagonal** | Domain layer independently testable |152| Team new to DDD, incremental adoption | **Layered** | Closest to traditional 3-tier, gentlest learning curve |153| Microservice internal architecture standard | **Hexagonal** + **COLA** per service | Port isolation + engineering standards |154| Read-heavy, complex queries | **CQRS L2** | Read/write separation, independent optimization |155| Full audit trail needed | **Event Sourcing** (L3) | Event stream naturally supports audit |156157## Domain Partitioning + Microservice Splitting158159### Domain Classification (Core / Generic / Supporting)160161| Domain Type | Investment Strategy | Architecture Recommendation | Examples |162|-------------|-------------------|---------------------------|----------|163| **Core Domain** (核心域) | Max investment, build in-house | Hexagonal / Clean / COLA with rich domain model | Order management, Payment processing, Pricing engine |164| **Generic Domain** (通用域) | Purchase or open-source reuse | Layered or off-the-shelf SaaS | Authentication, Authorization, Notification |165| **Supporting Domain** (支撑域) | Outsource or low priority | Layered or simple CRUD | Reports, Admin dashboard, Data export |166167**Key rule**: Don't apply Hexagonal or Clean to generic/supporting domains — it wastes effort. Reserve complex architectures for Core domains only.168169### Microservice Splitting Rules1701711. **Default**: One Bounded Context → One Microservice1722. **Split when**: Different deployment cadence, different scaling needs, different team ownership1733. **Merge when**: Strong transactional consistency needed, small context (< 2 weeks dev), same team1744. **Start conservative**: Fewer services, split as needed (proven by need, not anticipation)1755. **Communication**: Events for eventual consistency, RPC for strong consistency (rare)176177## CQRS Level Suggestion178179| Level | Description | Cost | Architecture Support | When to Use |180|-------|-------------|------|---------------------|-------------|181| **L0 — None** | Single model, single DB | Zero | All architectures (default) | Simple CRUD, no read/write conflict |182| **L1 — Model Separation** | CommandService + QueryService, shared DB | Low | All architectures | Moderate read/write disparity |183| **L2 — DB Separation** | Command DB + Read DB (ES/slave), sync via events | Medium | Hexagonal / Clean / COLA | High read volume, complex queries |184| **L3 — Event Sourcing** | Event Store + Projections, full event replay | High | Hexagonal / Clean | Audit trail, temporal queries, compliance |185186**Recommendation**: Start at L0, prove need for higher levels. L2+ should only be adopted alongside Hexagonal or Clean architectures for proper port isolation.187188## Architecture Skill Navigation189190| Selected | Next Skill |191|----------|-----------|192| Layered | **`ddd-architecture-layered`** (Install: `npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-layered`) |193| Onion | **`ddd-architecture-onion`** (Install: `npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-onion`) |194| Hexagonal | **`ddd-architecture-hexagonal`** (Install: `npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-hexagonal`) |195| Clean | **`ddd-architecture-clean`** (Install: `npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-clean`) |196| COLA | **`ddd-architecture-cola`** (Install: `npx skills add full-stack-skills/ddd-skills --skill ddd-architecture-cola`) |197198Related: **`ddd-cqrs-architecture`** / **`ddd-domain-designer`** / **`ddd-architecture-evaluator`** (each installable via `npx skills add full-stack-skills/ddd-skills --skill <name>`)199200## Gotchas201202See [references/gotchas.md](references/gotchas.md) for 15 pitfalls.203204## FAQ205206See [references/faq.md](references/faq.md) for 15 Q&A.207208## Security & Safety209210This skill is pure documentation. It does not collect user data, does not access external services or networks, and contains no executable scripts.211212## References213214See [references/](references/) for deep comparisons, microservice/domain, clean+DDD+hexagonal, ddd4j analysis, gotchas, FAQ, external resources, and 5 case studies.