Documentation Criteria

Matryca decyzyjna + szablony określające, kiedy pisać PRD, ADR, Design Doc i Work Plan

Autor: shinpr · shinpr/claude-code-workflows

Testowano · Działa ★ 9.2/10

Documentation Criteria — Matryca decyzyjna + szablony określające, kiedy pisać PRD, ADR, Design Doc i Work Plan

Co robi ten skill

Dostarcza matrycę kryteriów mapującą skalę zmian (liczbę plików, warunki ADR, typ funkcji) do wymaganych dokumentów planistycznych i ich kolejności, plus sześć szablonów referencyjnych (PRD, ADR, UI Spec, Design Doc, Work Plan, Task) wraz z ich ścieżkami przechowywania, konwencjami nazewnictwa i wymaganymi diagramami. Uruchamia się podczas tworzenia lub przeglądania dokumentów technicznych lub decydowania, które dokumenty są wymagane dla danej zmiany.

Raport z testu

Pobrano kanoniczny SKILL.md z skills/documentation-criteria; frontmatter parsował z name+description, a wszystkie 3 sprawdzone szablony (prd/adr/design) zwróciły HTTP 200; brak skryptów ani zagrożeń bezpieczeństwa. Sklonowano do tymczasowego HOME i potwierdzono, że SKILL.md ląduje w ~/.claude/skills/documentation-criteria/SKILL.md. Dla danych wyjściowych zadałem jedno zadanie (new backend feature, ~7 files, new external payment API) i napisałem dwa artefakty: bazowy nazwał PRD „prawdopodobnie przesadą” i zdegradował ADR do opcjonalnej notatki, podczas gdy odpowiedź zgodna z umiejętnością zastosowała matrycę, aby nakazać PRD + formalny ADR z minimalnym porównaniem 3 opcji (external dependency = ADR Condition #4) plus dokładne ścieżki, konwencje nazewnictwa i wymagane diagramy, które bazowy pominął.

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

Instalacja

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.

Komendy i przykładowe prompty

/documentation-criteriaMatryca decyzyjna + szablony określające, kiedy pisać PRD, ADR, Design Doc i Work Plan

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →