mirror of https://github.com/harivansh-afk/claude-code-vertical.git synced 2026-04-15 12:03:49 +00:00

2026-01-19 01:41:00 -05:00

2.7 KiB

Raw Blame History

description	argument-hint
Execute a plan by launching orchestrator and weavers in tmux. Creates PRs for each spec.	<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

Read plan from .claude/vertical/plans/<plan-id>/
Launch orchestrator in tmux: vertical-<plan-id>-orch
Orchestrator reads specs, selects skills, spawns weavers
Each weaver runs in tmux: vertical-<plan-id>-w-01, etc.
Weavers build, verify, create PRs
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:

# 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:

# 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:

tmux attach -t vertical-<plan-id>-w-01

Killing a Build

# 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:

Loads orchestrator skill
Generates orchestrator prompt with plan context
Spawns tmux session with claude -p "<prompt>" --dangerously-skip-permissions --model opus
Returns immediately (orchestrator runs in background)

The orchestrator handles everything from there.

2.7 KiB Raw Blame History