From a95338fbf161b12bd04753036537c12e9b4fb0e8 Mon Sep 17 00:00:00 2001 From: Harivansh Rathi Date: Mon, 19 Jan 2026 01:51:41 -0500 Subject: [PATCH] rename --- commands/plan.md | 82 ---------------- commands/{build.md => vertical-build.md} | 0 commands/{status.md => vertical-plan.md} | 0 commands/vertical-status.md | 113 +++++++++++++++++++++++ 4 files changed, 113 insertions(+), 82 deletions(-) delete mode 100644 commands/plan.md rename commands/{build.md => vertical-build.md} (100%) rename commands/{status.md => vertical-plan.md} (100%) create mode 100644 commands/vertical-status.md diff --git a/commands/plan.md b/commands/plan.md deleted file mode 100644 index 94102d1..0000000 --- a/commands/plan.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -description: Start an interactive planning session. Design specs through Q&A, then hand off to build. -argument-hint: [description] ---- - -# /plan Command - -Start a planning session. You become the planner agent. - -## Usage - -``` -/plan -/plan Add user authentication with OAuth -``` - -## What Happens - -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//` -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 ` - -## Spec Output - -Specs go to: `.claude/vertical/plans//specs/` - -``` -01-schema.yaml -02-backend.yaml -03-frontend.yaml -``` - -## Transitioning to Build - -When specs are ready: - -``` -Specs ready. To execute: - - /build - -To execute specific specs: - - /build 01-schema 02-backend - -To check status: - - /status -``` - -## Multiple Planning Sessions - -You can run multiple planning sessions in parallel: - -``` -# Terminal 1 -/plan Add authentication - -# Terminal 2 -/plan Add payment processing -``` - -Each gets its own plan-id and can be built independently. - -## Resuming - -Planning sessions are Claude Code sessions. Resume with: - -``` -claude --resume -``` - -The session ID is saved in `.claude/vertical/plans//meta.json`. diff --git a/commands/build.md b/commands/vertical-build.md similarity index 100% rename from commands/build.md rename to commands/vertical-build.md diff --git a/commands/status.md b/commands/vertical-plan.md similarity index 100% rename from commands/status.md rename to commands/vertical-plan.md diff --git a/commands/vertical-status.md b/commands/vertical-status.md new file mode 100644 index 0000000..07ffa26 --- /dev/null +++ b/commands/vertical-status.md @@ -0,0 +1,113 @@ +--- +description: Check status of plans and weavers. Shows tmux sessions, weaver progress, and PRs. +argument-hint: [plan-id] +--- + +# /status Command + +Check the status of plans and weavers. + +## Usage + +``` +/status # All plans +/status plan-20260119-1430 # Specific plan +``` + +## Output + +### All Plans + +``` +=== 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 + 02-backend.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 + +| Status | Meaning | +|--------|---------| +| 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 + +```bash +# Source helpers +source lib/tmux.sh + +# List all sessions +vertical_list_sessions + +# Status for all plans +vertical_status + +# Weaver status for a plan +vertical_weaver_status plan-20260119-1430 + +# Capture recent output from a weaver +vertical_capture_output vertical-plan-20260119-1430-w-01 + +# Attach to a session +vertical_attach vertical-plan-20260119-1430-w-01 +``` + +## Reading Results + +After completion: + +```bash +# Summary +cat .claude/vertical/plans/plan-20260119-1430/run/summary.md + +# State +cat .claude/vertical/plans/plan-20260119-1430/run/state.json | jq + +# Specific weaver +cat .claude/vertical/plans/plan-20260119-1430/run/weavers/w-01.json | jq +``` + +## PRs Created + +When weavers complete, PRs are listed in: +- The summary.md file +- Each weaver's status JSON (`pr` field) +- The overall state.json (`weavers..pr`) + +Merge order is indicated in summary.md for stacked PRs.