Saltar a contenido

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.