debug

Automated root-cause analysis triggers structured investigative workflows upon error events or unexpected behavior reports. It collects stack traces and reproduction steps, guiding step-by-step diagnosis through phases like problem understanding, cause investigation, hypothesis verification, and fix validation.

The step-by-step debugging process follows four phases: problem understanding, cause investigation, hypothesis verification, and fix validation. It sequentially executes structured investigative workflows using commands like grep, git log, git diff, and npm run typecheck to verify changes.

Automated debugging workflows support tRPC, Zustand, and hydration issues by referencing specific debugging patterns. These frameworks are covered in the cause investigation and hypothesis verification phases to systematically trace and resolve their associated unexpected behaviors.

Troubleshooting code errors using git log and grep is integrated into the cause investigation phase. The workflow automatically applies these commands to trace recent changes, search relevant code sections, and systematically narrow down the root cause before proceeding to fix validation.

A structured workflow for debugging enforces end-to-end requirements, preventing skipped steps during manual troubleshooting. It automatically sequences phase-based workflows for problem understanding, investigation, and verification, ensuring fixes are validated with typecheck commands before completion.