Superpowers — Desarrollo estructurado con sub-agentes
Adaptado de obra/superpowers para OpenClaw.
Cuándo activar
Cuando Chema o Luis pidan una feature nueva, refactor grande, o cambio multi-archivo en cualquier proyecto (Elicita, FlightCBT, etc.). NO para fixes de una línea o cambios cosméticos.
El flujo
1. BRAINSTORM → 2. PLAN → 3. EXECUTE → 4. REVIEW → 5. SHIP
1. BRAINSTORM (obligatorio)
HARD GATE: NO escribir código hasta tener diseño aprobado.
Incluso si parece simple. "Simple" es donde las asunciones matan.
Pasos:
- Explorar contexto — leer archivos relevantes, commits recientes, estado actual
- Preguntar — UNA pregunta a la vez, preferir opciones múltiples
- Proponer 2-3 enfoques — con trade-offs y tu recomendación
- Presentar diseño — en secciones digeribles, esperar OK antes de avanzar
- Guardar diseño —
docs/plans/YYYY-MM-DD--design.md
Qué cubrir:
- Arquitectura / componentes afectados
- Flujo de datos
- Manejo de errores
- Cómo se testea
- Impacto en lo existente
2. PLAN
Después del diseño aprobado, escribir plan de implementación.
Reglas del plan:
- Guardar en
docs/plans/YYYY-MM-DD--plan.md - Cada tarea = 2-5 minutos de trabajo
- Paths exactos de archivos a crear/modificar
- Código completo en el plan (no "añadir validación")
- Comandos exactos con output esperado
- DRY, YAGNI, commits frecuentes
Estructura de tarea:
### Tarea N: [Nombre]
**Archivos:**
- Crear: `ruta/exacta/archivo.ts`
- Modificar: `ruta/exacta/existente.ts`
- Test: `tests/ruta/test.ts`
**Paso 1:** Escribir test que falle
[código completo del test]
**Paso 2:** Verificar que falla
Ejecutar: `npm test -- --grep "nombre"`
Esperado: FAIL
**Paso 3:** Implementación mínima
[código completo]
**Paso 4:** Verificar que pasa
Ejecutar: `npm test -- --grep "nombre"`
Esperado: PASS
**Paso 5:** Commit
`git add ... && git commit -m "feat: descripción"`
Al terminar el plan, preguntar:
> "Plan guardado en docs/plans/.... ¿Ejecuto con sub-agentes o prefieres revisarlo primero?"
3. EXECUTE — Sub-agente por tarea
Un sessions_spawn por tarea del plan. Sub-agente fresco = sin contaminación de contexto.
Prompt del sub-agente implementador:
Eres un implementador. Tu ÚNICA tarea es ejecutar exactamente lo que dice el plan.
REGLAS:
- Sigue el plan al pie de la letra
- Si algo no está claro, PARA y pregunta (no improvises)
- Test primero, implementación después
- Commit al terminar
- NO hagas nada que no esté en el plan
TAREA:
[texto completo de la tarea del plan]
CONTEXTO DEL PROYECTO:
[archivos relevantes, stack, convenciones]
Después de cada tarea — doble review:
Review 1: Spec compliance (¿hace lo que dice el plan?)
- ¿Se crearon/modificaron los archivos correctos?
- ¿Los tests pasan?
- ¿Se añadió algo que NO estaba en el plan? → revertir
- ¿Falta algo del plan? → completar
Review 2: Calidad (¿está bien hecho?)
- ¿El código es limpio?
- ¿Los tests cubren edge cases?
- ¿Hay code smells?
Si falla un review:
- Lanzar nuevo sub-agente con el feedback específico
- Re-review hasta que pase ambos
4. REVIEW FINAL
Después de todas las tareas:
- Verificar que el build pasa
- Screenshot de verificación (si hay UI)
- Review completo del diff total
- Documentar en daily notes
5. SHIP
git push- Restart PM2 si aplica
- Notificar a Chema con resumen
Principios
- YAGNI — No construir lo que no se ha pedido
- DRY — No repetir código ni lógica
- TDD — Test primero, siempre
- Fresh context — Sub-agente nuevo por tarea
- Evidence over claims — Verificar antes de declarar victoria
- El plan es ley — Si hay que desviarse, parar y re-planificar
Para Elicita específicamente
- CERO datos demo/ficticios — regla absoluta
- Build + PM2 restart + screenshot después de cada tarea con UI
- Modelo sub-agentes: anthropic/claude-sonnet-4-6
- Si algo rompe el build:
git checkout y documentar