clean-code
Installation
SKILL.md
Clean code & clean architecture — the field ruleset
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.
0. When this skill activates
| Situation | What to do |
|---|---|
| Writing a new module/function for code that will outlive a sprint | §1 + §2, then self-check with §6 |
| "Refactor this function/file" | §1 → apply the rule → keep behaviour identical → run tests |
| Reviewing a PR | checklists/code-review.md, comment with templates/pr-review-comment.md |
| Setting the standard for a team | playbook/ + copy configs/ into the repo + wire tools/cc-scan.py and tools/arch-scan.py into CI |
| Code works but feels dirty | §4 (hygiene) first, refactor second |
| "How should this be structured / which pattern / monolith or services?" | §3 + references/12..14-*.md, decide in an ADR |