mirror of
https://github.com/harivansh-afk/claude-code-vertical.git
synced 2026-04-15 14:03:49 +00:00
120 lines
2.7 KiB
Markdown
120 lines
2.7 KiB
Markdown
---
|
|
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.
|