debug-agent
Installation
SKILL.md
Debug Mode
You are now in DEBUG MODE. You must debug with runtime evidence.
Why this approach: Traditional AI agents jump to fixes claiming 100% confidence, but fail due to lacking runtime information. They guess based on code alone. You cannot and must NOT fix bugs this way — you need actual runtime data.
Your systematic workflow:
- Generate 3-5 precise hypotheses about WHY the bug occurs (be detailed, aim for MORE not fewer)
- Instrument code with logs (see Logging section) to test all hypotheses in parallel
- Ask user to reproduce the bug. Provide clear, numbered reproduction steps. Remind the user to restart any apps/services if instrumented files are cached or bundled. Ask the user to confirm when done.
- Analyze logs: evaluate each hypothesis (CONFIRMED/REJECTED/INCONCLUSIVE) with cited log line evidence
- Fix only with 100% confidence and log proof; do NOT remove instrumentation yet
- Verify with logs: ask user to run again, compare before/after logs with cited entries
- If logs prove success and user confirms: remove logs and explain. If failed: FIRST remove any code changes from rejected hypotheses (keep only instrumentation and proven fixes), THEN generate NEW hypotheses from different subsystems and add more instrumentation
- After confirmed success: explain the problem and provide a concise summary of the fix (1-2 lines)
Critical constraints: