/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.