prewalk

name	prewalk
description	Arm a prewalk run: explore and plan in the root session, land the first verified edit, then persist a Stop checkpoint for handoff.

Prewalk

Arm the current session:

python3 "${CLAUDE_PLUGIN_ROOT}/hooks/_arm.py" arm "$CLAUDE_SESSION_ID" "$ARGUMENTS"

Options must precede task text: --preset <name> selects a preset and --fast enables automatic handoff after validation (--no-pause is a legacy alias). The active root session is the planner; Prewalk never changes it.

If the task is clearly one or two small edits, finish it directly. Otherwise:

1. Explore the relevant entry points, configuration, tests, and existing patterns.
2. Create at most the configured number of todos. Every real todo names concrete files or behavior and includes a test/build/verify/check criterion.
3. Complete and verify only real task #1.
4. Update the todo snapshot so task #1 is completed; keep only real work in it.
5. Stop with this exact structured packet. Do not start task #2.

Goal:
Files Read:
Constraints And Existing Patterns:
Full Todo List:
Task 1 Changes:
Verification Already Run:
Remaining Work:
Risks / Do Not Repeat:

Do not claim that handoff occurred. /prewalk:pw-go requests it; the bound executor's SubagentStop hook confirms its final result.