La documentation fait partie du Done — sans négocier.
Docs-as-code testée en CI, un ADR pour chaque vraie décision, une API doc générée du code et tout durable dans l'archive et l'index. Une doc cassée est un bug.
$ schematize install docsSocles non négociables
Jamais désactivés "pour aller plus vite". Liste complète dans la skill.
La doc fait partie du DoD
La documentation est dans la Definition of Done, pas un extra de fin de tâche.
Un ADR pour chaque décision
Toute décision d'architecture pertinente devient un ADR versionné : proposed → accepted/rejected, jamais un proposed orphelin.
Docs-as-code, testée en CI
La doc vit dans le repo, est revue dans la PR et testée — un lien qui s'ouvre, un exemple qui tourne, un snippet qui compile. Une doc cassée est un bug.
Générée du code
API doc en OpenAPI 3.1 générée du code quand c'est possible ; changelog + SemVer avec breaking change enregistré.
Durable dans l'archive et l'index
Tout atterrit dans l'archive et l'index/MAP — la trace que l'audit et l'overdev consomment ; la racine reste propre.
Claire et minimale
Une doc que personne ne lit est une dette, pas un patrimoine — coupez ce qui ne sert pas.
Commandes
Installées dans .claude/commands/. Lancez /docs-help à tout moment.
/docs-adrCrée ou déplace un ADR (proposed → accepted/rejected) dans docs/adr/, avec contexte/décision/alternatives/conséquences ; ne laisse jamais un proposed orphelin./docs-apiGénère/valide l'API doc (OpenAPI 3.1/contrat) depuis le code quand c'est possible, vérifie le drift entre spec et implémentation, et gère le changelog + SemVer./docs-ccContext compact : écrit contexte + checklist dans l'archive et lance /compact./docs-claudeCrée ou fusionne le CLAUDE.md toujours actif de documentation à la racine (n'écrase pas les blocs d'autres skills)./docs-handoffÉcrit le handoff de contexte sans compacter — fin de session ou changement de tâche./docs-helpListe toutes les commandes./docs-loadCharge de force tout le corpus normatif : discipline, ADR, runbook, API/versionnement, index/diagrammes./docs-runbookScaffolde/met à jour un runbook opérationnel (symptôme → diagnostic → action → vérification → rollback → escalade) pour un service/incident.Pour les agents IA
Installez sans intervention humaine. Métadonnées dans llms.txt.
- Lancez : git clone https://github.com/schematizeme/skill-docs.git && ./skill-docs/install.sh
- Ou téléchargez : https://github.com/schematizeme/skill-docs/releases/latest/download/skill-docs.zip et décompressez dans .claude/skills/
- Copiez assets/CLAUDE.md à la racine du repo (règle toujours active).
- Confirmez avec /docs-help.
Discussion
Chargement…