Documentation Criteria

Matriz de decisión + plantillas para cuándo escribir PRD, ADR, Design Doc y Work Plan.

Por shinpr · shinpr/claude-code-workflows

Probado · Funciona ★ 9.2/10

Documentation Criteria — Matriz de decisión + plantillas para cuándo escribir PRD, ADR, Design Doc y Work Plan.

Qué hace

Proporciona una matriz de criterios que mapea la escala del cambio (file count, ADR conditions, feature type) a los documentos de planificación requeridos y en qué orden, además de seis plantillas de referencia (PRD, ADR, UI Spec, Design Doc, Work Plan, Task) con sus storage paths, naming conventions y diagramas requeridos. Se activa al crear o revisar documentos técnicos o al decidir qué documentos requiere un cambio.

Informe de la prueba

Se obtuvo el SKILL.md canónico en skills/documentation-criteria; el frontmatter se analiza con name+description y las 3 plantillas verificadas (prd/adr/design) devolvieron HTTP 200; sin scripts ni problemas de seguridad. Clonado en un temp HOME y confirmado que SKILL.md se ubica en ~/.claude/skills/documentation-criteria/SKILL.md. Para la SALIDA, planteé una tarea (new backend feature, ~7 files, new external payment API) y escribí dos artefactos: la línea base llamó a PRD "probablemente excesivo" y degradó el ADR a una nota opcional, mientras que la respuesta siguiendo la habilidad aplicó la matriz para exigir PRD + un ADR formal con una comparación mínima de 3 opciones (external dependency = ADR Condition #4) más los paths exactos, naming conventions y diagramas requeridos que la línea base omitió.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/shinpr/claude-code-workflows.git /tmp/documentation-criteria-src
mkdir -p ~/.claude/skills
cp -R /tmp/documentation-criteria-src/skills/documentation-criteria ~/.claude/skills/documentation-criteria
# Pure markdown skill: SKILL.md + 6 reference templates in references/. No scripts, deps, or API keys.
# Repo ships several copies (dev-skills/, dev-workflows*/); skills/documentation-criteria is the canonical standalone one.

Comandos y prompts de ejemplo

/documentation-criteriaMatriz de decisión + plantillas para cuándo escribir PRD, ADR, Design Doc y Work Plan.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Which documents does this feature require
Create an ADR for this architecture decision
Review this design doc against our criteria

Informe completo →