Documentação é parte do pronto — não negocia.
Doc-as-code testada no CI, um ADR pra toda decisão de verdade, API doc gerada do código e tudo durável no archive e no índice. Doc que quebra é bug.
$ schematize install docsPisos inegociáveis
Não se desligam "pra ir mais rápido". Lista completa na skill.
Doc é parte do DoD
Documentação entra na Definition of Done, não é um extra de fim de tarefa.
Um ADR pra toda decisão
Toda decisão arquitetural relevante vira um ADR versionado: proposed → accepted/rejected, nunca um proposed órfão.
Doc-as-code, testada no CI
A doc mora no repo, é revisada no PR e testada — link que abre, exemplo que roda, snippet que compila. Doc que quebra é bug.
Gerada do código
API doc em OpenAPI 3.1 gerada do código quando possível; changelog + SemVer com breaking change registrado.
Durável no archive e índice
Tudo pousa no archive e no índice/MAPA — o rastro que a auditoria e o overdev consomem; a raiz fica limpa.
Clara e mínima
Doc que ninguém lê é dívida, não patrimônio — corta o que não serve.
Comandos
Instalados em .claude/commands/. Use /docs-help a qualquer momento.
/docs-adrCria ou movimenta um ADR (proposed → accepted/rejected) em docs/adr/, com contexto/decisão/alternativas/consequências; nunca deixa um proposed órfão./docs-apiGera/valida a API doc (OpenAPI 3.1/contrato) a partir do código quando possível, checa o drift entre spec e implementação, e cuida do changelog + SemVer./docs-ccContext compact: gera contexto + checklist no archive e roda /compact./docs-claudeCria ou mescla o CLAUDE.md sempre-on de documentação na raiz (não sobrescreve blocos de outras skills)./docs-handoffGera o handoff de contexto sem compactar — fim de sessão ou troca de tarefa./docs-helpLista todos os comandos./docs-loadCarrega à força todo o corpo normativo: disciplina, ADR, runbook, API/versionamento, índice/diagramas./docs-runbookScaffolda/atualiza um runbook operacional (sintoma → diagnóstico → ação → verificação → rollback → escalar) para um serviço/incidente.Para agentes de IA
Instale sem intervenção humana. Metadados em llms.txt.
- Rode: git clone https://github.com/schematizeme/skill-docs.git && ./skill-docs/install.sh
- Ou baixe: https://github.com/schematizeme/skill-docs/releases/latest/download/skill-docs.zip e descompacte em .claude/skills/
- Copie assets/CLAUDE.md para a raiz do repo (regra sempre-on).
- Confirme com /docs-help.
Discussão
Carregando…