# Master Orchestrator — Workflows Overview

All workflows + 6 Tracks + Review Track · left-to-right · tmux split-pane labeled · in-process fallback documented

tmux mode detection When tmux is active (`$TMUX` is set): split-pane agents spawn in new panes as shown.
▶ Fallback (no tmux): All split-pane steps automatically run in-process instead — all agents share the same conversation context. Review gates already run in-process; quick-dev fix steps run sequentially in the same conversation.
6 Workflow Tracks — Master Orchestrator triage routes to one of these
Complexity 0-1 → N · 2 → S · 3 → C · 4-5 → M · 6-7 → E · 8+ → L | in-process = same conversation split-pane = new tmux pane (fallback: in-process)
[N] Nano score 0–1 ≤20 lines · 1-2 files · no spec · one-commit undo
Quick Dev
quick-flow-solo-dev
split-pane ¹
in: task description · branch · session_id
out: code changes on branch
⚠ scope >20 lines or new imports → HALT → upgrade to Small
↓
DRY+UV Gate
review agent · 2-sub-spec
in-process
in: branch · code diff · session_id
sub-1: architect · DRY (clean-code-standards) in-process
sub-2: ux-designer · UV (ux-audit) in-process
findings? → quick-dev split-pane fixes · re-audit in-process
↓
⛔ USER APPROVAL
HALT — await [approve]
shows: files changed · gate summary
↓
/prepare-to-merge
in-process
in: branch name
[S] Small score 2 2–4 files · quick fix · no schema · single-commit undo
Quick Spec
quick-flow-solo-dev
in-process
in: task description · branch · session_id
out: planning/{slug}/quick-spec.md
↓
Quick Dev
quick-flow-solo-dev
split-pane ¹
in: quick-spec.md · branch · session_id
out: code changes on branch
↓
Review Gate
review agent · 3 in-process audits
in-process
in: artifact_path · branch · track:small · review_type:3-sub
sub-1: architect · AR+DRY in-process
sub-2: ux-designer · UV in-process
sub-3: security · SR in-process
findings? → quick-dev split-pane fixes · re-audit
↓ 🔴→ quick-dev split-pane → re-audit
QA Tests (Playwright)
qa-agent
split-pane
in: branch · quick-spec.md · code changes
out: .spec.ts files (Playwright, not MCP)
↓
⛔ USER APPROVAL
HALT — await [approve]
shows: AR+DRY · UV · SR · QA summary
↓
/prepare-to-merge
in-process
in: branch name
[C] Compact score 3 4–8 files · light context needed · no UX design phase
Quick Spec
quick-flow-solo-dev
in-process
in: task description · branch
out: planning/{slug}/quick-spec.md
↓
Quick Research (optional)
analyst-agent ×1
in-process · if needed
in: quick-spec.md · research type (codebase or API)
out: planning/{slug}/research-report.md
skip if QS is self-contained
↓
Quick Dev
quick-flow-solo-dev
split-pane ¹
in: quick-spec.md · research-report.md (if run) · branch
out: code changes on branch
↓
Review Gate
review agent · 3 in-process audits
in-process
in: artifact_path · branch · track:compact · review_type:3-sub
sub-1: architect · AR+DRY in-process
sub-2: ux-designer · UV in-process
sub-3: security · SR in-process
findings? → quick-dev split-pane fixes · re-audit
↓ 🔴→ quick-dev split-pane → re-audit
QA Tests (Playwright)
qa-agent
split-pane
in: branch · quick-spec.md · code changes
out: .spec.ts files
↓
⛔ USER APPROVAL
HALT — await [approve]
shows: AR · UV · SR · QA summary
↓
/prepare-to-merge
in-process
in: branch name
[M] Medium score 4–5 6–12 files · full spec · UX involved · multi-step rollback
Quick Spec
quick-flow-solo-dev
in-process
in: task description · branch
out: planning/{slug}/quick-spec.md
↓
Research (1–2 agents)
analyst-agent ×1-2
in-process
in: quick-spec.md · research type per agent
UI-heavy: codebase + design patterns · backend: 1 agent
out: planning/{slug}/research-*.md
↓
UX Design
ux-designer-agent
split-pane
in: quick-spec.md · research reports
out: planning/{slug}/ux-design.md
↓
Review Gate 1 (spec + UX review)
review agent · 3 in-process audits
in-process
in: quick-spec.md · ux-design.md · research reports · review_type:3-sub
sub-1: architect · AR+DRY in-process
sub-2: ux-designer · UV + styling-standards.md in-process
sub-3: security · SR in-process
findings? → quick-dev split-pane · re-audit in-process
↓ 🔴→ back to QS
Quick Dev
quick-flow-solo-dev
split-pane ¹
in: quick-spec.md · ux-design.md · branch
out: code changes on branch
↓
Final Review Gate
review agent · 3 in-process audits
in-process
in: artifact_path (code diff) · quick-spec.md · ux-design.md · research reports · branch · review_type:3-sub
sub-1: architect · AR+DRY · 1-pass max in-process
sub-2: ux-designer · UV in-process
sub-3: security · SR in-process
findings? → quick-dev split-pane fixes · re-audit
↓ 🔴→ quick-dev split-pane → re-audit
QA Tests (Playwright)
qa-agent
split-pane
in: branch · quick-spec.md · ux-design.md · code changes
out: .spec.ts files
↓
⛔ USER APPROVAL
HALT — await [approve]
shows: gate-1 · gate-final · QA summary
↓
/prepare-to-merge
in-process
in: branch name
[E] Extended score 6–7 10–16 files · arch impact · PRD needed · no epic loop
Quick Spec
quick-flow-solo-dev
in-process
in: task description · branch
out: planning/{slug}/quick-spec.md
↓
Research ×2 (always)
analyst-agent ×2
in-process
agent-1: codebase exploration (files/patterns involved)
agent-2: domain/technical (external APIs, design patterns)
out: planning/{slug}/research-codebase.md · research-domain.md
↓
PRD
pm-agent
split-pane
in: quick-spec.md · both research reports
out: planning/{slug}/prd.md
↓
UX + Arch Notes + Sprint Plan
ux-designer-agent → architect-agent (sequential, same split-pane)
split-pane (sequential)
in: prd.md · research reports
ux: planning/{slug}/ux-design.md
arch: planning/{slug}/architecture-notes.md (≤5 bullets)
sprint: planning/{slug}/sprint-plan.md
↓
Review Gate 1 (plans review)
review agent · 3 in-process audits
in-process
in: prd.md · ux-design.md · architecture-notes.md · sprint-plan.md · review_type:3-sub
reviews all plans for coherence + feasibility vs PRD
sub-1: architect · AR+DRY in-process
sub-2: ux-designer · UV in-process
sub-3: security · SR in-process
findings? → back to UX+Arch+Sprint step
↓ 🔴→ back to UX+Arch+Sprint
Dev
dev-agent (full impl.)
split-pane ¹
in: prd.md · ux-design.md · architecture-notes.md · sprint-plan.md · branch
out: full implementation on branch
↓
Review Gate 2 (code review)
review agent · 3 in-process audits
in-process
in: artifact_path · prd.md · ux-design.md · architecture-notes.md · sprint-plan.md · research reports · RG1 findings · branch · review_type:3-sub
sub-1: architect · AR+DRY in-process
sub-2: ux-designer · UV in-process
sub-3: security · SR in-process
findings? → quick-dev split-pane fixes · re-audit
↓ 🔴→ quick-dev split-pane → re-audit
QA Tests (Playwright)
qa-agent
split-pane
in: branch · prd.md · ux-design.md · architecture-notes.md · sprint-plan.md · RG2 findings · code changes
out: .spec.ts files
↓
⛔ USER APPROVAL
HALT — await [approve]
shows: PRD · UX · arch · gate-1 · gate-2 · QA summary
↓
/prepare-to-merge
in-process
in: branch name
[L] Large score 8+ 12+ files · new schema/service · epic decomposition
Product Brief
pm-agent
split-pane
in: task description · branch · session_id
out: planning/{slug}/product-brief.md
↓
Research ×3 (parallel)
analyst-agent ×3 (MR · DR · TR)
split-pane ²
agent-1: Market Research — user/competitive context
agent-2: Domain Research — industry/domain patterns
agent-3: Technical Research — external APIs, tech stack
out: planning/{slug}/research-{mr|dr|tr}.md (×3)
↓
Create PRD
pm-agent
split-pane
in: product-brief.md · all 3 research reports
out: planning/{slug}/prd.md
↓
Planning Gate (2-sub spec)
review agent · DRY+UV in-process
in-process
in: prd.md · product-brief.md · review_type:2-sub-spec
sub-1: architect · DRY only in-process · no AR yet
sub-2: ux-designer · UV in-process
findings? → quick-dev split-pane · re-audit
↓ spawn both panes simultaneously
UX Design
ux-designer-agent
split-pane
in: prd.md · research reports
out: planning/{slug}/ux-design.md
Architecture Doc
architect-agent
split-pane
in: prd.md · research reports
out: planning/{slug}/architecture.md
↓ wait for both to report back
↓
Design Gate (2-sub spec)
review agent · DRY+UV in-process
in-process
in: ux-design.md · architecture.md · review_type:2-sub-spec
sub-1: architect · DRY in-process
sub-2: ux-designer · UV in-process
findings? → quick-dev split-pane · re-audit
↓
Epics & Stories
sm-agent
split-pane
in: product-brief.md · prd.md · research-mr.md · research-dr.md · research-tr.md · ux-design.md · architecture.md · design-gate findings
out: stories/epic-{n}/story-{n}.md (per story)
↓
Impl. Readiness Check
architect-agent
in-process
in: prd.md · architecture.md · all story files
out: readiness verdict (blocks SP if not ready)
↓
Sprint Plan
sm-agent
split-pane
in: epics · stories · IR verdict · prd.md · architecture.md · ux-design.md · research reports
out: planning/{slug}/sprint-plan.md
↓
⛔ USER APPROVAL
HALT before epic loop
shows: sprint plan · story list · epic count
↓
─ Per-Story Loop ─
Create Story (sm-agent): story file + planning artifacts → story-{n}.md
Dev Story (dev-agent ¹): story file → code on branch
Review Gate (review agent · 3-sub): code diff · review_type:3-sub → findings
QA (qa-agent): story + code → .spec.ts · auto-loops up to 3×
all steps split-pane · repeats per story · 3 gate iterations max then auto-escalate [CC]
↓
Final Review Gate
review agent · 3-sub · post-epic holistic review
in-process
in: full branch diff · product-brief.md · prd.md · ux-design.md · architecture.md · all epic artifacts · review_type:3-sub
sub-1: architect · AR+DRY in-process
sub-2: ux-designer · UV in-process
sub-3: security · SR in-process
findings? → route back to relevant story in epic loop
↓ 🔴→ back to epic loop
Final QA (Playwright)
qa-agent
split-pane
in: branch · prd.md · ux-design.md · architecture.md · all epic acceptance criteria
out: full .spec.ts suite
↓
⛔ USER APPROVAL
HALT after final gate + QA
shows: per-epic gates · final gate · QA summary
↓
/prepare-to-merge
in-process
in: branch name
¹ Dev agents (quick-flow-solo-dev, dev-agent) always launch split-pane — no track is exempt, per CLAUDE.md. ² >2 research agents = split-pane (parallel visibility).
Review Track — [RV] standalone review workflow
[RV] Entry
standalone review
① Target Definition
master-orchestrator
in-process
review agentin-process · coordinates
② MULTI-LENS — 3 IN-PROCESS AUDITS
architect agent · AR + DRY in-process
ux-designer agent · UV (ux-audit) in-process
security agent · SR (security-review + /sr) in-process
findings? → quick-dev split-pane fixes · re-audit in-process
③ Findings Synthesis
review agent · in-process
after sub-agents close
④ Sort Artifacts
review agent
in-process
◇ Volume
Gate
YES >8 / 🔴 arch
⑤L Epics & Stories
sm-agent
split-pane
in: synthesis report · findings · prd.md (if exists) · ux-design.md (if exists)
out: stories/epic-{n}/story-{n}.md
⑥L IR Check
architect-agent
in-process
⑦L Sprint Planning
sm-agent
split-pane
⑧L Epic Dev Loop
dev-agent per story
split-pane ¹
review gate: 3 in-process
findings → quick-dev split-pane
⑨L Final Review Gate
review agent · 3-sub
in-process
🔴 → back to epic loop
⑩L QA Tests
qa-agent
split-pane
⑪L USER APPROVAL
🛑 HALT for approve
⑫L /prepare-to-merge
master-orchestrator
in-process
✅ BRANCH READY
NO → small path
⑤S Quick Dev
dev-agent
split-pane ¹
⑥S Review Gatein-process · coordinates
3 IN-PROCESS AUDITS
architect agent · AR+DRY in-process
ux-designer agent · UV in-process
security agent · SR in-process
findings? → quick-dev split-pane · re-audit
⑦S QA Tests
qa-agent
split-pane
⑧S USER APPROVAL
🛑 HALT for review
🔴 → back to ⑤S
⑨S /prepare-to-merge
master-orchestrator
in-process
✅ BRANCH READY
Review Gate — 3 in-process audits · findings → quick-dev split-pane fix
STANDARD CODE REVIEW GATE (3-sub) — all code tracks
Entry point
any track · before QA
review agentin-process · coordinates
3 IN-PROCESS AUDITS (sequential, same conversation)
architect agent · AR + DRY (clean-code-standards) in-process
ux-designer agent · UV (ux-audit) in-process
security agent · SR (security-review + /security-review) in-process
Consolidate verdicts
review agent · in-process
in-process
findings?
quick-dev fixes
quick-flow-solo-dev
split-pane
re-audit after fixes
SPEC-ONLY GATE (2-sub — Nano, Large planning/design) — no AR, no SR
review agent
spec gate · 2 in-process audits
in-process
2 IN-PROCESS AUDITS (no AR, no SR — spec only)
architect agent · DRY only (clean-code-standards) in-process
ux-designer agent · UV (ux-audit) in-process
Consolidate
review agent · in-process
in-process
findings?
quick-dev fixes
quick-flow-solo-dev
split-pane
re-audit after fixes
Review Loop Workflows — autonomous N-pass with auto-fix
LOOP PATTERN (same for DRYL, UVL, SRL)
Ask loop count1/2/3 default 2
in-process
Pass N — Review
review agent + skill
{type}-findings-{id}-pass{N}.md
in-process
dev-agent
auto-fix 🔴/🟡
in-process
Pass N+1
or exit
🟢-only
early exit ✅
max + 🔴
🛑 HALT + escalate
DRYL
[DRYL]
clean-code-standards
architect-agent
UVL
[UVL]
ux-audit
ux-designer-agent
SRL
[SRL]
security-review + /sr
security-agent
Planning Workflows — left to right through agents
Product Brief
bmad-bmm-create-product-brief
pm-agent
in-process
Create PRD
bmad-bmm-create-prd
pm-agent
prd-{id}.md
in-process
Validate PRD
bmad-bmm-validate-prd
pm-agent
in-process
Create Architecture
bmad-bmm-create-architecture
architect-agent
architecture-{id}.md
in-process
Create UX Design
bmad-bmm-create-ux-design
ux-designer-agent
ux-audit
in-process
Sprint Execution Workflows
Create Epics + Stories
bmad-bmm-create-epics-and-stories
sm-agent
in-process
Sprint Planning
bmad-bmm-sprint-planning
sm-agent
in-process
Dev Story
bmad-bmm-dev-story · [QD] ¹
dev-agent
split-pane ¹
Review Gate
review agent
3 in-process audits
in-process
findings → quick-dev split-pane
QA / E2E Tests
bmad-bmm-qa-generate-e2e-tests
qa-agent
split-pane
Research Workflows
Domain Research
bmad-bmm-domain-research
analyst-agent
in-process
Market Research
bmad-bmm-market-research
analyst-agent
in-process
Technical Research
bmad-bmm-technical-research
analyst-agent
in-process
Sprint Health + Lifecycle
Sprint Status
bmad-bmm-sprint-status
sm-agent
in-process
Correct Course
bmad-bmm-correct-course
sm-agent
in-process
Retrospective
bmad-bmm-retrospective
sm-agent
in-process
Impl. Readiness Check
bmad-bmm-check-impl-readiness
architect-agent
in-process
Orchestrator Menu Triggers — all left-to-right invocation paths
[N]
Nano track
[QD]
Quick-Dev
[F]
Feature
[L]
Large
[RG]
Review Gate
[RV]
Review Track
[BF]
Bugfix
[DRY]
DRY/SOLID
[DRYL]
DRY Loop
[UV]
UX Review
[UVL]
UV Loop
[SR]
Security
[SRL]
SR Loop
Review Agent / Gate
Architect / Dev
UX domain
Security domain
Autonomous loop
Planning / user
Sprint management
in-process Single agent, same conversation
split-pane New tmux pane spawned · closes on complete