Documentation Criteria

Beslutningsmatrise + maler for når man skal skrive PRD, ADR, Design Doc og Work Plan

av shinpr · shinpr/claude-code-workflows

Bestått ★ 9.2/10

Documentation Criteria — Beslutningsmatrise + maler for når man skal skrive PRD, ADR, Design Doc og Work Plan

Hva den gjør

Gir en kriteriematrise som mapper endringsomfang (filantall, ADR-betingelser, funksjonstype) til hvilke planleggingsdokumenter som kreves og i hvilken rekkefølge, pluss seks referansemaler (PRD, ADR, UI Spec, Design Doc, Work Plan, Task) med deres lagringsstier, navnekonvensjoner og nødvendige diagrammer. Utløses ved opprettelse eller gjennomgang av tekniske dokumenter, eller ved beslutning om hvilke dokumenter en endring krever.

Testrapport

Hentet den kanoniske SKILL.md fra skills/documentation-criteria; frontmatter parses med name+description og alle 3 stikkprøvekontrollerte maler (prd/adr/design) returnerte HTTP 200; ingen skript eller sikkerhetsbrudd. Klonet til en midlertidig HOME og bekreftet at SKILL.md lander på ~/.claude/skills/documentation-criteria/SKILL.md. For OUTPUT stilte jeg én oppgave (ny backend-funksjon, ~7 filer, ny ekstern betalings-API) og skrev to artefakter: baseline kalte PRD "sannsynligvis overkill" og nedgraderte ADR til en valgfri merknad, mens det ferdighetsfulgte svaret brukte matrisen til å pålegge PRD + en formell ADR med en minimum 3-alternativs sammenligning (ekstern avhengighet = ADR Condition #4) pluss eksakte stier, navnekonvensjoner og nødvendige diagrammer som baseline utelot.

Testet på: 2026-07-21 · Claude Code 2.x (agent harness)

Installer

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-criteriaBeslutningsmatrise + maler for når man skal skrive PRD, ADR, Design Doc og Work Plan

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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

Full rapport →