bmad-orchestrator

# BMAD Orchestrator

Orchestrate the 4-phase BMAD Method (Breakthrough Method of Agile AI Driven Development) across OpenClaw ↔ Claude Code.

## Architecture

- **Phases 1-3 (Interactive)**: Run through OpenClaw chat with the user. You facilitate brainstorming, refine the PRD, debate architecture. The user's ideas matter most here.
- **Party Mode**: At key decision points, suggest running party mode on Claude Code — multiple BMAD agents debate the topic and produce richer output.
- **Phase 4 (Automated)**: Delegate to Claude Code via tmux on the dev VM. Monitor progress, report back.

## Prerequisites

- Claude Code installed on dev VM (accessible via SSH)
- BMAD framework installed in the project (`_bmad/` directory with agents, workflows, commands)
- tmux available on the dev VM

## State Tracking

Track workflow state in `_bmad-output/orchestrator-state.yaml`:

```yaml
project: <name>
vm_host: <ip>
vm_user: <user>
project_path: <path>
tmux_socket: /tmp/openclaw-tmux-sockets/openclaw.sock
tmux_session: bmad-<project>
current_phase: 1|2|3|4
current_workflow: <workflow-name>
artifacts:
  brainstorming_report: null|path
  product_brief: null|path  
  prd: null|path
  ux_spec: null|path
  architecture: null|path
  epics: null|path
  sprint_status: null|path
  project_context: null|path
```

## Phase 1: Analysis (Interactive with User)

### 1.1 Brainstorming (`bmad-brainstorming`)

Run this conversationally with the user in OpenClaw chat:

1. Ask: "What project are we building? Give me the elevator pitch."
2. Explore the problem space — ask about users, pain points, existing solutions
3. Challenge assumptions — play devil's advocate
4. **Suggest Party Mode**: "Want me to run party mode on Claude Code? The BMAD agents (analyst, architect, PM, dev) will debate your idea and surface things we might miss."
5. If party mode → send `/bmad-brainstorming` to Claude Code, capture output, share highlights
6. Synthesize into key decisions and themes
7. Produce: `brainstorming-rep...