skills

README.md

@@ -0,0 +1,104 @@
+# 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
+```