BMAD-METHOD/src/modules/bmm/workflows/4-implementation
Jonah Schulte 90010f8ef9 feat(batch-super-dev): add git commit queue + stricter story validation
Addresses two critical production issues discovered during real usage:

ISSUE #1: Git Lock File Conflicts in Parallel Mode
----------------------------------------------------
Multiple parallel agents trying to commit simultaneously caused:
- .git/index.lock conflicts
- "Another git process is running" errors
- Required manual intervention to resolve

SOLUTION: Git Commit Queue with File-Based Locking
- Workers acquire .git/bmad-commit.lock before committing
- Automatic retry with exponential backoff (1s → 30s)
- Stale lock cleanup (>5 min old locks auto-removed)
- Timeout protection (max 5 min wait, then HALT)
- Serializes commits while keeping implementations parallel
- Zero user intervention needed

Implementation:
- super-dev-pipeline/step-06-complete.md: Added commit queue logic
- super-dev-pipeline/step-06a-queue-commit.md: NEW documentation file
- .gitignore: Added .git/bmad-commit.lock

ISSUE #2: 0-Task Stories Classified as COMPLEX
-----------------------------------------------
Real example from production:
- "11-4-classes-workshops-advanced": 0 tasks, high-risk keywords
- Classified as COMPLEX (risk keywords triggered it)
- Proceeded to implementation → agent had nothing to do → failed

SOLUTION: Minimum 3-Task Requirement
- Step 2.5 validation now rejects stories with <3 tasks
- Step 2.6 complexity scoring marks <3 tasks as INVALID
- INVALID stories filtered out before user selection
- Clear error message directs user to /validate-create-story

Validation Rules:
- 0-2 tasks: INVALID (stub/incomplete)
- 3 tasks: Minimum valid (MICRO threshold)
- 4-15 tasks: STANDARD
- 16+ tasks: COMPLEX

Implementation:
- batch-super-dev/instructions.md:
  - Step 2.5: Added <3 task check with detailed error message
  - Step 2.6: Added INVALID classification for <3 tasks
  - End of Step 2.6: Filter INVALID stories before selection
- batch-super-dev/README.md: Documented validation rules
- CHANGELOG.md: Comprehensive documentation of both features

Impact:
- Commit queue: Eliminates 100% of git lock file conflicts
- Story validation: Prevents wasted tokens on incomplete stories
- Combined: Production-ready parallel batch processing
2026-01-07 20:10:49 -05:00
..
batch-super-dev feat(batch-super-dev): add git commit queue + stricter story validation 2026-01-07 20:10:49 -05:00
code-review fix: *code-review is picking up non-application files (#1232) 2026-01-01 13:22:51 +08:00
correct-course paths for workflow and sprint tatus files fixed 2026-01-01 21:20:14 +08:00
create-story Merge remote-tracking branch 'upstream/main' 2026-01-05 23:52:36 -05:00
create-story-with-gap-analysis feat: add anti-skip safeguards and verification to implementation workflows 2026-01-01 02:52:48 -05:00
dev-story feat: add continuous sprint-status tracking with task-level progress 2026-01-07 17:28:52 -05:00
gap-analysis feat: add standalone gap-analysis workflow 2025-12-26 14:02:41 -05:00
push-all feat: add planning-time gap analysis and parallel execution enhancements 2025-12-27 02:29:46 -05:00
recover-sprint-status Merge origin/main: sync epic-specific tracking files with backwards compatibility 2026-01-02 20:20:35 -05:00
retrospective workflow status, init and phase 4 items aligned with planning_artifacts and implementation_artifacts for discovery and output 2025-12-27 10:59:44 +08:00
sprint-planning feat: add planning-time gap analysis and parallel execution enhancements 2025-12-27 02:29:46 -05:00
sprint-status feat: add continuous sprint-status tracking with task-level progress 2026-01-07 17:28:52 -05:00
story-pipeline feat: add anti-skip safeguards and verification to implementation workflows 2026-01-01 02:52:48 -05:00
super-dev-pipeline feat(batch-super-dev): add git commit queue + stricter story validation 2026-01-07 20:10:49 -05:00
super-dev-story refactor: remove autonomous-epic in favor of batch-super-dev 2026-01-07 16:00:32 -05:00
validate-all-epics Merge origin/main: sync epic-specific tracking files with backwards compatibility 2026-01-02 20:20:35 -05:00
validate-all-stories feat(validation): Add comprehensive story validation system with Haiku agents 2026-01-02 19:20:11 -05:00
validate-all-stories-deep feat(validation): Add comprehensive story validation system with Haiku agents 2026-01-02 19:20:11 -05:00
validate-epic-status refactor: remove autonomous-epic in favor of batch-super-dev 2026-01-07 16:00:32 -05:00
validate-story feat(validation): Add comprehensive story validation system with Haiku agents 2026-01-02 19:20:11 -05:00
validate-story-deep feat(validation): Add comprehensive story validation system with Haiku agents 2026-01-02 19:20:11 -05:00