AI CodeOps

Monorepo: refactorización multiagente con gasto limitado

Última actualización

Refactoriza un paquete de un monorepo con Plan, Build, Review & Test, con un presupuesto de espacio de trabajo y un límite por flujo de trabajo, y pruebas limitadas al paquete que cambia.

Usar esta plantilla

Las refactorizaciones en un monorepo salen mal de dos formas: el cambio se extiende por varios paquetes, y la factura se extiende con él. Esta plantilla dirige el flujo de trabajo por defecto a un solo paquete y pone un techo a las dos cosas.

Qué agentes se ejecutan

Plan, Build, Review & Test es el flujo de trabajo por defecto:

  1. Plan, a cargo del Architect: los archivos que hay que cambiar, el orden y los riesgos, como el código que depende de los tiempos de reintento actuales.
  2. Build, a cargo del Builder: las ediciones exactas, archivo por archivo.
  3. Review, a cargo del Reviewer: los casos límite y los cambios de comportamiento en el diff escrito.
  4. Test, a cargo del Tester: los casos que demuestran que el comportamiento no se movió, comprobados contra la ejecución de pruebas registrada.

Después de Build, la pasada de código escribe el diff y tus pruebas se ejecutan sobre él. Review y Test vienen después, así que leen el cambio y su resultado de pruebas, no un plan. Luego, la revisión de hallazgos de la IA lee el diff. Los hallazgos abiertos de gravedad alta o crítica y las pruebas fallidas bloquean el pull request, y lo aprueba una persona distinta de la que empezó la sesión, cuando el espacio de trabajo tiene otro aprobador.

Limítala a un solo paquete

Los agentes leen una instantánea seleccionada del repositorio, no el árbol completo, y un cambio puede tocar como máximo 25 archivos. Nombra el paquete y sus fronteras en la tarea. En el proyecto, configura el comando de pruebas para que el paso verify ejecute las pruebas que importan:

Campo del proyectoValor de ejemplo
Test commandpnpm --filter @acme/billing test
Default branchmain

El comando se ejecuta en un sandbox aislado, sin red después de instalar las dependencias, con un límite de dos minutos por comando. Si no puede ejecutarse, el paso registra una omisión con el motivo, nunca una superación.

Limita el gasto

En Configure → Billing, elige Configure budget, guárdalo y después elige Edit limits:

CampoValor de ejemplo
PeriodMonthly
Soft limit (USD)150
Hard limit (USD)200
Per-workflow caps (USD)Plan, Build, Review & Test: 40

El límite flexible no detiene las sesiones: una vez superado, al iniciar una se muestra un aviso con el gasto del periodo, y el hecho de superarlo queda registrado. El límite estricto y el límite por flujo de trabajo detienen las sesiones. El límite por flujo de trabajo cuenta todas las sesiones de ese flujo de trabajo en el periodo, no una sola sesión, así que dimensiónalo para las refactorizaciones que esperas este mes.

Divide las refactorizaciones grandes

Si el plan nombra más de 25 archivos, fusiona la primera parte y después empieza una sesión de seguimiento para el siguiente paquete. Una sesión de seguimiento recibe la tarea y el resumen de su padre como contexto. La plantilla de funcionalidad full-stack cubre el caso contrario: una funcionalidad que atraviesa varias capas.

Preguntas frecuentes

¿Qué pasa cuando se alcanza el límite a mitad de la sesión?

El presupuesto se comprueba antes de cada llamada al modelo. La sesión se detiene con Stopped over budget y muestra Blocked by budget.

¿Puedo limitar cada agente por separado?

No. Los presupuestos son por espacio de trabajo y por flujo de trabajo. La página de la sesión muestra el costo de cada paso, así que puedes ver adónde fue el dinero.