hoangsonww

debug-live-issue

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.

hoangsonww 1,106 257 Updated 7mo ago

Resources

1
GitHub

Install

npx skillscat add hoangsonww/claude-code-agent-monitor/debug-live-issue

Install via the SkillsCat registry.

About this skill

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.

SKILL.md

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