manager-resolve-escalation
Resuelve un bloqueo o una escalacion del Builder con una decision documentada, clasificando el bloqueo y comparando opciones con sus trade-offs. Usar cuando el Builder queda BLOCKED dentro del ticket.
SKILL.mdskills/manager-resolve-escalation/SKILL.md
GitHubmanager-resolve-escalation
Skill para resolver bloqueos técnicos o decisiones arquitectónicas escaladas por el Builder.
Overview
Cuando el Builder está 🟠 BLOCKED, el Manager usa esta skill para:
- Leer y entender la escalación
- Clasificar tipo de bloqueo
- Analizar opciones con trade-offs
- Tomar decisión documentada
- Comunicar resolución
Workflow
Paso 0: Verificar Turno
python .agent/agent_controller.py
Debe indicar ROL ACTIVO: MANAGER y acción RESOLVE_BLOCK.
Paso 1: Leer Contexto Completo
Leer en orden:
review_queue.md- Escalación del Builderexecution_log.md- Contexto del problemawork_plan.md- Plan original y criteriosreferences/escalation-levels.md- Guía de niveles
Paso 2: Clasificar Tipo de Bloqueo
| Tipo | Descripción | Ejemplo |
|---|---|---|
| Técnico | Error técnico o bug | "No puedo hacer que funcione la conexión" |
| Diseño | Decisión arquitectónica | "¿Usar clase o funciones?" |
| Dependencia | Bloqueo externo | "Esperando API del proveedor" |
| Permisos | Acceso requerido | "Necesito credenciales de BD" |
| Requisito | Ambigüedad en requisito | "No está claro qué debe hacer" |
Paso 3: Analizar Opciones
Para cada opción presentada por el Builder (o identificadas):
| Opción | Pros | Contras | Riesgo |
|--------|------|---------|--------|
| A | [+] | [-] | 🟢/🟡/🔴 |
| B | [+] | [-] | 🟢/🟡/🔴 |
Criterios de decisión:
- Simplicidad (KISS)
- Mantenibilidad a largo plazo
- Tiempo de implementación
- Riesgo de introducir bugs
Paso 4: Tomar Decisión
Decisión debe ser:
- Clara y específica
- Accionable (el Builder sabe qué hacer)
- Documentada con razonamiento
NO dejar ambigüedades.
Paso 5: Documentar en review_queue.md
### 🚨 ESC-[ID]: [Título Corto] - RESUELTO
- **Plan ID:** WOT-XXX
- **Tipo:** ESCALATION
- **Urgencia:** 🔴/🟡/🟢 [Alta/Media/Baja]
- **Estado:** ✅ RESOLVED
- **Fecha resolución:** [YYYY-MM-DD HH:MM]
**Problema:**
[Resumen del bloqueo]
**Opciones analizadas:**
1. [Opción A] - Pros/Contras
2. [Opción B] - Pros/Contras
**Decisión:** [Opción elegida]
**Razonamiento:**
[Por qué se eligió esta opción]
**Próximo paso para Builder:**
[Instrucción específica y clara]
Paso 6: Notificar al Builder
## 📨 [FECHA] Escalación Resuelta: Manager → Builder
**Plan:** WOT-XXX
**Escalación:** ESC-[ID]
**Decisión:** [Resumen en 1 línea]
**Acción requerida:** Ver review_queue.md y continuar implementación
**Estado:** PENDING
Paso 7: Actualizar Estados
En execution_log.md:
- Cambiar estado de
🟠 BLOCKEDa🔵 IN_PROGRESS - Añadir nota de resolución
Criterios para Escalar (Guía para Builder)
El Builder debe escalar cuando:
- 3+ intentos fallidos para tarea 🟢
- 2+ intentos fallidos para tarea 🟡
- 1 intento fallido para tarea 🔴
- 30+ minutos bloqueado sin progreso
- Decisión de arquitectura requerida
- Bug en librería externa
- Incertidumbre entre opciones equivalentes
Anti-Patrones (NO hacer)
- NO dejar al Builder adivinar
- NO dar respuestas vagas ("intenta otra cosa")
- NO cambiar requisitos sin documentar
- NO ignorar la escalación
Output Format
Resolución Completa
- Entrada en
review_queue.mdcon decisión clara - Notificación en
notifications.md - Actualización de
execution_log.md
References
references/escalation-levels.md- Guía de niveles de urgencia.agent/protocols/escalation_protocol.md- Protocolo completo.agent/rules/manager/- Restricciones del rol
Constraints
- SIEMPRE dar decisión específica, no opciones múltiples
- SIEMPRE explicar razonamiento
- NO cambiar scope del plan sin documentar
- NO asignar nuevas tareas sin actualizar work_plan.md