rb:plan

Plan Ruby/Rails/Grape Work

Plan a feature by spawning Ruby specialists, then write a structured plan with checkboxes.

What Makes /rb:plan Different

1. It routes research through Ruby/Rails/Grape specialists.
2. It plans with [direct], [active record], [hotwire], [sidekiq], [concurrency], [security], [test] task annotations (canonical Set A; consumed by /rb:work).
3. In mixed stacks, it identifies the owning package and ORM before planning changes.
4. It bakes in verification gates for Zeitwerk, formatter, tests, and optional Brakeman.
5. It understands Rails controllers, service objects, Active Record, Sequel, Grape APIs, Redis, and Sidekiq jobs.

Workflow State Machine

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   START     │───▶│  RESEARCH   │───▶│   DESIGN    │
└─────────────┘    └─────────────┘    └──────┬──────┘
                                             │
┌─────────────┐    ┌─────────────┐    ┌──────▼──────┐
│    DONE     │◀───│  EXECUTE    │◀───│    PLAN     │
└─────────────┘    └─────────────┘    └─────────────┘
                          │
                   ┌──────▼──────┐
                   │  VERIFY     │
                   └─────────────┘

Each phase has entry/exit criteria. Do not skip phases.

Slug Pre-Bind Detection (/rb:full integration)

Before deriving a fresh slug, check for an EXPLICIT pre-set marker. Read .claude/ACTIVE_PLAN directly — do NOT call active-plan-marker.sh get, because that script falls back to disk globs (newest plan with unchecked tasks, newest planning-phase dir) which can return an unrelated namespace.

Apply 4 strict guards before reusing a pre-bound namespace:

1. .claude/ACTIVE_PLAN exists and is not a symlink
2. The path it points to is an existing non-symlink directory
3. That directory contains a non-symlink progress.md whose **State**: line equals INITIALIZING or DISCOVERING
4. That directory does NOT yet contain plan.md (pre-plan phase)

All 4 must pass — otherwise derive a fresh slug, create namespace, and set the marker AFTER plan.md write (existing standalone behavior).