architecture
Installation
SKILL.md
Architecture
Change how the codebase is structured, typed, or measured for performance — not whether to build a feature, and not language-runtime validation.
Axioms SoT: reference/axioms.md — ride-along load for $dev implement. This SKILL.md (branch pick, Phase 0, references) loads when design is earned or a branch signal matches.
Pick branch
Never ask the user to pick a template when signals are clear. Load one or more when signals combine.
| Branch | Signals | Job |
|---|---|---|
philosophy |
tactical programming, cognitive load, tech debt, complex interface, obscure logic, information leakage, exception-handling bloat | design axioms; evaluate cognitive load and module depth |
deep-modules |
deepen, shallow modules, seams, locality, dual ownership | Module/interface/depth/seam/adapter/locality/deletion test |
refactor-types |
primitive obsession, stringly enums, logic-on-types | Primitives/strings → domain types; logic on types; type hygiene |
refactor-boundaries |
wire/API maps, adapter contract shape, boundary serialize | Wire/API/adapter contract maps; keep domain out of boundary shells |
performance |
slow, hot path, allocate, profile, benchmark | Measure → baseline → optimize; language-free stop rules |
design-patterns |
pattern names, "which pattern", decouple sender/receiver, pluggable strategies, undo/redo, object-creation flexibility | GoF pattern vocabulary; earn a pattern from forces; map to craft |
structure-survey |
tree / directory / layout audit; peer conformity; snowflake; promote / relocate / fold / nest as ownership moves; whole-layer module-layout unification | survey mode → craft as needed |