Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
62eb262
refactor: shift create-story to requirements-focused planning
jschulte Dec 26, 2025
db05fb7
feat: add mandatory gap analysis to dev-story workflow
jschulte Dec 26, 2025
b26f822
feat: add standalone gap-analysis workflow
jschulte Dec 26, 2025
5f183d2
docs: add gap analysis user guide and migration docs
jschulte Dec 26, 2025
dd25e12
docs: document future enhancements (super-dev, auto-epic)
jschulte Dec 26, 2025
cff53fb
feat: add super-dev-story workflow for enhanced quality
jschulte Dec 26, 2025
9e7b097
feat: add autonomous-epic workflow for full epic automation
jschulte Dec 26, 2025
eb04864
feat: register new workflows in agent menus
jschulte Dec 26, 2025
5796800
feat: add push-all step to super-dev-story
jschulte Dec 26, 2025
356dd48
feat: add push-all workflow as standalone command
jschulte Dec 26, 2025
15af999
feat: integrate push-all into autonomous-epic workflow
jschulte Dec 26, 2025
5b3f347
refactor: use invoke-workflow for orchestration
jschulte Dec 26, 2025
949a8c3
feat: add planning-time gap analysis and parallel execution enhancements
jschulte Dec 27, 2025
c5afd89
feat: integrate story-pipeline with autonomous-epic for 65% token sav…
jschulte Dec 27, 2025
ee68b02
Merge remote-tracking branch 'upstream/main' into feature/autonomous-…
jschulte Dec 28, 2025
747ba51
feat: add BMAD Guide skill for automatic Claude Code installation
jschulte Dec 28, 2025
9d69f37
feat: prepare package for npm distribution as @jschulte/bmad-method
jschulte Dec 28, 2025
a14ab30
docs: add comprehensive PR description for story-pipeline integration
jschulte Dec 28, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions .claude-commands/autonomous-epic-v2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
description: 'Autonomous epic processing using story-pipeline - creates and develops all stories in an epic with minimal human intervention (65% more token efficient!)'
---

IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

<steps CRITICAL="TRUE">
1. Always LOAD the FULL @_bmad/core/tasks/workflow.xml
2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @_bmad/bmm/workflows/4-implementation/autonomous-epic/workflow.yaml
3. Pass the yaml path _bmad/bmm/workflows/4-implementation/autonomous-epic/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
5. Save outputs after EACH section when generating any documents from templates
</steps>
13 changes: 13 additions & 0 deletions .claude-commands/story-pipeline.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
description: 'Token-efficient single-session story development pipeline: create β†’ validate β†’ ATDD β†’ implement β†’ post-validate β†’ review β†’ commit (65% more efficient than super-dev-story)'
---

IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

<steps CRITICAL="TRUE">
1. Always LOAD the FULL @_bmad/core/tasks/workflow.xml
2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @_bmad/bmm/workflows/4-implementation/story-pipeline/workflow.yaml
3. Pass the yaml path _bmad/bmm/workflows/4-implementation/story-pipeline/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
5. Save outputs after EACH section when generating any documents from templates
</steps>
39 changes: 39 additions & 0 deletions .npmignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Development files
.git
.github
.husky
.vscode
.claude
.agentvibes
.DS_Store
*.log
npm-debug.log*
.env*

# Test files
test/
coverage/
*.test.js
*.spec.js

# Documentation (keep README.md)
docs/
website/
*.pdf

# Build artifacts
dist/
build/
*.tgz

# IDE
.idea/
*.swp
*.swo
*~

# Misc
.editorconfig
.prettierrc*
.eslintrc*
.markdownlint*
221 changes: 221 additions & 0 deletions FEATURE-SUMMARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,221 @@
# Gap Analysis & Quality Automation - Complete Feature Summary

## Overview

Two feature branches implementing comprehensive quality automation for BMAD-METHOD:

1. **feature/gap-analysis-dev-time** - Foundation (6 commits)
2. **feature/autonomous-epic-processing** - Full automation (11 commits total)

---

## Branch 1: Gap Analysis Foundation

**Branch:** `feature/gap-analysis-dev-time`
**Commits:** 6
**Purpose:** Solve batch planning staleness problem

### Features Added

#### 1. create-story Refactor
- Simplified to requirements analysis only
- Generates DRAFT tasks (not codebase-validated)
- Defers gap analysis to dev-time
- **Result:** Faster planning, no stale scans

#### 2. dev-story Gap Analysis (Step 1.5)
- **MANDATORY** codebase scanning before development
- Validates DRAFT tasks against reality
- Proposes refinements (add/modify/remove tasks)
- 6 user options: Y/A/n/e/s/r
- Auto-accept mode for automation
- **Result:** Tasks always reflect current codebase

#### 3. Standalone gap-analysis Workflow
- New `/gap-analysis` command
- Audit completed stories
- Detect false positives (marked done but not implemented)
- Batch validation mode
- Generate audit reports
- **Result:** Quality auditing tool

#### 4. super-dev-story Workflow
- New `/super-dev-story` command
- All dev-story steps +
- Step 9.5: Post-dev gap analysis
- Step 9.6: Auto code review
- Fix iteration loops
- **Result:** Bulletproof stories before human review

#### 5. Documentation
- docs/gap-analysis.md - Complete user guide
- docs/gap-analysis-migration.md - Migration guide
- docs/super-dev-mode.md - Concept and usage
- docs/autonomous-epic-processing.md - Future vision

**Stats:** 16 files, ~2,740 lines

---

## Branch 2: Autonomous Epic Processing

**Branch:** `feature/autonomous-epic-processing` (based on gap-analysis branch)
**Commits:** 11 (includes all 6 from gap-analysis + 5 new)
**Purpose:** "Do Epic 4 for me" - full automation

### Additional Features

#### 6. autonomous-epic Workflow
- New `/autonomous-epic` command
- Just-in-time planning (creates each story before dev)
- Auto-develops using super-dev-story or dev-story
- Progress tracking with resume capability
- Error handling with retry logic
- Epic completion reports
- **Result:** Complete epic automation

#### 7. push-all Workflow
- New `/push-all` command
- Stage all changes with safety checks
- Secret detection (API keys, credentials)
- Large file warnings
- Build artifact detection
- Smart commit message generation
- Auto-push with error handling
- **Result:** Safe automated git operations

#### 8. Agent Menu Registration
- Registered all workflows in agent menus
- Dev agent: DS, SDS, GA, AE, PA, CR
- SM agent: CS, GA, AEP, PA, ER
- **Result:** All workflows accessible via `*` commands

#### 9. Integration Enhancements
- super-dev-story Step 11: push-all
- autonomous-epic: push-all after each story
- Auto-generated commit messages
- **Result:** Seamless git integration

**Stats:** 36 files total, ~8,079 lines

---

## Complete Workflow Lineup

| Command | What It Does | Use When |
|---------|--------------|----------|
| `/dev-story` | Standard dev with pre-gap | Normal stories |
| `/super-dev-story` | Enhanced: pre+post gap + review + push | Critical stories |
| `/gap-analysis` | Audit without development | Quality checks |
| `/autonomous-epic` | Full epic automation | Overnight/CI-CD |
| `/push-all` | Safe commit+push | Anytime |

---

## Technical Stats

**Total Changes:**
- Files: 36 modified/created
- Lines: +8,079 insertions, -93 deletions
- Commits: 11 well-formed conventional commits
- Modules: BMM and BMGD (both fully supported)

**Validation:**
- βœ… All schema validation passing
- βœ… All linting passing
- βœ… All formatting passing
- βœ… All tests passing

**Backwards Compatibility:**
- βœ… No breaking changes
- βœ… Existing workflows unchanged (except enhancements)
- βœ… Users can opt-in to new features

---

## Key Innovations

### 1. Dev-Time Gap Analysis
**Problem:** Batch planning creates stale stories
**Solution:** Validate tasks against codebase when dev starts
**Impact:** Prevents duplicate code, adapts to evolved codebase

### 2. Just-in-Time Planning + Development
**Problem:** Planning all stories upfront leads to staleness
**Solution:** Create story right before developing it
**Impact:** Plans always reflect current reality

### 3. Multi-Stage Quality Validation
**Problem:** Stories marked "done" prematurely
**Solution:** Pre-gap + dev + post-gap + code review
**Impact:** True completion, fewer review cycles

### 4. Safe Automated Git Operations
**Problem:** Committing secrets, large files, build artifacts
**Solution:** Comprehensive safety checks before push
**Impact:** Secure, clean git history

---

## Testing Setup

**Your platform project:**
```
~/git/your-project/_bmad/bmm β†’ [SYMLINK] β†’ BMAD-METHOD/src/modules/bmm
```

**Compiled agents updated:**
```
~/git/your-project/.claude/commands/bmad/bmm/agents/
β”œβ”€β”€ dev.md (updated with all new workflows)
└── sm.md (updated with all new workflows)
```

**Available now (after restart):**
- `*dev-story` - Standard
- `*super-dev-story` - Enhanced
- `*gap-analysis` - Audit
- `*autonomous-epic` - Full auto
- `*push-all` - Safe commit+push

---

## Next Steps

### Immediate:
1. βœ… Restart Claude Code
2. βœ… Load Dev or SM agent (`*`)
3. βœ… Test workflows in platform project

### Short-term:
1. Gather real-world usage feedback
2. Note any edge cases or issues
3. Refine gap analysis detection
4. Improve commit message generation

### Long-term:
1. Consider PR to BMAD-METHOD repo
2. Get community feedback
3. Iterate based on usage
4. Build additional automation

---

## Contribution Ready

Both branches ready for:
- Real-world testing
- Community feedback
- PR submission to bmad-code-org/BMAD-METHOD

**Branch recommendations for PR:**
- **Option 1:** Submit gap-analysis-dev-time first (foundation)
- **Option 2:** Submit autonomous-epic-processing (includes everything)

---

**Total Development Time:** ~2 hours
**Total Value:** Solves major BMAD workflow gaps
**Community Impact:** Massive (benefits all batch planning users)

🎯 **You solved a real problem that's been hiding in plain sight!**
Loading