Debug

Deterministic 7-phase debugging workflow. Walk the phases in order. If a phase's gate cannot be satisfied, go back rather than skipping ahead.

Phase 1 — Symptom Capture

Collect the symptom completely before touching any code.

Record:

• Error message (exact text, not paraphrase)
• Stack trace or log excerpt
• Affected route / component / module
• Environment: local | CI | production
• First-seen commit or deployment (if known)

Gate: One-paragraph incident description in working notes before Phase 2.

Phase 2 — Git Archaeology