docs-health
Installation
SKILL.md
Docs Health
Create, verify, and maintain ALL project documentation — living docs AND historical snapshots. Documentation that lies is worse than missing documentation.
The documentation model
Each file has ONE job. Each fact lives in exactly ONE place. When the same fact appears in multiple files, they drift.
| File | Owns | Lifecycle |
|---|---|---|
README.md |
What this is, why, how to start | Living |
AGENTS.md |
Non-obvious context for AI sessions | Living |
FEATURES.md |
What features exist + honest status | Living |
TODO_LIST.md |
Short-term actionable work (open only) | Living |
ROADMAP.md |
Long-term vision, raw ideas | Living |
CHANGELOG.md |
What changed in each version | Append-only |
docs/DOMAIN_LANGUAGE.md |
Domain terms and definitions | Living |
docs/status/, docs/planning/, docs/reviews/ |
Point-in-time snapshots | Historical |