living-docslisted
Install: claude install-skill ejklock/living-docs-skill
# Living Docs
Treat documentation as a living system that stays in sync with the code, not a write-once artifact that rots. The discipline has one spine — **every piece of knowledge has exactly one home, that home is indexed, and nothing structural ships without its doc** — and several document types that hang off it: a constitution, ADRs, BDRs, PRDs, issues, research, architecture diagrams, and a semantic context index.
This skill is stack-agnostic. It governs *how* docs are organized and maintained, never *what* technology a project uses.
---
## Using this skill (progressive disclosure)
This SKILL.md is a **slim stub** — a trigger plus a task->topic router. The `living-docs` CLI
holds the full, authoritative conventions and templates and discloses them progressively.
**Before authoring anything, load the topic for your task and operate from it, not from this
stub:**
- `living-docs skill living-docs --list` — discover every topic.
- `living-docs skill living-docs --topic <topic>` — load that topic's full rules (+ template).
Piped output is minified JSON (machine default); `--plain` for human text, `--json` to force
JSON. Topics: spine, procedure, adr, prd, bdr, constitution, issue-workflow, glossary,
architecture-diagrams, semantic-index, doc-language, citation, enforcement-modes, check,
okf-format, doc-trail, size-targets, about (run --list for the full set).
This stub is a **pure router** (ADR 0017): it triggers and points at topics — it holds no rules
inline. The