Goal: Create and maintain structured release-plan.json files in project/release-plans/release-plan.json.
Instructions
- Read specs (app-vision.md, PRD.md, tech-specs.md, ui-ux.md) for context before creating or modifying release plans.
- Hierarchy: releases > epics > features > user_stories > tasks
- A single release-plan.json contains multiple releases (versions), each with its own epics.
- Determine if a feature needs TDD based on complexity. Set
tdd: trueif applicable. - Break large features into smaller features and user stories.
- Epics use
requirementswithfunctional(FR) andnon_functional(NFR) items. - User stories use
storyfield (nottitle) andcontextfield (notdescription). - Future releases can have empty
epicsarrays as placeholders.
Workflow
Read the following specs files:
- PRD:
project/product/PRD.md - Tech Specs:
project/{version}/specs/tech-specs.md - UI/UX Specs:
project/{version}/specs/ui-ux.md - App Vision:
project/executive/app-vision.md
- PRD:
Read the schema structure file:
- Schema Structure:
.claude/skills/release-plan/references/schema-structure.md - Sample Schema:
.claude/skills/release-plan/references/sample-schema.json
- Schema Structure:
Check if
release-plan.jsonexists atproject/release-plans/release-plan.json. If not, create it.Create or update the
release-plan.jsonbased on the schema structure and sample schema.Validate using:
uv run .claude/skills/release-plan/scripts/validate_release_plan.py -i project/release-plans/release-plan.jsonProvide summary report to the user.
Acceptance Criteria
release-plan.jsonfollows exact structure from schema-structure.md- All IDs follow correct patterns (
EPIC-NNN,FEAT-NNN,US-NNN,TNNN,SC-NNN,AC-NNN,FR-NNN,NFR-NNN) - Task dependencies reference valid
TNNNIDs - Epic requirements use
functional(FR) andnon_functional(NFR) arrays - Features use
tddboolean field for test strategy - User stories use
storyandcontextfields - Multiple releases supported in a single file
- File written to correct path:
project/release-plans/release-plan.json