AI CodeOps

Especificación de funcionalidad: requisitos y un plan de entrega por fases

Última actualización

Convierte una petición de una línea en criterios de aceptación y un plan por fases con Discovery & Spec: un Researcher, un Product Analyst y un Project Planner.

Usar esta plantilla

Empieza aquí cuando una funcionalidad todavía es una frase en un ticket. Discovery & Spec la convierte en requisitos que alguien puede comprobar y en un plan que alguien puede programar, antes de escribir ningún código de la aplicación.

Qué agentes se ejecutan

  1. Prior art. El Researcher estudia el código, las bibliotecas y las referencias que afectan a la funcionalidad. Para una exportación de facturas, eso significa dónde se consultan hoy las facturas y qué serializadores usa ya el servicio.
  2. Requirements. El Product Analyst escribe los requisitos con criterios de aceptación y límites de alcance.
  3. Delivery plan. El Project Planner divide el trabajo en fases, con dependencias, hitos y estimaciones de esfuerzo.

Cada paso lee lo que escribieron los anteriores.

Qué obtienes

  • Un ADR propuesto. Los requisitos acordados se guardan en Plan → ADRs como propuestos, para que una persona los acepte o los rechace.
  • Elementos del tablero Plan. Los elementos de la lista del paso Delivery plan se convierten en entradas del tablero, cada una vinculada a la sesión que la propuso.
  • Ningún cambio de código. Discovery & Spec solo escribe documentos, así que la sesión termina sin diff y sin aprobación para aplicar uno. Para guardar la especificación en el repositorio, empieza una sesión de Plan, Build, Review & Test que la pida como archivo en docs/specs/. Ese cambio pasa por tu comando de pruebas, la revisión de hallazgos de la IA y una aprobación humana como cualquier otro, así que la especificación se discute en un pull request, donde el equipo ya comenta.

Da a los agentes los datos que no pueden deducir del código: quiénes son los usuarios, los volúmenes esperados y qué queda explícitamente fuera del alcance.

Deja que los agentes lean los tickets, no que los escriban

Si tu gestor de incidencias está conectado como un servidor MCP remoto llamado «Tracker» (ID tracker), estas reglas de política mantienen sus herramientas de escritura lejos de todas las sesiones, mientras sus herramientas de lectura siguen disponibles:

[
  { "id": "tracker-no-create", "action": "mcp.invoke", "resource": "tracker/create_*", "decision": "deny" },
  { "id": "tracker-no-update", "action": "mcp.invoke", "resource": "tracker/update_*", "decision": "deny" }
]

Las reglas mcp.invoke admiten allow o deny, nunca ask, y una herramienta denegada nunca se ofrece a los agentes. Los nombres de las herramientas dependen del servidor que conectes, así que ajusta los patrones a sus nombres reales. Prueba primero las reglas en modo log-only para ver qué bloquearían.

Lo que viene después

Acepta o rechaza el ADR, pasa por triaje los elementos del tablero y después desarrolla la primera fase con la plantilla de funcionalidad full-stack o con una sesión más pequeña de Plan, Build, Review & Test por fase.

Preguntas frecuentes

¿El plan llega al tablero Plan?

Sí. Cuando la sesión termina, los elementos de la lista del paso Delivery plan se convierten en entradas del tablero Plan, hasta 50 cada vez, y se omiten los títulos que ya están en el tablero.

¿Puede el Researcher leer nuestro gestor de incidencias?

Solo a través de un servidor MCP remoto que conectes, y solo las herramientas que deje pasar la política de tu espacio de trabajo.