change-request
story: e45s29
Section titled “story: e45s29”story: e20s01
Section titled “story: e20s01”Change Request
Section titled “Change Request”HARD GATE —
specs/release-plan.yamlmust exist before running either mode. If it doesn’t, runplan-releasefirst.→ verify:
[ -f specs/release-plan.yaml ] && echo "ready" || echo "BLOCKED: run plan-release first"
Two modes. State which one you want or the skill will ask.
Mode A — Add
Section titled “Mode A — Add”Intake a new requirement mid-flight without disrupting work in progress.
- Capture: What is the change? What problem does it solve?
- Locate: Which existing stories in
specs/epics/does it affect or replace? - Draft: Add story +
tasks[]with Gherkin-style AC in epic YAML (each task hasverify). Tag requirement deltas:ADDED/MODIFIED/REMOVED/RENAMEDwith before/after for non-ADDEDchanges (e45s29). - Place: Append story under existing epic capsule, or create
specs/epics/eNN-slug.yamland register inrelease-plan.yamlepics[]. - Score: Compute WSJF; note if it outranks in-progress work.
→ verify: grep -c 'stories:' specs/epics/*/epic.yaml
Mode B — Reorder
Section titled “Mode B — Reorder”Value-engineering pass over the full release using WSJF.
See REFERENCE.md for the full WSJF scoring rubric.
- Score each epic/story: BV + TC + RR / Job Size.
- Re-sort
release-plan.yamlepics[]and per-epicwsjffields. - Flag cut candidates: WSJF < 1.5.
- Update
specs/release-plan.yamland epicwsjfkeys with rationale. - Report the delta.
→ verify: grep -c 'wsjf' specs/release-plan.yaml specs/epics/*/epic.yaml
Conversational Mode
Section titled “Conversational Mode”If the user’s request is in natural language and does not match the structured format of Mode A or Mode B, enter Conversational Mode to extract the change parameters through interactive dialogue.
5-Step Flow
Section titled “5-Step Flow”- Capture: Parse the natural-language request for what, why, and where. Ask at most 3 clarifying questions before drafting.
- Locate: Identify which epic or capability in
specs/epics/the request affects or replaces. - Draft: Present a structured draft of the proposed story and tasks for user confirmation.
- Score: Estimate the WSJF score and explain the calculation so the user understands the priority.
- Place: Confirm the final epic placement with the user before writing files.
After either mode
Section titled “After either mode”Run bash scripts/sync-status-from-epics.sh. Suggest plan-work or build-epic for the top-ranked unstarted story.