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