Interactive Debugging

Use this skill to run a debug loop: hypothesize, instrument, reproduce, inspect runtime logs, fix, verify, and clean up.

Required Paths

• Debug server: .debug/debug_server.*
• Debug log: .debug/debug.log
• Default endpoint: http://localhost:3333/debug

The bundled servers in this skill's scripts/ directory (next to this SKILL.md, not in the project being debugged) are intentionally thin. They accept POST /debug, append the raw request body to .debug/debug.log with a timestamp, and return ok.

Steps

Step 1: Understand the Bug

• Read the relevant code before changing anything.
• State 1-3 concrete hypotheses that runtime data can prove or disprove.
• Do not jump to a fix before collecting data unless the cause is already proven.