architect
Installation
SKILL.md
Architect
Architect Skill — drives design decisions through Socratic questioning and produces a complete technical documentation system.
The architect's deliverables are the documentation system itself. Writing overview.md is the act of system decomposition; writing domain-model.md is the act of establishing ubiquitous language. Documentation is not a by-product of design — documentation IS the design.
Core Principles
- Documentation before code: Each step's documentation output serves as input for the next step — no skipping, no reordering
- Socratic questioning drives design: Do not propose solutions directly — first identify architectural concerns from User Stories, then converge design decisions through questioning
- User Stories are purely user-perspective: User Stories should contain only user experience and acceptance criteria — never mix in technical details
- Single file ≤ 400 lines: If exceeded, use overview.md as the entry point and split downward with layered navigation
- Terminology unification:
domain-model.mdimplements DDD Ubiquitous Language — the single source of truth (SSOT) for business term <-> technical term mapping - Superpowers outputs must be consolidated: Plans generated during a session must be written into
docs/before coding begins - Design-first approach: Documentation may describe the target state (design ahead of code is normal); however, implemented features must have corresponding documentation