Skip to content

docs(epics): refresh roadmap with pilot v1 / MENA-10 / launch phases#3

Open
abdout wants to merge 2 commits into
mainfrom
docs/release-phase-refresh
Open

docs(epics): refresh roadmap with pilot v1 / MENA-10 / launch phases#3
abdout wants to merge 2 commits into
mainfrom
docs/release-phase-refresh

Conversation

@abdout
Copy link
Copy Markdown
Contributor

@abdout abdout commented May 25, 2026

Summary

  • Overlays three release phases (Pilot v1 / MENA-10 / Public Launch) on the existing 28-epic build-phase roadmap; epic + story IDs preserved
  • Adds phase-1-pilot-v1.md (71 stories, 3 sprints, ~296 pts, King Fahad target 2026-07-12), phase-2-mena10.md, phase-3-launch.md, plus README index
  • Archives legacy V1 (epic-01..17) + V2 (epic-v2-01) + docs/epics/* to .bmad/epics/archive/
  • Rewrites docs/prd.md Milestones around the three phases; updates bmm-workflow-status.yaml with release_phases, phase_1_story_ids, and release_phase_concentration blocks

Why now

King Fahad Schools (Pilot Seat 1) conversion conversation is in Jun 2026. The original 32-week plan treats every feature equally and obscures what must ship for the conversion. The release-phase overlay makes "what ships next" obvious without re-deriving priorities from 28 epic files.

Test plan

  • python -c "import yaml; yaml.safe_load(open('.bmad/bmm-workflow-status.yaml'))" — passes
  • ls .bmad/epics/{README,phase-1-pilot-v1,phase-2-mena10,phase-3-launch}.md — all present
  • ls .bmad/epics/archive/ — 17 V1 files + V2 file + docs-epics/ subdir present
  • docs/epics/ is empty (legacy moved)
  • Read epic-prod-overview.md — Release Phases section appears between "28 Epics in 6 Phases" and "Architecture Decisions"
  • Read phase-1-pilot-v1.md — 71 stories enumerated; dependencies in the sanity check don't cycle
  • Captain (@abdout) + Samia review independently and confirm 7-week Phase 1 timeline is realistic for King Fahad conversion

Out of scope (deliberately)

  • Per-story **Phase: …** markers inside the 28 individual epic-prod-NN files — the phase manifests + YAML phase_1_story_ids carry this for now; a follow-up sweep can add inline markers if discoverability needs it
  • Auto-creating GitHub issues per Phase-1 story — picking up the first story (e.g. E01.S01) via /feature is the smoke test of the workflow

Closes #2

Source plan: ~/.claude/plans/take-web-app-as-precious-turtle.md

Generated with Claude Code

abdout and others added 2 commits May 24, 2026 19:39
Reframes the existing 28-epic production roadmap (`epic-prod-01..28`)
around three release phases tied to the live King Fahad Schools pilot:

- Phase 1 Pilot v1 (3 sprints, ~7 weeks, ~296 pts, target 2026-07-12)
- Phase 2 MENA-10 (5 sprints, ~10 weeks, ~411 pts, target 2026-09-15)
- Phase 3 Public Launch (8 sprints, ~16 weeks, ~408 pts, target 2026-12-20)

Epic IDs and story IDs are preserved. Build phases (A Foundation → F
Production) describe dependency order; release phases (1/2/3) describe
ship order. The two axes are orthogonal — see .bmad/epics/README.md.

Changes
- Add .bmad/epics/{README,phase-1-pilot-v1,phase-2-mena10,phase-3-launch}.md
- Update .bmad/epics/epic-prod-overview.md with Release Phases section
  and reference King Fahad pilot in the why-a-new-roadmap motivation
- Update .bmad/bmm-workflow-status.yaml with release_phases block,
  per-epic phase_1_story_ids enumeration, and release_phase_concentration
- Rewrite docs/prd.md Milestones around Pilot/MENA-10/Launch phases;
  update related-documents pointers to the new manifests
- Archive legacy V1 epics (epic-01..17) and V2 backend draft to
  .bmad/epics/archive/; archive stale docs/epics/* subset alongside

Phase 1 deliberately ships read-only views + admission + signed APK on
Play Internal — explicit deferrals to Phase 2/3 are listed per-epic in
phase-1-pilot-v1.md so the deferrals don't drift into invisibility.

Source plan: ~/.claude/plans/take-web-app-as-precious-turtle.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds inline `**Phase: Pilot v1**` markers to every story selected for
Phase 1 in `phase-1-pilot-v1.md`. Phase 2 and Phase 3 markers
intentionally deferred — manifest + `phase_1_story_ids` in the YAML
remain the authoritative cross-phase index.

Heading-style epics (E01-E11): marker appended after the points bracket.
Table-style epics (E19, E25, E26, E27): marker appended to the title cell.

Verification: `grep -rE 'Phase: Pilot v1' .bmad/epics/epic-prod-*.md | wc -l`
returns 71 (matches the manifest count).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(epics): refresh roadmap with pilot v1 / MENA-10 / launch release phases

1 participant