chore: cutover from bmad to superpowers workflow#6
Merged
Conversation
Captures the decisions to retire bmad's per-story ceremony, distill the PRD/architecture/epics into a single engineering.md, archive the legacy planning bundle under docs/archive/, and route future work through the superpowers brainstorming → writing-plans → executing-plans → requesting-code-review flow. Defines the cutover PR scope and the first two tasks under the new workflow (retrospective review of shipped work, then refactor). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Distills the bmad-era PRD / architecture / epics into a single
docs/engineering.md (185 lines) covering project intent, the six
CI-enforced invariants with rationale, the five protocol seams,
the exception contract, current + planned module layout, testing
patterns, the optional-extras pattern, the remaining 27-story
roadmap, and a pointer to deferred-work.md.
Moves prd.md, architecture.md, epics.md, both product briefs, and
the per-story specs (1-1 through 1-5 + sprint-status.yaml) into
docs/archive/ with a README framing them as historical reference.
Rewrites CLAUDE.md "Project Overview" to point at engineering.md
and the new docs/superpowers/{specs,plans}/ flow. Updates the
stale `base-client/docs/architecture.md` pointer in "When in
doubt" to engineering.md + archive. All other operational
sections (commands, invariants, conventions, module layout,
seams, testing) are kept verbatim.
Also drops context7.json (no longer needed).
No source / test / CI changes. 157 tests still pass at 100%
coverage; ruff and ty clean.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/engineering.md(185 lines): project intent, six CI-enforced invariants with rationale, the five protocol seams, exception contract, module layout (current + planned), testing patterns, optional-extras pattern, remaining 27-story roadmap, deferred-work pointer.prd.md,architecture.md,epics.md, both product briefs, anddocs/stories/(1-1 through 1-5 +sprint-status.yaml) intodocs/archive/with a framing README.CLAUDE.md"Project Overview" to point atengineering.mdand the newdocs/superpowers/{specs,plans}/flow. Replaces the stalebase-client/docs/architecture.mdreference in "When in doubt" withengineering.md+archive/architecture.md. All other operational sections (commands, invariants, conventions, module layout, seams, testing) kept verbatim.context7.json(no longer needed).After this lands, future per-feature work runs the superpowers flow: brainstorming → spec in
docs/superpowers/specs/→ writing-plans → plan indocs/superpowers/plans/→ executing-plans (or subagent-driven-development) → requesting-code-review → finishing-a-development-branch. Story IDs retire as topic slugs; the bmad backlog mapping lives inengineering.md's roadmap section.Driving design + plan for this PR:
docs/superpowers/specs/2026-05-31-bmad-to-superpowers-transition-design.mddocs/superpowers/plans/2026-05-31-bmad-to-superpowers-transition-plan.mdTest plan
just testshows 157 passed, 1 deselected, 100% line coverage.just lint-ciclean (ruff format --check,ruff check --no-fix,ty checkall green).git status --shortafter staging shows only the elevenRrenames, oneD(context7.json), oneM(CLAUDE.md), and threeA(engineering.md,archive/README.md, the plan file).docs/engineering.mdandCLAUDE.mdresolve to files that exist post-move.🤖 Generated with Claude Code