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
2. •

   Formulate a debugging prompt:

   code

   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
   

3. •

   Run BOTH commands in parallel:

   Codex:

   bash

   codex exec --sandbox read-only -c model_reasoning_effort="xhigh" "<prompt>"
   

   Gemini:

   bash

   gemini -s -y -o json "<prompt>"
   

4. •

   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]*