Council Debug Skill

Systematic debugging and root cause analysis with both Codex (GPT-5.2) and Gemini.

When to Use

• Complex bugs requiring investigation
• Mysterious errors or failures
• Performance issues
• Race conditions or timing problems
• When user asks for debugging help from the council

Reasoning Level

xhigh (always - debugging requires deep analysis)

Execution

1. Gather all relevant context:

- Error messages - Stack traces - Relevant code files - Logs if available

1. Formulate a debugging prompt:

``` Debug this issue systematically:

Problem: <description of the bug>

Error: <error message/stack trace>

Relevant Code: <code snippets>

Please: 1. Identify potential root causes 2. Analyze each possibility 3. Determine the most likely cause 4. Suggest a fix ```

1. Run BOTH commands in parallel:

Codex: ``bash codex exec --sandbox read-only -c modelreasoningeffort="xhigh" "<prompt>" ``

Gemini: ``bash gemini -s -y -o json "<prompt>" ``

1. Synthesize debugging insights

Response Format

## AI Council Debug Report

### Codex (GPT-5.2) Diagnosis:
**Potential Causes:**
1. [Cause with likelihood]
2. [Cause with likelihood]

**Root Cause Analysis:**
[Detailed analysis]

**Suggested Fix:**
[Code or steps to fix]

---

### Gemini Diagnosis:
**Potential Causes:**
1. [Cause with likelihood]
2. [Cause with likelihood]

**Root Cause Analysis:**
[Detailed analysis]

**Suggested Fix:**
[Code or steps to fix]

---

### Council Synthesis:
**Agreed Root Cause:** [If both agree]
**Conflicting Theories:** [If they differ]
**Recommended Fix:** [Synthesized fix strategy]
**Confidence Level:** [Based on agreement]

---
*Session IDs: Codex=[id], Gemini=[id]*