clean-architecture
Installation
SKILL.md
Clean architecture — sub-skill
Scanner path: commands below assume
tools/cc-scan.py/tools/arch-scan.pyare in the repo. If they are not, the same scanners may be onPATHascc-scan/arch-scan(identical flags) — seeINSTALL.md§1b. If neither exists, ask for the report instead of guessing numbers.
Parent skill: ../clean-code/SKILL.md. Deep material: ../clean-code/references/12-clean-architecture.md,
13-architecture-patterns.md, 14-design-patterns.md. Tooling: tools/arch-scan.py +
configs/architecture/.
0. Trigger table
| Ask | Do this |
|---|---|
| "Review the structure of this repo" | §1 census → §2 dependency rule → report with the vocabulary of §5 |
| "Where does this code belong?" | §3 placement test, 4 questions |
| "Should we split into services / use events / CQRS?" | §4, in that order, with the reversibility column of references/13 |
| "Which pattern for this problem?" | references/14-design-patterns.md §1–§2; if no pattern's problem is present, the answer is "none" |
| "Enforce it" | §6: config file + CI job + baseline, 30 minutes of work |