ejklock/living-docs-skill

Living Docs

Run a project's documentation as a living system — not a write-once artifact that rots.

Living Docs is an AI agent skill for documentation-as-code that keeps a codebase's docs in sync with its code. It works with Claude Code, Cursor, GitHub Copilot, OpenCode, Codex, and Pi — any agent that loads markdown "skills" / instruction files. It is stack-agnostic: it governs how docs are organized and maintained (Architecture Decision Records, Behavior Decision Records, PRDs, a constitution, a glossary, living Mermaid diagrams), never what technology a project uses.

The mechanical half of that discipline is owned end-to-end by the bundled living-docs CLI — one self-contained Rust binary that scaffolds records (new, brief), drives their lifecycle (status, describe, supersede), rebuilds indexes (index, fmt), validates the invariants (check), and serves ranked full-text search (search) over a derived read-model — embedded SQLite + FTS5 or ParadeDB. There is no LLM inside the tool: the agent writes only the judgment prose; everything mechanical is deterministic and reproducible.

The whole discipline collapses to one spine:

**Every piece of knowledge has exactly one home, that home is indexed, and nothing structural ships without its