/debug login page crashes on submit
Auto mode (fully automatic, use recommended solutions):
/debug -a API returning 500 on POST
What it does:
- Analyze: Reproduce error, identify root cause → ask if you have more context
- Find Solutions: Research 2-3+ potential fixes with pros/cons
- Propose: Present options → you choose which solution
- Fix: Implement solution with strategic logging
- Verify: Multi-layer verification (Static → Build → Runtime)
Key principle: Tests passing ≠ fix working. Always execute the actual code path.
Note: Only 2 questions in the entire workflow:
- After analysis: "Do you have additional info?"
- After finding solutions: "Which solution to implement?"
- Reproduce Before Anything Else - If you can't reproduce it, you can't verify the fix
- Hypothesis-Driven Analysis - List 3-5 causes ranked by likelihood, test systematically
- Multi-Layer Verification - Tests alone give false confidence (20-40% still fail in production)
┌─────────────┐
│ Manual │ ← User confirms
└──────┬──────┘
┌─────────┴─────────┐
│ Runtime Execution │ ← CRITICAL: Real execution
└─────────┬─────────┘
┌───────────┴───────────┐
│ Automated Checks │ ← Build, Types, Lint, Tests
└───────────┬───────────┘
┌─────────────┴─────────────┐
│ Static Analysis │ ← Syntax, Imports
└───────────────────────────┘
Key Insight: Tests passing ≠ fix working. ALWAYS execute the actual code path.
| Flag | Name | Description |
|---|---|---|
-a, --auto |
Auto mode | Full automatic mode - don't ask the user, use recommended solutions |
Arguments:
- Everything after flags =
{error_context}- Description of the error or context about what's failing
| Variable | Type | Description |
|---|---|---|
{error_context} |
string | User's description of the error |
{auto_mode} |
boolean | Skip confirmations, use recommended options |
{error_analysis} |
object | Detailed analysis from step 1 |
{solutions} |
list | Potential solutions found in step 2 |
{selected_solution} |
object | User's chosen solution from step 3 |
{files_modified} |
list | Files changed during the fix |
{verification_result} |
object | Results from verification step |
- Error successfully reproduced
- Root cause identified through hypothesis testing
- 2-3+ potential solutions researched with pros/cons
- Solution selected (by user or auto mode)
- Fix implemented with strategic logging
- Static analysis passes (syntax, imports)
- Build completes successfully
- Tests pass (if tests exist)
- Runtime execution verified (actual code path executed)
- User confirms fix resolves the original issue
- No regressions introduced