human-machine-brainstorm-listed

# Human-Machine Brainstorm (HMB) — CCB Dispatcher Loop ## Purpose Run a repeatable multi-model requirement alignment loop in **CCB** where: - **Codex** acts as the *dispatcher* (facilitator + router). - **Claude Code** acts as the *scribe* (single source of truth spec author). - **OpenCode (Gemini)** acts as the *divergent thinker* (alternatives + ASCII prototypes). Keep every round auditable by exporting per-provider context into `./.ccb/history/` and keeping the canonical spec in `./.ccb/spec/`. ## Hard Rules - Treat `./.ccb/spec/overview.md` as the **single source of truth**. Only Claude Code edits it. - Never assume panes “share context”. Always broadcast updates explicitly. - Enforce question IDs in this format: - Claude: `C-Q01`, `C-Q02`, ... - OpenCode: `O-Q01`, `O-Q02`, ... - Accept user answers only in ID-addressed form (so routing is deterministic). ## Quick Start (zero-friction, recommended) This workflow is optimized for a **2×Codex** setup: - **Cmd pane** runs a dedicated **Codex Chair** (dispatcher). - The normal **Codex provider pane** participates as a reviewer/solver (not just idle). 1) Create (or choose) a topic directory (recommended location: `$HOME/ccb-startups/...`). - Optional helper: `bash $HOME/.codex/skills/human-machine-brainstorm/scripts/hmb-init.sh "<topic-slug>"` 2) Start CCB. - If CCB global config enables the chair cmd pane, just run: `ccb` - Otherwise: `ccb claude codex opencode cmd` (fallback) 3) Talk only to the **Code