AI CodeOps

Decisión de arquitectura: dos diseños, un crítico y un ADR

Última actualización

Resuelve una cuestión de diseño con Architecture Debate: dos propuestas del Architect, una crítica del Reviewer y una síntesis final, guardadas como un ADR propuesto para una persona.

Usar esta plantilla

Usa esta plantilla cuando un equipo vuelve una y otra vez a la misma cuestión de diseño. Architecture Debate produce dos propuestas que compiten, una crítica de ambas y una decisión por escrito, antes de que nadie construya nada.

Qué agentes se ejecutan

PasoAgente
Architect AArchitect
Architect BArchitect
Critic reviewReviewer
Final synthesisArchitect

Los pasos se ejecutan uno tras otro, y cada uno ve lo que vino antes. El Architect B lee la primera propuesta, así que plantea la tarea como una elección real («una cola, o seguir con cron») y no como una sola idea que desarrollar. El crítico lee las dos propuestas, y la síntesis final sopesa las tres.

Qué obtienes

Cuando la sesión termina, la síntesis final queda guardada como un registro de decisión de arquitectura con el estado proposed (propuesto), vinculado a la sesión. Nada se acepta por palabra de la IA: una persona lo acepta o lo rechaza en Plan → ADRs.

Architecture Debate no cambia código. La sesión termina con sus documentos y el registro propuesto: no hay diff, ni ejecución de pruebas, ni aprobación para aplicar ninguno. Para guardar también la decisión en el repositorio, empieza una sesión de Plan, Build, Review & Test que la pida como archivo Markdown en docs/adr/. Ese cambio sigue el camino normal: tu comando de pruebas se ejecuta sobre él, la revisión con IA lee el diff y registra hallazgos, y alguien distinto de la persona que empezó la sesión lo aprueba antes de que se abra el pull request.

Limita lo que puede gastar un debate

Con el nivel de modelos Auto, el Architect cuenta como paso de dirección y recibe el mejor nivel para el que te queda cuota, y este flujo de trabajo lo ejecuta tres veces. En Configure → Billing, fija un presupuesto para el espacio de trabajo, elige después Edit limits y da a Architecture Debate su propio límite:

CampoValor de ejemplo
PeriodMonthly
Hard limit (USD)200
Per-workflow caps (USD)Architecture Debate: 15

El límite cubre todas las sesiones de Architecture Debate del periodo. En cuanto su gasto lo alcanza, la siguiente se rechaza y la que esté en ejecución se detiene con Blocked by budget. Consulta control de costos.

Consejos

  • Pon las restricciones en la tarea: el volumen de datos, quién lo ejecuta en producción, qué no debe cambiar.
  • Haz una sola pregunta por sesión. Dos preguntas reciben dos medias respuestas.
  • Si el resultado está reñido, envía un seguimiento con los puntos abiertos del crítico en lugar de empezar de nuevo.
  • Cuando la decisión se acepte, define el alcance del trabajo con la plantilla de especificación de funcionalidad.

Preguntas frecuentes

¿Los dos Architect trabajan a la vez?

No. El Architect B se ejecuta después del Architect A y lee su propuesta. Debate describe cómo los pasos se reparten el trabajo, no los tiempos.

¿El ADR se acepta automáticamente?

No. Se guarda como propuesto. Una persona lo pasa a aceptado o rechazado en Plan, ADRs.

¿La sesión cambiará el código de mi aplicación?

No. Architecture Debate solo escribe documentos. La sesión termina con el registro de decisión, sin diff y sin pull request.