Documentation Criteria

Matrice de décision + modèles pour savoir quand rédiger PRD, ADR, Design Doc et Work Plan

par shinpr · shinpr/claude-code-workflows

Testé · Fonctionne ★ 9.2/10

Documentation Criteria — Matrice de décision + modèles pour savoir quand rédiger PRD, ADR, Design Doc et Work Plan

Ce que fait

Fournit une matrice de critères mappant l'échelle du changement (nombre de fichiers, conditions ADR, type de fonctionnalité) aux documents de planification requis et dans quel ordre, plus six modèles de référence (PRD, ADR, UI Spec, Design Doc, Work Plan, Task) avec leurs chemins de stockage, conventions de nommage et diagrammes requis. Se déclenche lors de la création ou de la révision de documents techniques ou de la décision des documents qu'un changement nécessite.

Rapport de test

SKILL.md canonique récupéré à skills/documentation-criteria ; le frontmatter est analysé avec name+description et les 3 modèles vérifiés (prd/adr/design) ont tous renvoyé HTTP 200 ; aucun script ni faille de sécurité. Cloné dans un HOME temporaire et confirmé que SKILL.md atterrit à ~/.claude/skills/documentation-criteria/SKILL.md. Pour la SORTIE, j'ai posé une tâche (nouvelle fonctionnalité backend, ~7 fichiers, nouvelle API de paiement externe) et écrit deux artefacts : la base de référence a qualifié le PRD de 'probablement excessif' et a rétrogradé l'ADR à une note facultative, tandis que la réponse suivant la compétence a appliqué la matrice pour exiger un PRD + un ADR formel avec une comparaison minimale de 3 options (dépendance externe = ADR Condition #4) plus les chemins exacts, les conventions de nommage et les diagrammes requis que la base de référence avait omis.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

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.

Commandes et exemples de prompts

/documentation-criteriaMatrice de décision + modèles pour savoir quand rédiger PRD, ADR, Design Doc et Work Plan

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →