do

STOP -- DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~3,000 tokens. Begin executing Step 1 immediately.

/pbr:do -- Freeform Task Router

You are running the do skill. Your job is to analyze freeform text from the user and route it to the most appropriate PBR skill. You are a dispatcher, not an executor -- you never do the work yourself.

Step 0 -- Immediate Output

Before ANY tool calls, display this banner:

╔══════════════════════════════════════════════════════════════╗
║  PLAN-BUILD-RUN ► DO                                        ║
╚══════════════════════════════════════════════════════════════╝

Then proceed to Step 1.

Step 1 -- Validate Input

If $ARGUMENTS is empty, ask the user what they want to do via AskUserQuestion:

What would you like to do? Describe the task, bug, or idea and I'll route it to the right skill.

Step 2 -- Analyze and Route

Step 2a -- Gather Context

1. Read .planning/STATE.md to get current_phase, status, phase_slug.
2. Check if .planning/ROADMAP.md exists (set hasRoadmap).
3. Build context object: { activePhase: phase_slug, hasRoadmap: boolean }.

Step 2b -- Check Config

1. Read .planning/config.json if it exists.
2. Check features.natural_language_routing (default: true if absent).
3. Check features.adaptive_ceremony (default: true if absent).
4. Check ceremony_level (default: "auto" if absent).

Step 2c -- Intent Classification

When NL routing is enabled (features.natural_language_routing is true or absent):

Score $ARGUMENTS against these route keyword groups:

| Route | Keywords | Weight | |-------|----------|--------| | debug | bug, error, crash, fix, broken, failing, exception, stacktrace, debug | 1.0 | | explore | explore, research, investigate, how does, how do, understand, analyze, compare | 1.0 | | plan-phase | plan, architect, design, migrate, refactor across, redesign, system, new | 0.9 | | quick | add, create, update, change, rename, remove, write test, implement, feature, refactor | 0.85 | | note | remember, note, todo, idea, later, don't forget, remind | 1.0 | | validate-phase | validate, coverage gaps, test gaps, missing tests, untested, requirement coverage | 1.0 | | verify-work | review, check, verify, quality, looks right | 0.9 |

Scoring algorithm:

1. Count how many keywords from each route appear in the lowercased input.
2. Calculate confidence per route: (0.5 + 0.5 (1 - 1/(matches+1))) weight.
3. Apply context boosters:
4. If there's a recent error in context: boost debug by +0.3.
5. If an active phase exists: boost plan-phase by +0.1.
6. If no roadmap exists: reduce plan-phase by -0.2.
7. Clamp all scores to 0-1.

Routing decision:

• If top confidence >= 0.7: proceed with that route.
• If top confidence < 0.7: present top 2-3 candidates to user via AskUserQuestion. Example:

Your request could match several skills:
- /pbr:quick (confidence: 0.65) -- Self-contained task execution
- /pbr:debug (confidence: 0.55) -- Systematic bug investigation
Which would you prefer?

When NL routing is disabled (features.natural_language_routing is false):

Fall back to the original static table -- apply the first matching rule:

| If the text describes... | Route to | |--------------------------|----------| | A bug, error, crash, failure, or something broken | /pbr:debug | | Exploration, research, comparison, or "how does X work" | /pbr:explore | | A complex task: refactoring, migration, multi-file architecture, system redesign | /pbr:plan-phase add | | Validation, coverage gaps, missing tests, or untested requirements | /pbr:validate-phase | | A review or quality concern about existing work | /pbr:verify-work | | A note, idea, or "remember to..." | /pbr:note | | A specific, actionable task (add feature, fix typo, update config, write test) | /pbr:quick |

Step 2d -- Risk Classification

When adaptive ceremony is enabled (features.adaptive_ceremony is true or absent):

Analyze $ARGUMENTS for risk signals:

| Risk Level | Signal Keywords | |------------|----------------| | HIGH | migrate, redesign, refactor across, architecture, security, database schema, breaking change, entire, across | | MEDIUM | implement, create, integrate, add feature, new endpoint, write test, add, endpoint, api | | LOW | typo, rename, config, update, fix typo, comment, readme, docs |

Scoring: HIGH signals add +3, MEDIUM signals add +1, LOW signals add -1 each. Additional context factors: 8+ files affected (+3), 3+ files (+1), 3+ subsystems (+5), no existing tests (+1).

Risk thresholds: score >= 4 is HIGH, score >= 1 is MEDIUM, otherwise LOW.

Ceremony override: If ceremony_level is NOT "auto", skip risk classification and use the override directly:

| ceremony_level | Ceremony | |----------------|----------| | low | inline | | medium | lightweight-plan | | high | full-plan-build-verify |

Risk-to-ceremony mapping (when ceremony_level is "auto"):

| Risk | Ceremony | Dispatch | |------|----------|----------| | low | inline | Route to /pbr:quick (inline execution, no plan file) | | medium | lightweight-plan | Route to /pbr:quick (with note to create a lightweight plan) | | high | full-plan-build-verify | Route to /pbr:plan-phase add (full plan-build-verify cycle) |

When adaptive ceremony is disabled (features.adaptive_ceremony is false):

Use the route from Step 2c without ceremony adjustment.

Step 3 -- Confirm and Dispatch

Display the routing decision:

**Input:** {first 80 chars of arguments}
**Intent:** {skill} (confidence: {score})
**Risk:** {low|medium|high} -- {top signal}
**Ceremony:** {inline|lightweight-plan|full-plan-build-verify}
**Routing to:** {chosen skill}

Then invoke the chosen skill via the Skill tool, passing $ARGUMENTS as the args.

Special case for /pbr:plan-phase add: When routing to plan, check if .planning/ROADMAP.md exists first (via Read). If it doesn't, suggest /pbr:new-project instead -- the user needs to set up the project before they can add phases.

Step 4 -- No Follow-Up

After invoking the skill, your job is done. The dispatched skill handles everything from here (execution, commits, state updates). Do not add any additional output after the Skill tool call.

Feature Toggles

These config properties in .planning/config.json control routing behavior:

• features.natural_language_routing: false -- disables smart intent detection, falls back to static keyword table.
• features.adaptive_ceremony: false -- disables risk-based ceremony selection, uses intent route directly.
• ceremony_level: "high" -- forces full ceremony on everything (overrides risk classification).
• ceremony_level: "low" -- forces inline ceremony on everything.
• ceremony_level: "auto" -- (default) uses risk classification to determine ceremony.