dev-architecture
Installation
SKILL.md
Dev-Architecture — Module Boundaries & Structural Integrity
C0/C1 work (small local patches): See
dev§0.0 Work Classifier + §0.1 Patch Fast-Path before reading references. Always readdev/SKILL.mdfirst for project-wide conventions before applying architecture rules.
Enforces architectural rules that prevent structural decay: circular dependencies, implicit coupling, barrel abuse, and misplaced validation. These rules are mechanical — an AI coding agent can follow them without subjective judgment.
Severity mapping (dev §0.2): Severity: CRITICAL/HIGH ⇒ STRICT; MEDIUM ⇒ DEFAULT.
Modular References
| File | When to Read | What It Covers |
|---|---|---|
references/circular-dependencies.md |
Detecting or fixing import cycles | Detection commands (madge/pydeps/go vet), fix strategies, real examples |
references/coupling-taxonomy.md |
Reviewing code for hidden coupling | 8 coupling types, severity matrix, refactoring patterns, banned review responses |
references/barrel-discipline.md |
Creating/modifying index/barrel files | When barrels OK vs banned, tree-shaking impact, safe barrel template |