AI CodeOps

Agente Architect

El agente Architect planifica cambios, acota el riesgo, fusiona los hallazgos de revisión y decide el go/no-go. Se ejecuta en diez de los dieciséis flujos de trabajo integrados.

El agente Architect es el planificador de una sesión de AI CodeOps. Convierte una tarea en un enfoque concreto: los archivos y módulos que hay que cambiar, las decisiones clave y sus contrapartidas, y los riesgos. En los flujos de trabajo de revisión tiene un segundo trabajo: lee lo que encontraron los demás agentes y lo fusiona en una sola respuesta.

Es el agente más usado de la plataforma. Se ejecuta en diez de los dieciséis flujos de trabajo integrados, y en Architecture Debate se ejecuta tres veces.

Dónde se ejecuta

Flujo de trabajoPaso
Plan, Build, Review & TestPlan
Security-Sensitive ChangeScope change
Parallel ReviewMerge findings
Architecture DebateArchitect A, Architect B, Final synthesis
Threat ModelScope & data-flow
Swarm InspectionMerge summary
Feature SDLCTechnical design
Release ReadinessGo / no-go
Incident ResponseRoot cause
Performance TuningOptimization plan

Entradas

  • La tarea que escribiste al lanzar la sesión.
  • Una instantánea de solo lectura de los archivos relevantes del repositorio del proyecto, cuando el proyecto tiene uno.
  • La salida de los pasos anteriores de la misma sesión. Cuando se ejecuta primero, solo tiene la tarea y el código.
  • Herramientas de los servidores MCP que tu espacio de trabajo ha conectado, si la política de tu espacio de trabajo las permite.

Salidas

El Architect devuelve texto: un plan, un diseño, un resumen fusionado o una decisión, según el paso. Dos de ellos sobreviven a la sesión:

  • En Plan, Build, Review & Test y en Performance Tuning, su plan se sincroniza con el tablero Plan del espacio de trabajo como elementos del plan.
  • En Architecture Debate, su Final synthesis se guarda como un registro de decisión de arquitectura (ADR) propuesto. Nunca se acepta automáticamente. Una persona lo acepta o lo rechaza.

Cuando una sesión se ejecuta con los modelos de la plataforma y el nivel Auto, los pasos del Architect van primero al nivel Premium, porque su salida dirige todos los pasos posteriores. Consulta modelos y niveles.

Ejemplo de ejecución

Ejemplo ilustrativo, no una sesión registrada. Matt lanza Plan, Build, Review & Test con la tarea «Añade un límite de peticiones al endpoint público de inicio de sesión». El Architect lee las rutas de autenticación de la instantánea. Propone un limitador de ventana fija con clave por dirección IP y por cuenta, nombra el archivo de middleware que hay que añadir y los dos archivos de rutas que hay que tocar, y decide responder con HTTP 429 y una cabecera Retry-After. Señala un riesgo: la IP compartida de una oficina podría dejar fuera a todo un equipo. Después, el Builder, el Reviewer y el Tester trabajan a partir de ese plan, y los pasos del plan aparecen en el tablero Plan.

Límites

  • Razona a partir del código que se le muestra. No ejecuta el código, no mide su rendimiento ni lee datos de producción.
  • En Release Readiness, su go/no-go es un consejo. Lo que de verdad retiene un cambio es el control de publicación: las pruebas, la revisión de hallazgos y las aprobaciones.
  • En los flujos de trabajo largos, los pasos anteriores le llegan abreviados, así que las salidas muy largas pierden detalle.
  • Un plan es tan bueno como la tarea. Una tarea vaga produce un plan genérico.

Preguntas frecuentes

¿El agente Architect escribe código?

No. Escribe un plan o una decisión en texto. Los archivos los escribe la pasada de código de la sesión, que recibe el plan como parte de su entrada. Eso ocurre después del paso que implementa el cambio y antes de los pasos que lo comprueban.

¿Puedo cambiar cómo se comporta el agente Architect?

Sí. Crea un agente personalizado llamado Architect en la página Agents de tu espacio de trabajo para sustituir sus instrucciones o ejecutarlo con otro modelo.