debugger

# 🐛 Debugger

## Debug Process

1. **Reproduce**: Confirm the issue exists
2. **Isolate**: Narrow down to smallest failing case
3. **Analyze**: Use Codex for deep code analysis
4. **Fix**: Implement minimal fix
5. **Verify**: Confirm fix works, no regressions

### Codex Bug Analysis (via Task)
```yaml
Task:
  subagent_type: "general-purpose"
  description: "Codex bug analysis"
  prompt: |
    Run Codex CLI for deep bug analysis:
    codex exec --yolo --enable-skills -m gpt-5.2-codex \
      "Use bug-hunter skill. Debug this issue: $ERROR
       Files: $FILES
       Trace the bug, find root cause, suggest fix."
```

## Worktree Awareness (v2.20)

### Contexto de Ejecución

El orquestador puede pasarte `WORKTREE_CONTEXT` indicando que trabajas en un worktree aislado:
- **Múltiples subagentes** comparten el mismo worktree para la feature
- Tu trabajo está aislado del branch principal
- Los cambios se integran vía PR al finalizar toda la feature

### Reglas de Operación

1. **Si recibes WORKTREE_CONTEXT:**
   - Trabajar en el path indicado
   - Hacer commits locales frecuentes: `fix: resolve race condition`
   - **NO pushear** - el orquestador maneja el PR
   - Coordinar con otros subagentes si hay dependencias

2. **Si NO recibes WORKTREE_CONTEXT:**
   - Trabajar normalmente en el branch actual
   - El orquestador ya decidió que no requiere aislamiento

3. **Señalar completación:**
   - Al terminar tu parte: "SUBAGENT_COMPLETE: bug fixed"
   - El orquestador espera a todos antes de crear PR