mirror of
https://github.com/harivansh-afk/claude-code-vertical.git
synced 2026-04-15 07:04:45 +00:00
104 lines
2.5 KiB
Markdown
104 lines
2.5 KiB
Markdown
# Claude Code Vertical
|
|
|
|
Scale your Claude Code usage horizontally and vertically.
|
|
|
|
- **Horizontal**: Run multiple planning sessions in parallel
|
|
- **Vertical**: Each plan spawns multiple weavers executing specs concurrently
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Start a planning session
|
|
claude
|
|
> /plan
|
|
|
|
# Design specs interactively with the planner...
|
|
# When ready:
|
|
> /build plan-20260119-1430
|
|
|
|
# Check status
|
|
> /status plan-20260119-1430
|
|
```
|
|
|
|
## Architecture
|
|
|
|
```
|
|
You (Terminal)
|
|
|
|
|
v
|
|
Planner (interactive) <- You talk here
|
|
|
|
|
v (specs)
|
|
Orchestrator (tmux background)
|
|
|
|
|
+-> Weaver 01 (tmux) -> Verifier (subagent) -> PR
|
|
+-> Weaver 02 (tmux) -> Verifier (subagent) -> PR
|
|
+-> Weaver 03 (tmux) -> Verifier (subagent) -> PR
|
|
```
|
|
|
|
## Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/plan` | Start interactive planning session |
|
|
| `/build <plan-id>` | Execute plan via tmux weavers |
|
|
| `/status [plan-id]` | Check plan/weaver status |
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
claude-code-vertical/
|
|
├── CLAUDE.md # Project instructions
|
|
├── skills/
|
|
│ ├── planner/ # Interactive planning
|
|
│ ├── orchestrator/ # Tmux + weaver management
|
|
│ ├── weaver-base/ # Base skill for all weavers
|
|
│ └── verifier/ # Verification subagent
|
|
├── commands/
|
|
│ ├── plan.md
|
|
│ ├── build.md
|
|
│ └── status.md
|
|
├── skill-index/
|
|
│ ├── index.yaml # Skill registry
|
|
│ └── skills/ # Available skills
|
|
├── lib/
|
|
│ └── tmux.sh # Tmux helper functions
|
|
└── .claude/
|
|
└── vertical/
|
|
└── plans/ # Your plans live here
|
|
```
|
|
|
|
## All Agents Use Opus
|
|
|
|
Every agent uses `claude-opus-4-5-20250514` for maximum capability.
|
|
|
|
## Skill Index
|
|
|
|
The orchestrator matches `skill_hints` from specs to skills in `skill-index/index.yaml`.
|
|
|
|
Current skills include:
|
|
- Swift/iOS development (concurrency, SwiftUI, testing, debugging)
|
|
- Build and memory debugging
|
|
- Database and networking patterns
|
|
- Agent orchestration tools
|
|
|
|
## Resume Any Session
|
|
|
|
```bash
|
|
# Find session ID
|
|
cat .claude/vertical/plans/<plan-id>/run/weavers/w-01.json | jq -r .session_id
|
|
|
|
# Resume
|
|
claude --resume <session-id>
|
|
```
|
|
|
|
## Tmux Helpers
|
|
|
|
```bash
|
|
source lib/tmux.sh
|
|
|
|
vertical_status # Show all plans
|
|
vertical_list_sessions # List tmux sessions
|
|
vertical_attach <session> # Attach to session
|
|
vertical_kill_plan <plan-id> # Kill all sessions for a plan
|
|
```
|