documentation-criteria
Installation
SKILL.md
Documentation Creation Criteria
Creation Decision Matrix
Evaluate rows by confirmed scale, then add the conditional documents named in the same row.
| Confirmed Scale | Required Documents | Conditional Additions | Creation Order |
|---|---|---|---|
| Large (6+ files or large-risk axis) | PRD, Design Doc, Work Plan | UI Spec for frontend/fullstack; ADR when any ADR condition applies | PRD -> UI Spec (if applicable) -> ADR (if applicable) -> Design Doc -> Work Plan |
| Medium (3-5 files or medium-risk axis) | Design Doc, Work Plan | UI Spec for frontend/fullstack; ADR when any ADR condition applies; update an existing PRD when the feature scope changes | PRD update (if applicable) -> UI Spec (if applicable) -> ADR (if applicable) -> Design Doc -> Work Plan |
| Small (1-2 files with no higher-risk axis) | None — the confirmed outcome, affected paths, and verification condition are passed to the executor as an explicit prompt | Update an existing PRD when the feature scope changes | PRD update (if applicable) -> implementation |
For a Large change, satisfy the PRD requirement by creating a new PRD, updating the relevant PRD, or creating a reverse PRD when no current product document exists.
Structural Escalation
File count measures size, not structural impact, so a two-file change can still reshape a contract or a data flow.
When any ADR Creation Condition below applies, the confirmed scale is Medium at minimum — Design Doc and Work Plan required — regardless of file count. Escalation only raises a level; a file count that already reaches Medium or Large stands. Record the applied condition as the deciding axis.