Planes
Esta sección explica, uno por uno, los planes que trae NEO: qué intención tiene cada uno, cuándo se ejecuta, qué necesita recibir y qué deja al terminar. Está pensada para que cualquier persona del equipo entienda qué va a hacer el pipeline antes de que lo haga, y pueda verificar después que hizo lo que decía.
En resumen
- Qué es un plan: un flujo de trabajo de QA ya escrito (qué skills se ejecutan, en qué orden y cuándo se corta), que ejecuta el engine de
NEO, sin un asistente de IA abierto y sin nadie conversando. - En qué se diferencia de un playbook: el playbook lo sigue el asistente de IA (por ejemplo, Claude) junto a una persona, con pausas para que decida; el plan lo ejecuta el engine de punta a punta, normalmente disparado por el CI.
- Para qué sirve esta sección: para entender la intención de cada plan. El formato técnico del archivo YAML está en Anatomía de un plan.
1. ¿Qué es un plan?
Un plan es una receta que ejecuta una máquina en lugar de una persona. Igual que un playbook, encadena varias skills en un orden fijo para resolver una situación completa (una funcionalidad nueva, un hotfix, un bug). La diferencia está en quién la ejecuta:
- Un playbook lo ejecuta el asistente de IA (Claude, Codex, Copilot) paso a paso, mientras una persona lo acompaña, responde preguntas y aprueba en las pausas.
- Un plan lo ejecuta el engine (el programa
neo), solo, de principio a fin. Nadie le contesta preguntas en el medio: todo lo que necesita lo recibe al arrancar, y las decisiones de "seguir o cortar" ya están escritas en el plan.
Por eso los planes son la pieza que permite que el QA se ejecute solo en un pipeline: se abre un MR con un label, se hace un push a una rama hotfix/*, y el plan correspondiente arranca sin que nadie tenga que pedírselo al asistente.
¿Dónde aparece la IA, entonces?
Adentro de cada paso. Cada skill sigue usando un modelo de IA para hacer su trabajo (leer una historia, armar un plan de pruebas, reparar un test). Lo que no decide la IA es el flujo: qué paso viene después, cuándo se saltea uno o cuándo se corta todo. Eso lo decide el código del engine, siempre igual. Por eso dos ejecuciones del mismo plan siguen el mismo camino.
2. Plan vs. playbook, lado a lado
| Playbook | Plan | |
|---|---|---|
| ¿Quién lo ejecuta? | El asistente de IA (por ejemplo, Claude), conversando con una persona | El engine de NEO (neo run), solo |
| ¿Qué es, físicamente? | Un documento con instrucciones (.md) |
Un archivo de configuración (.yaml) |
| ¿Cómo arranca? | Una persona se lo pide al asistente | Una regla del CI (Modelo 4) o un pedido en texto libre que el engine clasifica (Modelo 2) |
| ¿Tiene pausas para que decida una persona? | Sí, los checkpoints humanos | No: las condiciones de corte ya están escritas en el plan |
| ¿Puede improvisar si algo no encaja? | El asistente puede adaptarse y preguntarte | No: si falta un dato o algo no cumple, el plan se corta y lo deja registrado |
| Modelo de orquestación | Modelo 3 — Human-in-the-loop | Modelo 4 — Declarativo puro, o Modelo 2 — Híbrido adaptativo |
| Ideal para | Trabajo interactivo, casos con criterio humano | Pipelines de CI que tienen que reaccionar solos ante un evento |
En resumen: si hay una persona conversando con el asistente, usás un playbook. Si no hay nadie (un pipeline, un script), lo que se ejecuta es un plan.
Muchos planes son la versión automática de un playbook: hacen el mismo trabajo, pero sin pausas y con las decisiones ya tomadas. Cada página de esta sección explica en qué se parece y en qué se diferencia de su playbook. Para entender los modelos en detalle, mirá Los 4 modelos de orquestación y Modelos de orquestación en el engine.
3. ¿Cómo se lee la página de un plan?
Todas las páginas de esta sección tienen la misma estructura:
| Sección | Qué te responde |
|---|---|
| ¿Qué hace este plan? | Su intención: qué problema resuelve y qué deja al terminar |
| ¿Cuándo se ejecuta? | Qué evento lo dispara y con qué modelo de orquestación |
| Diferencias con el playbook | Qué cambia respecto de hacer lo mismo con el asistente |
| Ejemplo guía | El caso de TechStore, la tienda online que se usa en todo el manual: qué recibe el plan, qué pasa en cada paso y cómo termina |
| Problemas comunes | Qué hacer cuando el resultado no es el esperado |
| Resumen visual | El flujo completo en un diagrama |
4. Índice de planes
| Plan | Cuándo se ejecuta | Playbook relacionado |
|---|---|---|
| Feature - New End-to-End | Se abre un MR con el label feature: hay que probar desde cero una funcionalidad nueva |
Feature - New End-to-End |
| QA Bug Coverage | Un bug pasa a QA: confirmar que se reproduce y dejar un test que lo capture | Bug Fix Cycle (primera mitad) |
| QA Bug Fix Verification | El developer aplicó el fix de ese bug: verificar que los tests ahora pasan | Bug Fix Cycle (segunda mitad) |
| UI Selector Repair | Un PR de frontend cambió selectores: reparar los tests afectados antes del deploy | Frontend UI Change PR |
Dónde están los planes
Los archivos de los planes viven en la carpeta plans/ del repositorio del engine, crowdar-engine-mvp. Si querés escribir un plan propio o modificar uno, empezá por Anatomía de un plan y Patrones de composición.