shinpr/claude-code-workflows / dev-skills/skills/documentation-criteria
documentation-criteria
VerifiedDetermines which of PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires, and where each is stored. Use when deciding documentation scope, or when creating or reviewing a technical document.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| references/adr-template.md | markdown | 3.1 KB |
| references/design-template.md | markdown | 19.8 KB |
| references/plan-template.md | markdown | 2.3 KB |
| references/prd-template.md | markdown | 4.7 KB |
| references/task-template.md | markdown | 1.8 KB |
| references/ui-spec-template.md | markdown | 8.8 KB |
references/plan-template.md
View on GitHub# Work Plan: [Feature Name] Implementation
Created Date: YYYY-MM-DD
Type: feature|fix|refactor
Related Issue/PR: #XXX (if any)
Review Scope: [repository responsibilities or expected files derived from the Design Doc]
## Governing Documents
- Design Doc: [docs/design/XXX.md]
- UI Spec: [docs/ui-spec/XXX.md] (when applicable)
- ADR: [docs/adr/ADR-XXXX-title.md] (when applicable)
- PRD: [docs/prd/XXX.md] (when applicable)
- Test skeletons: [paths] (when generated)
## Implementation Scope
[One concise statement of the repository implementation outcome defined by the Design Doc.]
## Implementation Phases
Use the implementation approach and dependency order from the Design Doc.
Whole-repository quality assurance stays outside the plan as a separate execution responsibility.
### Phase 1: [First implementation outcome]
#### Tasks
- [ ] **P1-T1: [Repository implementation outcome]**
- **Source**: [every directly constraining Design Doc, ADR, or UI Spec path and section; AC IDs]
- **Scope**: [responsibility, component, or expected files]
- **Depends on**: none | [task IDs]
- **Executor lane**: backend|frontend
- **Verification**: [Design Doc verification method or repository command]
- **Primary failure**: [optional: most material false-green state]
- **Observable check**: [optional: smallest check that detects the primary failure]
### Phase 2: [Next implementation outcome] (when required)
#### Tasks
- [ ] **P2-T1: [Repository implementation outcome]**
- **Source**: [every directly constraining governing path and section; AC IDs]
- **Scope**: [responsibility, component, or expected files]
- **Depends on**: [task IDs]
- **Executor lane**: backend|frontend
- **Verification**: [Design Doc verification method or repository command]
- **Primary failure**: [optional]
- **Observable check**: [optional]
## Completion Criteria
- [ ] Every Design Doc obligation that is repository work is covered by at least one task
- [ ] Every task cites each directly constraining governing section and applicable AC
- [ ] Every task produces a repository implementation outcome required by its source
- [ ] Dependencies permit execution in the listed order
- [ ] Verification is executable from repository artifacts or the task's own output
- [ ] Task verification passes and cited acceptance criteria are satisfied
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |