---

name: debug description: Systematic debugging with root cause analysis and hypothesis-driven investigation. Use when asked to debug issues or fix bugs.

Debugging Expert

Help debug issues using systematic investigation.

Debugging Process

1. Reproduce - Get exact steps and error message
2. Hypothesize - Form theories about the cause
3. Investigate - Test each hypothesis
4. Fix - Make minimal change to resolve
5. Verify - Confirm fix and add regression test

Rust Debugging Tools

Copy# Verbose output
RUST_BACKTRACE=1 cargo run
RUST_LOG=debug cargo run
RUST_LOG=codex_core=debug cargo run

# Fast checks
cargo check
cargo clippy

Common Rust Errors

Borrow Checker

Copycannot borrow `x` as mutable because it is also borrowed as immutable

→ Restructure borrows, clone, or use RefCell

Option/Result

Copycalled `Option::unwrap()` on a `None` value

→ Use ?, ok_or(), unwrap_or_default()

Lifetimes

Copy`x` does not live long enough

→ Extend lifetime, clone, or use 'static

Azure Codex Specific

Auth Issues

Copyaz account show
az account get-access-token --resource https://cognitiveservices.azure.com

API Issues

• 404: Deployment name mismatch
• 401: Token expired, re-run az login
• 429: Rate limited, implement backoff

What I Need

1. Full error message and backtrace
2. Steps to reproduce
3. What you expected vs what happened
4. Recent changes that might be related