This skill provides a structured workflow for debugging production-like issues in a repository. It guides evidence-based investigation of failing workflows, regressions, flaky behavior, and data inconsistencies across hooks, API, DB, websocket, and UI components. Developers should use it when fixing incidents requiring root cause analysis before applying minimal fixes.
Resources
1Install
npx skillscat add hoangsonww/claude-code-agent-monitor/debug-live-issue Install via the SkillsCat registry.
This skill provides a structured workflow for debugging production-like issues in a repository. It guides evidence-based investigation of failing workflows, regressions, flaky behavior, and data inconsistencies across hooks, API, DB, websocket, and UI components. Developers should use it when fixing incidents requiring root cause analysis before applying minimal fixes.
Debug Live Issue
Use this workflow for incident-style debugging.
Steps
- Capture symptom, expected behavior, and reproducible path.
- Isolate subsystem first: hook ingestion, API route, DB state, websocket, or UI rendering.
- Reproduce with minimal surface area.
- Prove root cause before changing code.
- Apply minimal fix and re-verify.
Evidence standards
- Prefer direct logs, API responses, DB state checks, and deterministic repro steps.
- Avoid speculative fixes without root-cause evidence.
- If not fully reproducible, state uncertainty and strongest hypothesis.
References
- Investigation template:
references/investigation-template.md