Documentation is part of Done — no negotiation.
Docs-as-code tested in CI, an ADR for every real decision, API docs generated from code and everything durable in the archive and index. A broken doc is a bug.
$ schematize install docsNon-negotiable floors
Never switched off "to go faster". Full list in the skill.
Docs are part of the DoD
Documentation is in the Definition of Done, not an end-of-task extra.
An ADR for every decision
Every relevant architectural decision becomes a versioned ADR: proposed → accepted/rejected, never an orphan proposed.
Docs-as-code, tested in CI
The doc lives in the repo, is reviewed in the PR and tested — a link that opens, an example that runs, a snippet that compiles. A broken doc is a bug.
Generated from code
API docs in OpenAPI 3.1 generated from code when possible; changelog + SemVer with breaking changes recorded.
Durable in archive and index
Everything lands in the archive and index/MAP — the trail audit and overdev consume; the root stays clean.
Clear and minimal
A doc nobody reads is debt, not an asset — cut what doesn't serve.
Commands
Installed in .claude/commands/. Run /docs-help anytime.
/docs-adrCreates or moves an ADR (proposed → accepted/rejected) in docs/adr/, with context/decision/alternatives/consequences; never leaves an orphan proposed./docs-apiGenerates/validates the API doc (OpenAPI 3.1/contract) from code when possible, checks spec-vs-implementation drift, and handles changelog + SemVer./docs-ccContext compact: writes context + checklist to the archive and runs /compact./docs-claudeCreates or merges the always-on docs CLAUDE.md at the repo root (won't overwrite other skills' blocks)./docs-handoffWrites the context handoff without compacting — session end or task switch./docs-helpLists every command./docs-loadForce-loads the whole normative body: discipline, ADR, runbook, API/versioning, index/diagrams./docs-runbookScaffolds/updates an operational runbook (symptom → diagnosis → action → verification → rollback → escalate) for a service/incident.For AI agents
Install with no human in the loop. Metadata in llms.txt.
- Run: git clone https://github.com/schematizeme/skill-docs.git && ./skill-docs/install.sh
- Or download: https://github.com/schematizeme/skill-docs/releases/latest/download/skill-docs.zip and unzip into .claude/skills/
- Copy assets/CLAUDE.md to the repo root (always-on rule).
- Confirm with /docs-help.
Diskusi
Memuat…