Skip to content

docs(discovery-map): rebalance phases — split inception MVP into 2/3/4#266

Open
leeovery wants to merge 2 commits into
idea/inception-pr-1-manifest-foundationsfrom
idea/inception-rephase
Open

docs(discovery-map): rebalance phases — split inception MVP into 2/3/4#266
leeovery wants to merge 2 commits into
idea/inception-pr-1-manifest-foundationsfrom
idea/inception-rephase

Conversation

@leeovery
Copy link
Copy Markdown
Owner

@leeovery leeovery commented May 9, 2026

Summary

  • Original Phase 2 was scoped as "everything user-visible to flip on inception" — ~14 files, two new skills, plus start-epic wiring. Phase 1 was a tiny "no user-visible change" foundation slice. Same boundary problem you flagged: too big vs too small.
  • Re-split the inception MVP into three reviewable PRs: Phase 2 (entry skill + bridge plumbing + discovery awareness — ~6 files, the door), Phase 3 (inception process skill — ~8 files, the conversation), Phase 4 (wire start-epic — ~3 files, the user-visible flip). Each has a clean conceptual boundary and similar review burden.
  • Renumbered downstream phases 03-11 → 05-13 with git mv (history preserved); all cross-refs updated in both directions; INDEX.md dependency tree redrawn; Phase 1 marked Done with PR manifest: add inception phase + imports[] field support #264 link.

Test plan

  • No content drift in old phase-02 substance — all of it lives across the three new docs
  • No phase doc references a stale number (verified via grep "Phase [0-9]" across discovery-map/)
  • No (was Phase X) transitional annotations remain
  • INDEX.md dependency tree matches the new phase numbers
  • You're happy with the new phasing before I start the Phase 2 implementation commits

Branch naming: this is a doc-only meta change — no phase number, just idea/inception-rephase. Phase 2 implementation will live on idea/inception-pr-2-entry-bridge stacked on top.

Base branch: idea/inception-pr-1-manifest-foundations (Phase 1 — stacked PR, won't merge to main until the whole initiative lands).

🤖 Generated with Claude Code

leeovery and others added 2 commits May 9, 2026 13:57
Phase 1 was a tiny "no user-visible change" foundation slice; the
original Phase 2 was a huge "everything user-visible" slice (two new
skills + start-epic wiring + bridge + discovery awareness, ~14 files).
Same boundary problem the user flagged.

Re-split the inception MVP into three reviewable PRs:

- Phase 2 — Inception entry skill + bridge plumbing + discovery
  awareness (the door exists)
- Phase 3 — Inception process skill (the conversation behind the door)
- Phase 4 — Wire start-epic to inception (user-visible flip)

Renumbered downstream phases 03-11 → 05-13. Updated all cross-refs in
both directions. Refreshed dependency tree in INDEX.md. Phase 1's
status updated to Done (PR #264).

No content change to design.md or phase-01. The substance of the old
phase-02 lives across the three new docs with no functional drift —
the split is purely about reviewable size.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Single source of truth for which branch each phase lives on, what each
branch's base is, and what order the PRs merge in at the end of the
initiative.

Conventions: whole-number phase suffixes only (no 2a/2b); doc-only
meta branches skip the phase number. Most phases stack linearly; a
few diverge (8/9/10 all from Phase 7; Phase 11 from Phase 5) per the
dependency tree above.

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.

1 participant