skills

commands/build.md

@@ -0,0 +1,120 @@
+---
+description: Execute a plan by launching orchestrator and weavers in tmux. Creates PRs for each spec.
+argument-hint: <plan-id> [spec-names...]
+---
+
+# /build Command
+
+Execute a plan. Launches orchestrator in tmux, which spawns weavers for each spec.
+
+## Usage
+
+```
+/build plan-20260119-1430
+/build plan-20260119-1430 01-schema 02-backend
+```
+
+## What Happens
+
+1. Read plan from `.claude/vertical/plans/<plan-id>/`
+2. Launch orchestrator in tmux: `vertical-<plan-id>-orch`
+3. Orchestrator reads specs, selects skills, spawns weavers
+4. Each weaver runs in tmux: `vertical-<plan-id>-w-01`, etc.
+5. Weavers build, verify, create PRs
+6. Results written to `.claude/vertical/plans/<plan-id>/run/`
+
+## Execution Flow
+
+```
+/build plan-20260119-1430
+  |
+  +-> Orchestrator (tmux: vertical-plan-20260119-1430-orch)
+        |
+        +-> Weaver 01 (tmux: vertical-plan-20260119-1430-w-01)
+        |     |
+        |     +-> Verifier (subagent)
+        |     +-> PR #42
+        |
+        +-> Weaver 02 (tmux: vertical-plan-20260119-1430-w-02)
+        |     |
+        |     +-> Verifier (subagent)
+        |     +-> PR #43
+        |
+        +-> Summary written to run/summary.md
+```
+
+## Parallelization
+
+- Independent specs (all with `pr.base: main`) run in parallel
+- Dependent specs (with `pr.base: <other-branch>`) wait for dependencies
+
+## Monitoring
+
+Check status while running:
+
+```
+/status plan-20260119-1430
+```
+
+Or directly:
+
+```bash
+# List tmux sessions
+tmux list-sessions | grep vertical
+
+# Attach to orchestrator
+tmux attach -t vertical-plan-20260119-1430-orch
+
+# Attach to a weaver
+tmux attach -t vertical-plan-20260119-1430-w-01
+
+# Capture weaver output
+tmux capture-pane -t vertical-plan-20260119-1430-w-01 -p
+```
+
+## Results
+
+When complete, find results at:
+
+- `.claude/vertical/plans/<plan-id>/run/state.json` - Overall status
+- `.claude/vertical/plans/<plan-id>/run/summary.md` - Human-readable summary
+- `.claude/vertical/plans/<plan-id>/run/weavers/w-*.json` - Per-weaver status
+
+## Debugging Failures
+
+If a weaver fails, you can resume its session:
+
+```bash
+# Get session ID from weaver status
+cat .claude/vertical/plans/<plan-id>/run/weavers/w-01.json | jq -r .session_id
+
+# Resume
+claude --resume <session-id>
+```
+
+Or attach to the tmux session if still running:
+
+```bash
+tmux attach -t vertical-<plan-id>-w-01
+```
+
+## Killing a Build
+
+```bash
+# Kill all sessions for a plan
+source lib/tmux.sh
+vertical_kill_plan plan-20260119-1430
+
+# Or kill everything
+vertical_kill_all
+```
+
+## Implementation Notes
+
+This command:
+1. Loads orchestrator skill
+2. Generates orchestrator prompt with plan context
+3. Spawns tmux session with `claude -p "<prompt>" --dangerously-skip-permissions --model opus`
+4. Returns immediately (orchestrator runs in background)
+
+The orchestrator handles everything from there.