tpm-roadmap-slice
Skill7 starsChanged 9 months agoMITView on GitHub
Generate a Phase Spec/PRD by extracting features from an annotated Vision PRD. Use when user wants to create quarterly phase documentation, extract requirements from vision, plan a development phase, or decompose features into R-nnnn requirements. Requires annotated Vision PRD with F-nnn tags and Coverage Index.
In this repository15 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- creative-directionSkill
- find-bugsSkill
- five-whysSkill
- idea-to-icpSkill
- nano-banana-image-genSkill
- self-improvementSkill
- simplifySkill
- tpm-spec-trace-idsSkill
- tpm-spec-verifySkill
- ui-design-iterationSkill
- webdev-combobox-autocompleteSkill
- webdev-filter-query-builderSkill
- webdev-token-inputSkill
- youtube-transcriptSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 73
Use "shall" for required behaviors
- Distinctive: line 74
Keep requirements testable and atomic
- Very specific: line 89
Use template at assets/phase-prd-template.md.
- Distinctive: line 104
Check previous Phase PRDs to find the last used R-nnnn.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
PRD Phase Generator
Extract features from a Vision PRD into a detailed Phase PRD with requirements, priorities, and traceability.
Inputs Required
- Vision PRD — Annotated with
[F-nnn]tags (useprd-vision-annotatorfirst if missing) - Coverage Index — To identify which features are
Plannedvs already assigned
Capacity Defaults
Per phase, target approximately:
- 10 features (F-nnn)
- 50 functional requirements (R-nnnn)
- 100 acceptance criteria (AC-nnnn)
Adjust based on user input about team size or timeline.
Workflow
- Select features — Choose ~10
Plannedfeatures from Coverage Index - Decompose requirements — Extract R-nnnn from each feature's vision prose
- Assign priorities — Must / Should / Could for each requirement
- Generate Phase PRD — Using template in
assets/phase-prd-template.md - Update Coverage Index — Mark selected features as
In Progress
Step 1: Feature Selection
Review Planned features in Coverage Index. Select based on:
- Dependencies — Foundation features before dependent ones
- Cohesion — Group related features (e.g., all calendar views together)
- Business priority — Per user input or stakeholder notes
- Complexity — Balance large and small features
Present selection to user for approval before proceeding.
Step 2: Requirement Decomposition
For each selected feature, read the Vision PRD section and extract atomic requirements.
Vision prose:
User selects quantity, enters name/email, receives confirmation email immediately.
Becomes:
### R-0141: RSVP Quantity Selection
**Parent:** F-014
**Priority:** Must
Users shall select the number of seats when submitting an RSVP.
### R-0142: RSVP Data Collection
**Parent:** F-014
**Priority:** Must
The RSVP form shall collect attendee name and email address.
### R-0143: RSVP Confirmation Email
**Parent:** F-014
**Priority:** Must
The system shall send a confirmation email upon RSVP submission.Decomposition guidelines:
- One behavior per requirement
- Use "shall" for required behaviors
- Keep requirements testable and atomic
- ~5 requirements per feature is typical
Step 3: Priority Assignment
| Priority | Meaning | Guidance |
| Must | Required for phase to ship | Core functionality, blockers |
| Should | Expected but negotiable | Important but not critical |
| Could | Nice to have | Enhancements, polish |
Aim for roughly 60% Must, 30% Should, 10% Could.
Step 4: Generate Phase PRD
Use template at assets/phase-prd-template.md. Structure:
- Phase Overview (goals, scope, timeline)
- Features in Scope (list with F-nnn)
- Functional Requirements (R-nnnn grouped by feature)
- Quality Requirements section (placeholder — populated by
prd-qa-enricher) - Acceptance Criteria section (placeholder — populated by
prd-qa-enricher)
Requirement Numbering
Continue R-nnnn sequence across phases:
- Phase I: R-0001 → R-0089
- Phase II: R-0090 → R-0179
- Phase III: R-0180 → R-0269
Check previous Phase PRDs to find the last used R-nnnn.
References
references/naming-conventions.md— ID formats and rulesreferences/phasing-process.md— Detailed extraction workflow
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

