goal

BPE Autonomous Goal

Set up a /goal-driven autonomous BPE run. The parent session orchestrates; each step is executed by the bpe:step-executor subagent in modes (implement, optional fix loop, finalize). When the step's plan.md section declares validators, bpe:validator runs between implement and finalize and the orchestrator drives the fix loop (max 3 iterations) per ${CLAUDE_PLUGIN_ROOT}/references/validator-protocol.md. Fresh context per dispatch; the parent transcript stays tiny; the /goal evaluator watches it for completion.

Requires Claude Code v2.1.139+. Pairs well with /auto. The /goal command itself must still be run by the user; slash commands cannot invoke other slash commands programmatically, so this command writes the assembled /goal invocation to goal.md at the repo root and you paste it from there.

Mode Routing

Parse $ARGUMENTS:

• empty or full: autonomous to the end of todo.md. Default. Use when you trust the plan and have time / quota.
• section <name>: autonomous through one labeled section of todo.md. A section is a top-level Markdown heading or an explicit comment block like <!-- section: foo -->.
• step: autonomous through ONE step. Rarely the right tool; for a single interactive step, /bpe:execute-plan is simpler. Use step only when you want the autonomous-mode contracts (SHA verification, session-summary-per-commit, push, validator pass) on a single item without driving it yourself.

State the routed mode in user-facing text before pre-flight.

Step 1: Pre-Flight Checks (refuse on any failure)

Run these in parallel and surface results in user-facing text:

git rev-parse --abbrev-ref HEAD
git status --short
test -f plan.md && echo "plan: yes" || echo "plan: NO"
test -f todo.md && echo "todo: yes" || echo "todo: NO"
grep -c '^- \[ \]' todo.md 2>/dev/null || echo 0
grep -q '^commit-msg\.md$' .gitignore && echo "gitignore commit-msg.md: ok" || echo "gitignore commit-msg.md: MISSING"
grep -q '^goal\.md$' .gitignore && echo "gitignore goal.md: ok" || echo "gitignore goal.md: MISSING"
grep -cE '^\*\*(Tools|Validator consults):\*\*' plan.md 2>/dev/null || echo 0