Debug Tools

Iterative debugging workflow with targeted log injection and cleanup.

Workflow

investigate --> inject logs --> propose fix --> verify --> cleanup
     ^_________________________________________|

The workflow loops back to investigation if the fix doesn't work.

Context Loading Strategy

Load only the reference matching the current trigger. Multiple references may be
loaded during a full debugging session (investigation often leads to log injection).

Triggers

Cross-References

investigation.md <---> log-injection.md (investigation may request logs)
investigation.md <---> log-cleanup.md (after fix verified)
log-injection.md ----> log-cleanup.md (cleanup removes injected logs)

Guidelines

• Confidence scoring: >= 70 report as probable cause, 50-69 suggest logs, < 50 don't report
• Always use [DEBUG] prefix for injected logs (enables cleanup)
• Never log sensitive data (passwords, tokens, PII)
• Minimal fix: smallest change that resolves the issue
• Cleanup is automatic after fix is verified
• Uses whatever debugging tools are available in the environment

Error Handling

• No bug description provided: ask user to describe the issue
• Cannot reproduce: suggest adding debug logs
• Fix doesn't work: return to investigation phase
• Logs left behind: user can request cleanup anytime