This commit integrates the story-pipeline workflow (PR #1194) with autonomous-epic
and adds post-implementation validation to catch false positives.
MAJOR CHANGES:
1. Merged story-pipeline workflow from upstream PR #1194 (20 files, 4,564 additions)
2. Added post-validation step (step-05b) between implementation and code review
3. Integrated story-pipeline as the default workflow for autonomous-epic
4. Replaced super-dev-story with story-pipeline in batch mode
NEW FEATURES:
- Post-implementation validation (step-05b-post-validation.md)
* Verifies completed tasks against actual codebase
* Catches false positives (tasks marked done but not implemented)
* Re-runs implementation if gaps found
* Uses Glob/Grep/Read to verify file existence and completeness
BENEFITS:
- Token efficiency: 25-30K per story (vs 100-150K with super-dev-story)
- 65% token savings per story, 75% savings per epic
- All super-dev-story quality gates PLUS post-validation
- Checkpoint/resume capability for long stories
- Batch mode for fully unattended execution
ARCHITECTURE:
- autonomous-epic orchestrates epic-level processing
- story-pipeline handles single-story lifecycle (9 steps including 5b)
- Role-switching in same session (vs separate workflow calls)
- Single session per story = massive token savings
TIME ESTIMATES (updated):
- Small epic (3-5 stories): 2-4 hours (was 3-6 hours)
- Medium epic (6-10 stories): 4-8 hours (was 6-12 hours)
- Large epic (11+ stories): 8-16 hours (was 12-24 hours)
FILES MODIFIED:
- autonomous-epic/instructions.xml (integrated story-pipeline)
- autonomous-epic/workflow.yaml (updated settings, removed super-dev choice)
- story-pipeline/* (20 new files from PR #1194)
- story-pipeline/steps/step-05-implement.md (points to step-05b)
- story-pipeline/workflow.md (added step 5b to map and gates)
- story-pipeline/workflow.yaml (added step 5b definition)
- story-pipeline/templates/*.yaml → *.yaml.template (renamed to avoid linting)
FILES ADDED:
- story-pipeline/steps/step-05b-post-validation.md (NEW)
- INTEGRATION-NOTES.md (comprehensive documentation)
TESTING:
- PR #1194 validated with real User Invitation system story
- 17 files, 2,800+ lines generated successfully
- Context exhaustion recovery tested
See INTEGRATION-NOTES.md for full details.
Co-authored-by: tjetzinger (story-pipeline PR #1194)
- Add create-story-with-gap-analysis workflow for verified codebase scanning at planning time
- Fix autonomous-epic to support parallel execution (no auto-branch creation)
- Fix autonomous-epic and super-dev-story to auto-accept gap analysis in autonomous mode
- Fix push-all to support targeted file commits (safe for parallel agents)
- Update dev-story and super-dev-story to pass auto_accept_gap_analysis parameter
- Add explicit autonomous mode instructions to workflows
Breaking changes: None - all enhancements are backward compatible
- Each story now commits and pushes after completion
- Auto-generated commit messages per story
- Safety checks run before each push
- Continues on push failures (doesn't halt entire epic)
- All changes backed up to remote incrementally
Ensures epic progress is saved to remote as work completes
- New /push-all workflow for commit and push with safety
- Can be used anywhere (not just in super-dev-story)
- Comprehensive safety checks (secrets, API keys, large files)
- Smart commit message generation (conventional commits)
- Handles push failures (rebase, upstream, auth)
- Registered in Dev and SM agent menus
- Also integrated into super-dev-story Step 11
Applies to both BMM and BMGD modules
- Add super-dev-story to dev agents (trigger: SDS)
- Add gap-analysis to dev + scrum master agents (trigger: GA)
- Add autonomous-epic to dev + scrum master agents (trigger: AEP)
- All workflows now accessible via slash commands
Available commands:
- /super-dev-story or /SDS
- /gap-analysis or /GA
- /autonomous-epic or /AEP
- New /autonomous-epic command processes entire epic
- Just-in-time planning: creates each story before developing
- Auto-develops using super-dev-story or dev-story
- Progress tracking with resume capability
- Git commits after each story completion
- Error handling with retry logic and continue-on-failure
- Epic completion report with statistics
- Estimated: 100K-150K tokens per story
Use cases:
- Overnight epic completion
- CI/CD integration
- Batch sprint processing
Applies to both BMM and BMGD modules
- New /super-dev-story command for comprehensive validation
- Includes all dev-story steps PLUS:
- Step 9.5: Post-dev gap analysis (verify completion)
- Step 9.6: Automated code review (catch issues)
- Auto-fixes issues and loops back if gaps/problems found
- Max iteration safety (default 3 cycles)
- Opt-in via separate command (not forced)
- ~30% more tokens but prevents review rework cycles
Applies to both BMM and BMGD modules
- Audit completed stories to verify claims match code
- Validate any story without starting development
- Detect false positives (marked done but not implemented)
- Batch mode to audit multiple stories
- Generate audit reports for team review
Applies to both BMM and BMGD modules
- Add Step 1.5 gap analysis before development starts
- Scan codebase to validate draft tasks against reality
- Propose task refinements (add/modify/remove)
- Six user options: approve, auto-accept, reject, edit, skip, review
- Update story file with Gap Analysis section
- Prevents duplicate implementations in batch planning
Applies to both BMM and BMGD modules
- Remove codebase scanning from planning phase
- Mark generated tasks as DRAFT
- Add notation that tasks will be validated at dev-time
- Focus on requirements analysis and architecture context
- Simplify workflow by deferring gap analysis to execution
Applies to both BMM and BMGD modules
Major improvements:
- All agents now use consistent 2-letter menu codes (compound triggers)
- Phase 1-3 workflows updated to use planning_artifacts folder
- Windows installer fixed with inquirer multiselection resolution
- Chat and party mode auto-injected into all agents
- All agents pass comprehensive validation checks
- Restored agent files from Docusaurus merge
* fix: restore agent files accidentally modified in Docusaurus merge
Restores 25 agent files to their pre-merge state:
- Trigger format with shortcuts (WS, CH, BP, etc.) restored
- Fuzzy matching syntax restored
- BMB module: restores separate agent-builder, module-builder,
workflow-builder agents; removes consolidated bmad-builder
Also updates test to match restored trigger format.
Note: Schema validation needs update in follow-up commit.
* fix: normalize trigger fuzzy match format for schema validation
- Add dashes to fuzzy match text to match kebab-case triggers
- Add missing 'chat' kebab in CH triggers (CH or chat or fuzzy match on chat)
- Relax schema to allow 1-3 char shortcuts and skip shortcut derivation check
- Remove compound-wrong-shortcut test fixture (no longer validated)
All 24 agent files now pass schema validation.
* docs: remove dead links in test architecture documentation
* docs: updated test architecture documentation for clarity and consistenc
* docs: update test architecture documentation for clarity and consistency
* docs: addressed PR comments
* feat: add documentation website with Docusaurus build pipeline
* feat(docs): add AI discovery meta tags for llms.txt files
- Add global headTags with ai-terms, llms, llms-full meta tags
- Update landing page link to clarify AI context purpose
* fix(docs): restore accidentally deleted faq.md and glossary.md
Files were removed in 12dd97fe during path restructuring.
* fix(docs): update broken project-readme links to GitHub URL
* feat(schema): add compound trigger format validation
- Fix XML syntax error in dev-story/instructions.xml:20 (goto element)
- Fix path typo in tech-writer.agent.yaml (_bmadbmm → _bmad/bmm)
- Fix wrong route in analyst.agent.yaml (edit-agent → party-mode)
- Comment out unimplemented validate-create-story in sm.agent.yaml
- Comment out unimplemented validate-design in ux-designer.agent.yaml
- Remove misleading validate-create-story reference in create-story output
Fixes#1075
Related to #1163🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
* fix(bmm): sprint-status workflow improvements
- Remove dead by_epic template block and context_status variable (#1116, #1117)
- Define "first" story ordering as epic number then story number (#1119)
- Clarify retrospective check: "any retrospective status == optional" (#1120)
- Strengthen validate mode: check required metadata fields and valid statuses (#1121)
- Expand risk detection: stale file, orphaned stories, empty epics (#1122)
- Fix retrospective valid status: use "done" instead of "completed" for consistency
Fixes#1116, fixes#1117, fixes#1119, fixes#1120, fixes#1121, fixes#1122🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(bmm): address CodeRabbit review feedback
- Improve retrospective status descriptions for clarity
- Fix empty epic detection to only warn on in-progress epics
- Add 'generated' to required metadata field validation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
* fix(bmm): improve sprint-status validation and epic status handling
- Add status validation with interactive correction for unknown values
- Update epic statuses to match state machine: backlog, in-progress, done
- Map legacy "contexted" status to "in-progress" explicitly
- Add retrospective status counting (optional, completed)
- Rewrite risk detection rules for LLM clarity
- Fix warnings vs risks naming inconsistency in data mode
Closes#1106Closes#1118🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* style: fix prettier formatting in sprint-status instructions
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Rename 'develop-story' to 'dev-story' across agent triggers and documentation
to match the actual workflow folder and YAML configuration naming.
- Update dev.agent.yaml trigger from develop-story to dev-story
- Update game-dev.agent.yaml trigger from develop-story to dev-story
- Update 7 references in agents-guide.md documentation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Updated status references to use canonical lowercase kebab-case format:
- dev-story/instructions.xml: Status field set to "review" (was "Ready for Review")
- dev-story/instructions.xml: Output messages reference actual "review" status
- dev-story/checklist.md: Status field instruction uses "review"
- daily-standup.xml: Status examples use "in-progress, review"
Story lifecycle: backlog → ready-for-dev → in-progress → review → done
Fixes#1105🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The `drafted` story state is no longer used since create-story now sets
status directly to `ready-for-dev`. This PR removes all references to
this legacy state from BMM documentation and workflow files.
Changes:
- Remove `drafted` from story status definitions and state machine docs
- Remove dead story-context file detection (story-context files no longer exist)
- Replace "draft" verb with "create" in story-related messaging
- Add legacy `drafted` → `ready-for-dev` migration in sprint-status
- Clarify that validate-create-story is optional and doesn't change status
- Document story handoff sequence: create-story → (optional) validate → dev-story
Story lifecycle is now: backlog → ready-for-dev → in-progress → review → done
Closes#1089🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Change "Story is ready for next work!" to "Code review complete!"
The original phrasing was misleading - when a code review finishes
with status "done", it means the review itself is complete and the
story is marked done in tracking. However, the user may choose to
do additional reviews or the story may genuinely be finished.
"Code review complete" more accurately describes what actually
happened without implying next steps.
Removes references to epic-tech-context, story-context, story-done,
and story-ready workflows that were deleted in the Phase 4 transformation.
Also renames mislabeled excalidraw element IDs from proc-story-done
to proc-code-review to match the actual displayed text.
Fixes#1088
- Add markdownlint-cli2 as dev dependency
- Add lint:md script to package.json
- Add markdownlint job to CI workflow
- Configure 5 rules: heading-increment, no-duplicate-heading,
no-trailing-punctuation, no-bare-urls, no-space-in-emphasis
- Fix existing violations across 19 markdown files
- No auto-fix to prevent destructive changes
Closes#1034🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
* update 2024 to 2025
* fix(workflows): remove hardcoded years from WebSearch queries
Years in search queries (2024/2025) do not improve results - search
engines already prioritize current documentation. Tested all patterns
and confirmed identical quality results with/without years.
Removes years from:
- step-03-starter.md (5 queries)
- step-04-decisions.md (2 queries)
- game-architecture/instructions.md (2 queries)
Leaves file-utils.md unchanged (test fixture data, not a search query).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(workflows): remove year placeholders from research WebSearch queries
Search engines return current results regardless of year - removes
{{current_year}} and hardcoded 2025 from step-05-technical-trends.md
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* refactor(workflows): replace {{current_year}} with semantic alternatives
Replaces year placeholder with context-appropriate wording:
- 'current data' for up-to-date information
- 'web searches' without year qualifier
- Updated failure mode to focus on using web searches
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(workflows): clarify failure mode about stale training data
Rephrased to explicitly mention training data cutoff as the reason
to use web searches for current technology trends.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* refactor(workflows): make web search references platform-agnostic
- Remove hardcoded year references from WebSearch queries
- Replace `WebSearch` tool name with natural language "search the web"
- Soften "training data is stale" to "verify and supplement your knowledge"
- Add web search prerequisite check to research workflow
- Add platform-agnostic design note to CLAUDE.md
This framework targets 15+ agentic platforms, not just Claude Code.
Tool-specific syntax like `WebSearch:` won't work across all platforms.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor(research): clean up prompts and routing
---------
Co-authored-by: Pomazan Bohdan <pomazan.bogdan@gmail.com>
Co-authored-by: Brian <bmadcode@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
- Remove validate-prd workflow references from all workflow path YAML files
- Update Excalidraw diagram: remove Validate PRD box and zombie JSON elements
- Re-export SVG at 1x scale
- Standardize implementation-readiness descriptions across all docs
- Add validation script (validate-svg-changes.sh) and README for SVG export process
- Correct Excalidraw timestamps
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Brian <bmadcode@gmail.com>
- Fix checklist to only accept 'review' status (not 'ready-for-review')
- Include MEDIUM issues in done/in-progress status determination
- Initialize and track fixed_count/action_count variables for summary
- Add sprint-status.yaml sync when story status changes
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
Replace 'looks good' with `looks good` to avoid nested single quote
issues when IDEs generate command files from workflow YAML.
Co-authored-by: Brian <bmadcode@gmail.com>
* feat: add sprint-status command
* minor changes to reduce the change radius
---------
Co-authored-by: mq-bot <mq-bot@local>
Co-authored-by: Brian <bmadcode@gmail.com>
Brian Madison
Jonah Schulte
Alex Verkhovsky
Jonah Schulte
Murat K Ozcan
Serhii
murat
Hang
Nguyen Quang Huy
Dicky Moore