| 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:
- Explore the relevant entry points, configuration, tests, and existing patterns.
- Create at most the configured number of todos. Every real todo names concrete
files or behavior and includes a test/build/verify/check criterion.
- Complete and verify only real task #1.
- Update the todo snapshot so task #1 is
completed; keep only real work in it.
- 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.
