Initial commit

skills/debug/assets/debug_report_template.md

@@ -0,0 +1,134 @@
+# Debug Report: [Issue Title]
+
+**Date:** [YYYY-MM-DD]
+**Investigator:** [Name/AI]
+**Status:** 🟢 Resolved / 🔴 Unresolved / ⚠️ Workaround Applied
+
+---
+
+## Executive Summary
+
+[2-3 sentence summary of the issue, root cause, and resolution]
+
+---
+
+## Issue Description
+
+**Reported By:** [User/System]
+**Initial Report:**
+> [User's description or error message]
+
+**Impact:**
+- **Severity:** Critical / High / Medium / Low
+- **Users Affected:** [Number or description]
+- **Systems Affected:** [List of affected components]
+
+---
+
+## Root Cause
+
+**TL;DR:** [One sentence explanation]
+
+**Detailed Explanation:**
+[Explain what caused the issue and why it manifested the way it did]
+
+**Location:**
+- File: `[path/to/file]:[line]`
+- Component: [Component name]
+- Introduced in: [Commit hash or version]
+
+---
+
+## Investigation Process
+
+### Observations
+- [Key observation 1]
+- [Key observation 2]
+- [Key observation 3]
+
+### Hypotheses Considered
+1. ❌ [Eliminated hypothesis] - Ruled out because [reason]
+2. ❌ [Eliminated hypothesis] - Ruled out because [reason]
+3. ✅ [Confirmed hypothesis] - Confirmed by [evidence]
+
+### Key Evidence
+- [Evidence 1 that led to root cause]
+- [Evidence 2 that confirmed the diagnosis]
+
+---
+
+## Resolution
+
+### Fix Applied
+
+```diff
+# File: [filename]
+- [removed code]
++ [added code]
+```
+
+**Rationale:** [Why this fix was chosen over alternatives]
+
+### Verification
+- ✅ Original issue resolved
+- ✅ No regression in related functionality
+- ✅ Test suite passes
+- ✅ Deployed to production
+
+---
+
+## Prevention Measures
+
+**Immediate Actions:**
+1. [Action 1 - e.g., Added validation]
+2. [Action 2 - e.g., Added test coverage]
+
+**Long-term Improvements:**
+1. [Improvement 1 - e.g., Refactor error handling]
+2. [Improvement 2 - e.g., Add monitoring]
+
+**Tests Added:**
+```
+[Description or snippet of regression test]
+```
+
+---
+
+## Timeline
+
+| Time | Event |
+|------|-------|
+| [HH:MM] | Issue reported |
+| [HH:MM] | Investigation started |
+| [HH:MM] | Root cause identified |
+| [HH:MM] | Fix implemented |
+| [HH:MM] | Fix deployed |
+| [HH:MM] | Issue resolved |
+
+**Total Resolution Time:** [Duration]
+
+---
+
+## Lessons Learned
+
+**What Went Well:**
+- [Positive aspect 1]
+- [Positive aspect 2]
+
+**What Could Be Improved:**
+- [Improvement area 1]
+- [Improvement area 2]
+
+**Key Takeaway:**
+[Main lesson for future reference]
+
+---
+
+## Related Issues
+
+- [Related issue #1]
+- [Related issue #2]
+
+---
+
+**Report Generated:** [YYYY-MM-DD HH:MM]