levalencia BmadOrchestrate
Accelerates BMAD sprints by analyzing story dependencies, identifying parallelization opportunities, and orchestrating concurrent execution across git worktrees with tmux and Claude Code.
Customization
Before executing, check for user customizations at:
~/.claude/skills/PAI/USER/SKILLCUSTOMIZATIONS/BmadOrchestrate/
If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.
Voice Notification
When executing a workflow, do BOTH:
Send voice notification:
curl -s -X POST http://localhost:8888/notify \ -H "Content-Type: application/json" \ -d '{"message": "Running WORKFLOWNAME in BmadOrchestrate to ACTION"}' \ > /dev/null 2>&1 &Output text notification:
Running the **WorkflowName** workflow in the **BmadOrchestrate** skill to ACTION...
Full documentation: ~/.claude/skills/PAI/THENOTIFICATIONSYSTEM.md
Workflow Routing
| Workflow | Trigger | File |
|---|---|---|
| Analyze | "analyze for parallelization", "find parallel stories", "dependency graph" | Workflows/Analyze.md |
| Execute | "execute parallel", "launch worktrees", "run stories in parallel" | Workflows/Execute.md |
| Merge | "merge worktrees", "combine branches", "merge parallel work" | Workflows/Merge.md |
Examples
Example 1: Full orchestration from bmad-help output
User: "Parallelize the remaining Epic 4 stories"
→ Invokes Analyze workflow
→ Reads sprint-status.yaml + epics.md
→ Builds dependency graph, identifies 4-2 ‖ 4-4 as independent
→ Presents phase plan with parallel tracks
→ User approves → Invokes Execute workflow
→ Creates worktrees, launches tmux + Claude Code instances
Example 2: Analyze only
User: "Which stories can I run in parallel?"
→ Invokes Analyze workflow
→ Reads sprint status and epic definitions
→ Returns dependency graph + parallelization opportunities
→ Does NOT execute (analysis only)
Example 3: Merge completed worktrees
User: "Merge the parallel story branches back"
→ Invokes Merge workflow
→ Lists worktree branches with changes
→ Merges sequentially, resolving sprint-status.yaml conflicts
→ Cleans up worktrees
Quick Reference
- Dependency detection: Reads acceptance criteria for cross-story references
- Conflict hotspot:
sprint-status.yaml— always needs manual merge - Worktree location:
.claude/worktrees/(Claude Code default) - tmux session name:
bmad-epic-{N}where N is the active epic number
Full Documentation:
- Dependency patterns:
DependencyPatterns.md
Execution Modes
| Mode | Method | Requirement | Isolation |
|---|---|---|---|
| Agent Teams (preferred) | Agent tool with isolation: "worktree" |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS env var set |
Automatic git worktree per agent |
| tmux (fallback) | Manual worktree + tmux panes | tmux installed, no CLAUDECODE env var blocking |
Manual git worktree creation |
Agent Teams is preferred when available — it handles worktree creation, isolation, and cleanup automatically.