- Renamed package to @jschulte/bmad-method (scoped package)
- Updated version to 6.0.0-alpha.22
- Updated repository URL to jschulte/BMAD-METHOD
- Added .npmignore to exclude dev files
- Enhanced description to mention story-pipeline
This allows users to install via:
npx @jschulte/bmad-method install
Integrates the bmad-guide skill into BMAD installation process to help
Claude stay on track with BMAD methodology.
Features:
- Phase navigation and workflow selection guidance
- Project level detection (0-4) for routing to correct workflows
- Common mistakes prevention (skipping phases, manual coding)
- Emergency recovery procedures when off track
- Quick reference tables and troubleshooting
Implementation:
- Created resources/skills/ directory with bmad-guide.md (428 lines)
- Added installBmadGuideSkill() to ClaudeCodeSetup class
- Skill auto-installs to ~/.claude/skills/ during setup
- Available globally across all BMAD projects
- Updated installation documentation
Usage:
- Automatic: Skill is installed when running npx bmad-method install
- Manual access: /bmad-guide command in any project
- Optional: Add BMAD Method config to ~/.claude/CLAUDE.md for automatic invocation
Benefits:
- Prevents Claude from jumping straight to coding without workflows
- Ensures proper phase progression
- Guides workflow selection based on project level
- Self-corrects when going off track
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
- Complete gap analysis feature documentation
- Migration guide for existing users
- Usage examples for all planning styles
- Troubleshooting and FAQ sections
- 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.
Major improvements:
- Path segregation implementation across 90+ workflow files
- Windows installer fixed with inquirer v9.x upgrade
- Custom installation messages via install-messages.yaml
- Two-version auto upgrade with config preservation
- Quick-dev workflow refactor with adversarial review
- Doc site auto-generation on merge
- Streamlined personas and cleaned up documentation
* 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
Jonah Schulte
Brian Madison
Alex Verkhovsky
Jonah Schulte
Murat K Ozcan