Documentation Criteria

Entscheidungsmatrix + Vorlagen, wann PRD, ADR, Design Doc und Work Plan zu erstellen sind

von shinpr · shinpr/claude-code-workflows

Getestet · Funktioniert ★ 9.2/10

Documentation Criteria — Entscheidungsmatrix + Vorlagen, wann PRD, ADR, Design Doc und Work Plan zu erstellen sind

Was es kann

Bietet eine Kriterienmatrix, die den Umfang einer Änderung (Dateianzahl, ADR conditions, feature type) den erforderlichen Planungsdokumenten und deren Reihenfolge zuordnet, plus sechs Referenzvorlagen (PRD, ADR, UI Spec, Design Doc, Work Plan, Task) mit ihren Speicherpfaden, Namenskonventionen und erforderlichen Diagrammen. Wird ausgelöst beim Erstellen oder Überprüfen technischer Dokumente oder bei der Entscheidung, welche Dokumente eine Änderung erfordert.

Testbericht

Die kanonische SKILL.md unter skills/documentation-criteria abgerufen; Frontmatter wird mit name+description geparst und alle 3 stichprobenartig überprüften Vorlagen (prd/adr/design) lieferten HTTP 200; keine Skripte oder Sicherheitsbedenken. In ein temporäres HOME geklont und bestätigt, dass SKILL.md unter ~/.claude/skills/documentation-criteria/SKILL.md landet. Für die AUSGABE habe ich eine Aufgabe gestellt (neues Backend-Feature, ~7 files, new external payment API) und zwei Artefakte erstellt: Die Baseline nannte PRD 'wahrscheinlich übertrieben' und stufte das ADR zu einer optionalen Notiz herab, während die der Fähigkeit folgende Antwort die Matrix anwendete, um PRD + ein formales ADR mit einem Minimum an 3-Optionen-Vergleich (external dependency = ADR Condition #4) sowie exakte Pfade, Namenskonventionen und erforderliche Diagramme vorzuschreiben, die die Baseline wegließ.

Getestet am: 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.

Befehle & Beispiel-Prompts

/documentation-criteriaEntscheidungsmatrix + Vorlagen, wann PRD, ADR, Design Doc und Work Plan zu erstellen sind

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →