New PRD Skill
Create a new Product Requirements Document from the x4-mono PRD template.
Arguments
The user describes what they want to build. If unclear, ask for:
- Feature name / title
- Problem it solves
- High-level scope (what's in, what's out)
Workflow
- Determine PRD number: Read
wiki/status.md to find the next available PRD number
- Create slug: Derive a kebab-case slug from the title (e.g.,
user-notifications)
- Copy template: Copy
wiki/_templates/prd-template.md to wiki/inbox/prd-NNN-{slug}.md
- Fill metadata: Set PRD ID, Title, Author, Status (Draft), Version (0.1), Date
- Guide through sections: Help the user fill all 11 required sections
- Update status.md: Add a row to the PRD Inventory table
File Locations
- Template:
wiki/_templates/prd-template.md
- New PRD:
wiki/inbox/prd-NNN-{slug}.md
- Status:
wiki/status.md
Required Sections
| # |
Section |
Key Content |
| 1 |
Problem Statement |
Pain point, why it matters |
| 2 |
Success Criteria |
Measurable targets (table) |
| 3 |
Scope |
In scope, out of scope, assumptions |
| 4 |
System Context |
Dependency diagram, consumed by |
| 5 |
Technical Design |
Data model, architecture, API, file structure |
| 6 |
Implementation Plan |
Task table + Claude Code annotations |
| 7 |
Testing Strategy |
Test pyramid, key scenarios |
| 8 |
Non-Functional Requirements |
Performance, security targets |
| 9 |
Rollout & Migration |
Steps, rollback plan |
| 10 |
Open Questions |
Unresolved items with impact |
| 11 |
Revision History |
Version log |
Task Annotation Format (Section 6)
Every task marked as Claude Code Candidate must include:
**Task N (Name)**:
- **Context needed**: [files to read before starting]
- **Constraints**: [what NOT to do, boundaries to respect]
- **Done state**: [specific completion criteria]
- **Verification command**: [shell command to verify]
Status.md Update
Add to the PRD Inventory table:
| PRD-NNN | [Title](inbox/prd-NNN-slug.md) | Draft | PRD-XXX (if any) | `wiki/inbox/` |
If the PRD has dependencies, update the Dependency Graph section too.
Conventions
- PRD IDs are sequential: PRD-001, PRD-002, etc.
- Status starts as
Draft in wiki/inbox/
- All task estimates use t-shirt sizes: XS, S, M, L, XL
- Dependencies reference other PRD IDs
- Success criteria must be measurable (numbers, yes/no, specific outcomes)
1---2name: new-prd3description: Create a new PRD from the template with all 11 sections4---5
6# New PRD Skill
7
8Create a new Product Requirements Document from the x4-mono PRD template.
9
10## Arguments
11
12The user describes what they want to build. If unclear, ask for:
13
14- Feature name / title
15- Problem it solves
16- High-level scope (what's in, what's out)
17
18## Workflow
19
201. **Determine PRD number**: Read `wiki/status.md` to find the next available PRD number
212. **Create slug**: Derive a kebab-case slug from the title (e.g., `user-notifications`)
223. **Copy template**: Copy `wiki/_templates/prd-template.md` to `wiki/inbox/prd-NNN-{slug}.md`
234. **Fill metadata**: Set PRD ID, Title, Author, Status (Draft), Version (0.1), Date
245. **Guide through sections**: Help the user fill all 11 required sections
256. **Update status.md**: Add a row to the PRD Inventory table
26
27## File Locations
28
29- **Template**: `wiki/_templates/prd-template.md`
30- **New PRD**: `wiki/inbox/prd-NNN-{slug}.md`
31- **Status**: `wiki/status.md`
32
33## Required Sections
34
35| # | Section | Key Content |
36| --- | --------------------------- | --------------------------------------------- |
37| 1 | Problem Statement | Pain point, why it matters |
38| 2 | Success Criteria | Measurable targets (table) |
39| 3 | Scope | In scope, out of scope, assumptions |
40| 4 | System Context | Dependency diagram, consumed by |
41| 5 | Technical Design | Data model, architecture, API, file structure |
42| 6 | Implementation Plan | Task table + Claude Code annotations |
43| 7 | Testing Strategy | Test pyramid, key scenarios |
44| 8 | Non-Functional Requirements | Performance, security targets |
45| 9 | Rollout & Migration | Steps, rollback plan |
46| 10 | Open Questions | Unresolved items with impact |
47| 11 | Revision History | Version log |
48
49## Task Annotation Format (Section 6)
50
51Every task marked as Claude Code Candidate must include:
52
53```markdown
54**Task N (Name)**:
55
56- **Context needed**: [files to read before starting]
57- **Constraints**: [what NOT to do, boundaries to respect]
58- **Done state**: [specific completion criteria]
59- **Verification command**: [shell command to verify]
60```
61
62## Status.md Update
63
64Add to the PRD Inventory table:
65
66```markdown
67| PRD-NNN | [Title](inbox/prd-NNN-slug.md) | Draft | PRD-XXX (if any) | `wiki/inbox/` |
68```
69
70If the PRD has dependencies, update the Dependency Graph section too.
71
72## Conventions
73
74- PRD IDs are sequential: PRD-001, PRD-002, etc.
75- Status starts as `Draft` in `wiki/inbox/`
76- All task estimates use t-shirt sizes: XS, S, M, L, XL
77- Dependencies reference other PRD IDs
78- Success criteria must be measurable (numbers, yes/no, specific outcomes)