harivansh-afk/claude-code-vertical
1
0
Fork 0
mirror of https://github.com/harivansh-afk/claude-code-vertical.git synced 2026-04-19 16:03:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

plan

Browse source
This commit is contained in:
Harivansh Rathi 2026-01-19 01:53:57 -05:00
parent a95338fbf1
commit 725f536008
1 changed files with 50 additions and 81 deletions
Download patch file Download diff file Expand all files Collapse all files

127
commands/vertical-plan.md
View file

@ -1,113 +1,82 @@
--- ---
description: Check status of plans and weavers. Shows tmux sessions, weaver progress, and PRs. description: Start an interactive planning session. Design specs through Q&A, then hand off to build.
argument-hint: [plan-id] argument-hint: [description]
--- ---
# /status Command # /plan Command
Check the status of plans and weavers. Start a planning session. You become the planner agent.
## Usage ## Usage
``` ```
/status # All plans /plan
/status plan-20260119-1430 # Specific plan /plan Add user authentication with OAuth
``` ```
## Output ## What Happens
### All Plans 1. Load the planner skill from `skills/planner/SKILL.md`
2. Generate a plan ID: `plan-YYYYMMDD-HHMMSS`
3. Create plan directory: `.claude/vertical/plans/<plan-id>/`
4. Enter interactive planning mode
## Planning Flow
1. **Understand** - Ask questions until the task is crystal clear
2. **Research** - Explore the codebase, find patterns
3. **Design** - Break into specs (each = one PR)
4. **Write** - Create spec files in `specs/` directory
5. **Hand off** - Tell user to run `/build <plan-id>`
## Spec Output
Specs go to: `.claude/vertical/plans/<plan-id>/specs/`
``` ```
=== Active Tmux Sessions ===
vertical-plan-20260119-1430-orch
vertical-plan-20260119-1430-w-01
vertical-plan-20260119-1430-w-02
vertical-plan-20260119-1445-orch
=== Plan Status ===
plan-20260119-1430: running
plan-20260119-1445: running
plan-20260119-1400: complete
```
### Specific Plan
```
=== Plan: plan-20260119-1430 ===
Status: running
Started: 2026-01-19T14:35:00Z
=== Specs ===
01-schema.yaml 01-schema.yaml
02-backend.yaml 02-backend.yaml
03-frontend.yaml 03-frontend.yaml
=== Weavers ===
w-01 complete 01-schema.yaml https://github.com/owner/repo/pull/42
w-02 verifying 02-backend.yaml -
w-03 waiting 03-frontend.yaml -
=== Tmux Sessions ===
vertical-plan-20260119-1430-orch running
vertical-plan-20260119-1430-w-01 done
vertical-plan-20260119-1430-w-02 running
``` ```
## Weaver Statuses ## Transitioning to Build
| Status | Meaning | When specs are ready:
|--------|---------|
| waiting | Waiting for dependency |
| building | Implementing the spec |
| verifying | Running verification checks |
| fixing | Fixing verification failures |
| complete | PR created successfully |
| failed | Failed after max iterations |
| blocked | Dependency failed |
## Quick Commands ```
Specs ready. To execute:
```bash /build <plan-id>
# Source helpers
source lib/tmux.sh
# List all sessions To execute specific specs:
vertical_list_sessions
# Status for all plans /build <plan-id> 01-schema 02-backend
vertical_status
# Weaver status for a plan To check status:
vertical_weaver_status plan-20260119-1430
# Capture recent output from a weaver /status <plan-id>
vertical_capture_output vertical-plan-20260119-1430-w-01
# Attach to a session
vertical_attach vertical-plan-20260119-1430-w-01
``` ```
## Reading Results ## Multiple Planning Sessions
After completion: You can run multiple planning sessions in parallel:
```bash ```
# Summary # Terminal 1
cat .claude/vertical/plans/plan-20260119-1430/run/summary.md /plan Add authentication
# State # Terminal 2
cat .claude/vertical/plans/plan-20260119-1430/run/state.json | jq /plan Add payment processing
# Specific weaver
cat .claude/vertical/plans/plan-20260119-1430/run/weavers/w-01.json | jq
``` ```
## PRs Created Each gets its own plan-id and can be built independently.
When weavers complete, PRs are listed in: ## Resuming
- The summary.md file
- Each weaver's status JSON (`pr` field)
- The overall state.json (`weavers.<id>.pr`)
Merge order is indicated in summary.md for stacked PRs. Planning sessions are Claude Code sessions. Resume with:
```
claude --resume <session-id>
```
The session ID is saved in `.claude/vertical/plans/<plan-id>/meta.json`.