- Inicio
- Plantillas
- Decisión de arquitectura: dos diseños, un crítico y un ADR
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.
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
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:
| Campo | Valor de ejemplo |
|---|---|
| Period | Monthly |
| 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.
Relacionado
- Planificación con IA que fija el enfoque antes de escribir código
- Flujos de trabajo
- Control de costos
- Especificación de funcionalidad: requisitos y un plan de entrega por fases
- Plantilla de política de programación con IA para equipos de ingeniería
- Funcionalidad full-stack: de los requisitos a la documentación de usuario en una sesión
- Todas las plantillas