clean-architecture

Installation
SKILL.md

Clean architecture — sub-skill

Scanner path: commands below assume tools/cc-scan.py / tools/arch-scan.py are in the repo. If they are not, the same scanners may be on PATH as cc-scan / arch-scan (identical flags) — see INSTALL.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
Installs
10
First Seen
Sep 11, 2026