Dokumentation gehört zu Done — kompromisslos.
Docs-as-code im CI getestet, ein ADR für jede echte Entscheidung, aus dem Code generierte API-Docs und alles dauerhaft im Archiv und Index. Eine kaputte Doc ist ein Bug.
$ schematize install docsNicht verhandelbare Mindeststandards
Werden nie abgeschaltet, "um schneller zu sein". Vollständige Liste in der Skill.
Doc gehört zur DoD
Dokumentation steht in der Definition of Done, nicht als End-of-Task-Extra.
Ein ADR für jede Entscheidung
Jede relevante Architekturentscheidung wird ein versioniertes ADR: proposed → accepted/rejected, nie ein verwaistes proposed.
Docs-as-code, im CI getestet
Die Doc lebt im Repo, wird im PR reviewt und getestet — ein Link der öffnet, ein Beispiel das läuft, ein Snippet das kompiliert. Eine kaputte Doc ist ein Bug.
Aus dem Code generiert
API-Docs in OpenAPI 3.1 aus dem Code generiert wo möglich; Changelog + SemVer mit erfassten Breaking Changes.
Dauerhaft in Archiv und Index
Alles landet im Archiv und im Index/MAP — der Pfad, den Audit und Overdev konsumieren; das Root-Verzeichnis bleibt sauber.
Klar und minimal
Eine Doc, die niemand liest, ist Schuld, kein Vermögen — streiche, was nicht dient.
Befehle
Installiert in .claude/commands/. Führe /docs-help jederzeit aus.
/docs-adrErstellt oder bewegt ein ADR (proposed → accepted/rejected) in docs/adr/, mit Kontext/Entscheidung/Alternativen/Konsequenzen; lässt nie ein verwaistes proposed./docs-apiGeneriert/validiert die API-Doc (OpenAPI 3.1/Contract) aus dem Code wo möglich, prüft den Drift zwischen Spec und Implementierung und pflegt Changelog + SemVer./docs-ccContext compact: schreibt Kontext + Checkliste ins Archiv und führt /compact aus./docs-claudeErstellt oder fügt die Immer-an-Docs-CLAUDE.md im Repo-Root zusammen (überschreibt keine Blöcke anderer Skills)./docs-handoffSchreibt das Kontext-Handoff ohne Kompaktierung — Sitzungsende oder Aufgabenwechsel./docs-helpListet alle Befehle auf./docs-loadLädt zwangsweise das gesamte Regelwerk: Disziplin, ADR, Runbook, API/Versionierung, Index/Diagramme./docs-runbookScaffoldet/aktualisiert ein operatives Runbook (Symptom → Diagnose → Aktion → Verifikation → Rollback → Eskalation) für einen Dienst/Vorfall.Für KI-Agenten
Ohne menschliches Eingreifen installieren. Metadaten in llms.txt.
- Ausführen: git clone https://github.com/schematizeme/skill-docs.git && ./skill-docs/install.sh
- Oder herunterladen: https://github.com/schematizeme/skill-docs/releases/latest/download/skill-docs.zip und nach .claude/skills/ entpacken
- Kopiere assets/CLAUDE.md in das Repo-Root (Immer-an-Regel).
- Bestätige mit /docs-help.
Diskussion
Wird geladen…