Help us improve
Share bugs, ideas, or general feedback.
From pbr
Automatically executes next step in PLAN-BUILD-RUN workflow: reads STATE.md/ROADMAP.md, checks milestones/dependencies, acts or delegates via Task/Skill tools.
npx claudepluginhub sienklogic/plan-build-runHow this skill is triggered — by the user, by Claude, or both
Slash command
/pbr:continueThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
**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 ~7,600 tokens. Begin executing Step 1 immediately.**
Resumes coding sessions by detecting blockers, reconciling STATE.md with filesystem, and suggesting next actions from checkpoints or plans.
Executes all remaining milestone phases autonomously: discuss→plan→execute per phase. Updates ROADMAP.md/STATE.md, handles blockers/user input, audits, and cleans up. Ideal for batch milestone completion.
Executes individual phases of implementation plans as autonomous background sub-agents, performing pre-flight checks, file changes, and automated verifications.
Share bugs, ideas, or general feedback.
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 ~7,600 tokens. Begin executing Step 1 immediately.
You are running the continue skill. Unlike /pbr:status which shows the dashboard and suggests the next action, /pbr:continue determines and EXECUTES the next logical step automatically. Stops safely at milestones, checkpoints, errors, and verification gaps.
This skill runs inline and may delegate to other skills via Task().
Before ANY tool calls, display this banner:
╔══════════════════════════════════════════════════════════════╗
║ PLAN-BUILD-RUN ► NEXT STEP ║
╚══════════════════════════════════════════════════════════════╝
Then proceed to Step 1.
Reference: skills/shared/context-budget.md for the universal orchestrator rules.
Additionally for this skill:
Do, don't ask. Read STATE.md, determine the next action, and execute it. The user wants hands-off forward progress.
Read .planning/STATE.md and determine current position:
Then read .planning/ROADMAP.md to identify the current milestone boundary:
## Milestone: section contains the current phase/pbr:milestone to complete it."Depends on references a phase from the previous milestone that is not yet complete, warn: "Cross-milestone dependency: Phase {N} depends on Phase {M} from milestone {prev}, which is not yet complete."If STATE.md doesn't exist, display:
╔══════════════════════════════════════════════════════════════╗
║ ERROR ║
╚══════════════════════════════════════════════════════════════╝
No project state found.
**To fix:** Run `/pbr:begin` first.
Before proceeding to priority evaluation, check for runaway continue chains:
last_command from STATE.md. If last_command is missing, empty, or the field does not exist, skip directly to the fallback detection — do NOT error or warn.last_command is present and equals /pbr:continue, this is a chained continue. Check session context for consecutive /pbr:continue invocations.last_command is not available or not present in STATE.md:
.planning/.active-skill file — if it contains continue, treat as a chained continuelast_action field — if it contains continue, treat as a chained continue/pbr:continue in a row, display:WARNING: Context budget warning: 6 consecutive auto-continues detected.
Recommend running /pbr:pause then resuming in a fresh session.
Then present the user with a choice:
/pbr:pause logic to save state and stopThis prevents runaway chains that fill the context window without a human checkpoint.
Check the resumption priority hierarchy (same as /pbr:resume):
status: gaps_found → Execute /pbr:plan {N} --gaps.checkpoint-manifest.json with pending items → Resume the build.continue-here.md exists → Follow its next step/pbr:build {N}/pbr:review {N}/pbr:plan {N+1}/pbr:milestone audit to verify cross-phase integration, then /pbr:milestone complete to archive."/pbr:milestone new to start the next milestone, or /pbr:milestone audit if not yet audited."Based on the determined action, display the delegation indicator to the user:
◐ Delegating to /pbr:{skill} {args}...
Then invoke the appropriate skill via the Skill tool. NEVER read SKILL.md files into your context — this wastes the main context budget with 500+ lines of instructions. Instead, use the Skill tool which runs the skill in a clean invocation:
| Situation | Action | How |
|---|---|---|
| Gaps need closure | Plan gap closure | Skill({ skill: "pbr:plan", args: "{N} --gaps" }) |
| Build incomplete | Continue build | Skill({ skill: "pbr:build", args: "{N}" }) |
| Review needed | Run review | Skill({ skill: "pbr:review", args: "{N}" }) |
| Next phase needed | Plan next phase | Skill({ skill: "pbr:plan", args: "{N+1}" }) |
| Project not started | Plan phase 1 | Skill({ skill: "pbr:plan", args: "1" }) |
Where {N} is the current phase number determined from STATE.md in Step 1.
After execution completes, display a branded completion:
╔══════════════════════════════════════════════════════════════╗
║ PLAN-BUILD-RUN ► STEP COMPLETE ✓ ║
╚══════════════════════════════════════════════════════════════╝
✓ Completed: {what was done}
╔══════════════════════════════════════════════════════════════╗
║ ▶ NEXT UP ║
╚══════════════════════════════════════════════════════════════╝
**{Next action description}**
`/pbr:continue` or `{specific command}`
If features.auto_advance is true AND mode is autonomous:
After the delegated skill completes, immediately re-run Step 1-3 to determine and execute the NEXT action. Continue chaining until a hard stop is reached. This enables hands-free phase cycling: build→review→plan→build→...
Do NOT auto-continue when:
config.mode is NOT autonomous and a gate confirmation is neededIn these cases, explain why auto-continue stopped and what the user needs to do.