Documentation Criteria

Matrice decisionale + modelli per quando scrivere PRD, ADR, Design Doc e Work Plan.

di shinpr · shinpr/claude-code-workflows

Promosso ★ 9.2/10

Documentation Criteria — Matrice decisionale + modelli per quando scrivere PRD, ADR, Design Doc e Work Plan.

Cosa fa

Fornisce una matrice di criteri che mappa la scala del cambiamento (conteggio file, condizioni ADR, tipo di funzionalità) ai documenti di pianificazione richiesti e in quale ordine, più sei modelli di riferimento (PRD, ADR, UI Spec, Design Doc, Work Plan, Task) con i loro percorsi di archiviazione, convenzioni di denominazione e diagrammi richiesti. Si attiva quando si creano o si revisionano documenti tecnici o si decide quali documenti richiede un cambiamento.

Rapporto di test

Recuperato il SKILL.md canonico in skills/documentation-criteria; il frontmatter si analizza con name+description e tutti e 3 i modelli controllati a campione (prd/adr/design) hanno restituito HTTP 200; nessuno script o problema di sicurezza. Clonata in una HOME temporanea e confermato che SKILL.md si trova in ~/.claude/skills/documentation-criteria/SKILL.md. Per l'OUTPUT ho posto un compito (nuova funzionalità backend, ~7 file, nuova API di pagamento esterna) e ho scritto due artefatti: la baseline ha definito PRD "probabilmente eccessivo" e ha declassato l'ADR a una nota opzionale, mentre la risposta seguita dalla skill ha applicato la matrice per imporre PRD + un ADR formale con un confronto minimo di 3 opzioni (dipendenza esterna = ADR Condition #4) più percorsi esatti, convenzioni di denominazione e diagrammi richiesti che la baseline aveva omesso.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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.

Comandi e prompt di esempio

/documentation-criteriaMatrice decisionale + modelli per quando scrivere PRD, ADR, Design Doc e Work Plan.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →