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
Installs
16
First Seen
Jul 12, 2026