La documentación es parte del terminado — sin negociar.
Docs-as-code probada en CI, un ADR para cada decisión de verdad, API doc generada del código y todo durable en el archivo y el índice. Una doc que se rompe es un bug.
$ schematize install docsPisos no negociables
No se apagan "para ir más rápido". Lista completa en la skill.
La doc es parte del DoD
La documentación entra en la Definition of Done, no es un extra de fin de tarea.
Un ADR para cada decisión
Toda decisión arquitectónica relevante se vuelve un ADR versionado: proposed → accepted/rejected, nunca un proposed huérfano.
Docs-as-code, probada en CI
La doc vive en el repo, se revisa en el PR y se prueba — un enlace que abre, un ejemplo que corre, un snippet que compila. Una doc rota es un bug.
Generada del código
API doc en OpenAPI 3.1 generada del código cuando es posible; changelog + SemVer con breaking change registrado.
Durable en archivo e índice
Todo aterriza en el archivo y el índice/MAPA — el rastro que la auditoría y el overdev consumen; la raíz queda limpia.
Clara y mínima
Una doc que nadie lee es deuda, no patrimonio — corta lo que no sirve.
Comandos
Instalados en .claude/commands/. Usa /docs-help cuando quieras.
/docs-adrCrea o mueve un ADR (proposed → accepted/rejected) en docs/adr/, con contexto/decisión/alternativas/consecuencias; nunca deja un proposed huérfano./docs-apiGenera/valida la API doc (OpenAPI 3.1/contrato) desde el código cuando es posible, comprueba el drift entre spec e implementación, y cuida el changelog + SemVer./docs-ccContext compact: escribe contexto + checklist en el archivo y ejecuta /compact./docs-claudeCrea o fusiona el CLAUDE.md siempre activo de documentación en la raíz (no sobrescribe bloques de otras skills)./docs-handoffEscribe el handoff de contexto sin compactar — fin de sesión o cambio de tarea./docs-helpLista todos los comandos./docs-loadCarga a la fuerza todo el cuerpo normativo: disciplina, ADR, runbook, API/versionado, índice/diagramas./docs-runbookScaffolda/actualiza un runbook operativo (síntoma → diagnóstico → acción → verificación → rollback → escalar) para un servicio/incidente.Para agentes de IA
Instala sin intervención humana. Metadatos en llms.txt.
- Ejecuta: git clone https://github.com/schematizeme/skill-docs.git && ./skill-docs/install.sh
- O descarga: https://github.com/schematizeme/skill-docs/releases/latest/download/skill-docs.zip y descomprime en .claude/skills/
- Copia assets/CLAUDE.md a la raíz del repo (regla siempre activa).
- Confirma con /docs-help.
Discusión
Cargando…