# maintainable-code

Use this skill passively whenever writing, editing, refactoring, reviewing, or planning code. It keeps agent-generated code understandable, decomposed around stable responsibilities, and aligned with local repository patterns.

Keep `SKILL.md` authoritative. The wrapper files only describe packaging.

Core references:

- `references/principles.md`
- `references/decomposition.md`
- `references/commenting.md`
- `references/review-rubric.md`
- `references/implementation-plans.md`
- `references/guardrails-and-quality-gates.md`
- `references/gotchas.md`

Primary helper:

- `scripts/analyze_maintainability.py`