pw-doctor
Diagnose the Prewalk installation, presets, hook manifest, state directory, and Claude Task routing setup.
Arm a prewalk run: explore and plan in the root session, land the first verified edit, then persist a Stop checkpoint for handoff.
$ npx -y skills add TerenceLiu98/prewalk --skill prewalk --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/prewalkContext preview
The summary Claude sees to decide when to auto-load this skill.
Arm a prewalk run: explore and plan in the root session, land the first verified edit, then persist a Stop checkpoint for handoff.
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."
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.
Prewalk lets a strong planner do the expensive repository work, then gives a configured executor a verified starting point and a self-contained handoff: Use it for changes where understanding the repository is a meaningful part of the work.
Diagnose the Prewalk installation, presets, hook manifest, state directory, and Claude Task routing setup.
Request the reviewed prewalk handoff and spawn exactly one routed Claude Task for the remaining todos.
Disarm Prewalk for the current Claude Code session without changing files or todos.
Reconcile an ambiguous Prewalk executor only after proving it is no longer running.
Compatibility guidance for older Claude Prewalk recovery; canonical v4 recovery uses pw-reconcile.
Retry one proven-incomplete Prewalk route from its durable packet without repeating task 1.