La documentazione fa parte del Done — non si negozia.
Docs-as-code testata in CI, un ADR per ogni decisione vera, API doc generata dal codice e tutto durevole nell'archivio e nell'indice. Una doc rotta è un bug.
$ schematize install docsBasi non negoziabili
Non si spengono "per andare più veloce". Elenco completo nella skill.
La doc fa parte del DoD
La documentazione è nella Definition of Done, non un extra di fine attività.
Un ADR per ogni decisione
Ogni decisione architetturale rilevante diventa un ADR versionato: proposed → accepted/rejected, mai un proposed orfano.
Docs-as-code, testata in CI
La doc vive nel repo, è rivista nella PR ed è testata — un link che apre, un esempio che gira, uno snippet che compila. Una doc rotta è un bug.
Generata dal codice
API doc in OpenAPI 3.1 generata dal codice quando possibile; changelog + SemVer con breaking change registrato.
Durevole in archivio e indice
Tutto atterra nell'archivio e nell'indice/MAPPA — la traccia che audit e overdev consumano; la radice resta pulita.
Chiara e minima
Una doc che nessuno legge è debito, non patrimonio — taglia ciò che non serve.
Comandi
Installati in .claude/commands/. Usa /docs-help quando vuoi.
/docs-adrCrea o sposta un ADR (proposed → accepted/rejected) in docs/adr/, con contesto/decisione/alternative/conseguenze; non lascia mai un proposed orfano./docs-apiGenera/valida l'API doc (OpenAPI 3.1/contratto) dal codice quando possibile, controlla il drift tra spec e implementazione, e cura changelog + SemVer./docs-ccContext compact: scrive contesto + checklist nell'archivio ed esegue /compact./docs-claudeCrea o unisce il CLAUDE.md sempre attivo di documentazione nella radice (non sovrascrive blocchi di altre skill)./docs-handoffScrive l'handoff di contesto senza compattare — fine sessione o cambio attività./docs-helpElenca tutti i comandi./docs-loadCarica a forza tutto il corpo normativo: disciplina, ADR, runbook, API/versionamento, indice/diagrammi./docs-runbookScaffolda/aggiorna un runbook operativo (sintomo → diagnosi → azione → verifica → rollback → escalation) per un servizio/incidente.Per agenti IA
Installa senza intervento umano. Metadati in llms.txt.
- Esegui: git clone https://github.com/schematizeme/skill-docs.git && ./skill-docs/install.sh
- Oppure scarica: https://github.com/schematizeme/skill-docs/releases/latest/download/skill-docs.zip e decomprimi in .claude/skills/
- Copia assets/CLAUDE.md nella radice del repo (regola sempre attiva).
- Conferma con /docs-help.
Discussione
Caricamento…