diagnose-bug

Diagnose Bug

1. Inspect the repo and determine whether the target is python, javascript, or php.
2. Run the execution-risk-check workflow before any debug session.
3. If the likely command is obvious from nearby tests or scripts, use it.
4. If the command is not clear, ask the user for the exact entrypoint or test command.
5. Use mcp-debugger directly:
   • create a debug session for the chosen language
   • start debugging with stop-on-entry or a breakpoint near the failure
   • inspect stack, scopes, variables, and evaluated expressions
6. Explain the failure from observed runtime state, not static guesswork.

For PHP, require Xdebug-backed execution. If Xdebug is missing, stop and report the setup requirement.