Documentation Criteria

Beslutningsmatrix + skabeloner for hvornår man skal skrive PRD, ADR, Design Doc og Work Plan

Af shinpr · shinpr/claude-code-workflows

Testet · Virker ★ 9.2/10

Documentation Criteria — Beslutningsmatrix + skabeloner for hvornår man skal skrive PRD, ADR, Design Doc og Work Plan

Hvad det gør

Leverer en kriteriematrix, der mapper ændringsskala (filantal, ADR-betingelser, feature-type) til hvilke planlægningsdokumenter der kræves og i hvilken rækkefølge, plus seks referenceskabeloner (PRD, ADR, UI Spec, Design Doc, Work Plan, Task) med deres lagringsstier, navngivningskonventioner og påkrævede diagrammer. Udløses ved oprettelse eller gennemgang af tekniske dokumenter eller beslutning om, hvilke dokumenter en ændring kræver.

Testrapport

Hentede den kanoniske SKILL.md fra skills/documentation-criteria; frontmatter parses med name+description og alle 3 stikprøvekontrollerede skabeloner (prd/adr/design) returnerede HTTP 200; ingen scripts eller sikkerhedsbrister. Klonede til en midlertidig HOME og bekræftede, at SKILL.md lander på ~/.claude/skills/documentation-criteria/SKILL.md. For OUTPUT stillede jeg én opgave (ny backend-funktion, ~7 filer, ny ekstern betalings-API) og skrev to artefakter: baseline kaldte PRD "probably overkill" og nedgraderede ADR til en valgfri note, mens det færdigheds-følgende svar anvendte matrixen til at kræve PRD + en formel ADR med en minimum 3-options sammenligning (external dependency = ADR Condition #4) plus nøjagtige stier, navngivningskonventioner og påkrævede diagrammer, som baseline udelod.

Testet: 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.

Kommandoer og eksempelprompter

/documentation-criteriaBeslutningsmatrix + skabeloner for hvornår man skal skrive PRD, ADR, Design Doc og Work Plan

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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

Læs hele rapporten →