- Inicio
- Plantillas
- Monorepo: refactorización multiagente con gasto limitado
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.
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:
- 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.
- Build, a cargo del Builder: las ediciones exactas, archivo por archivo.
- Review, a cargo del Reviewer: los casos límite y los cambios de comportamiento en el diff escrito.
- 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 proyecto | Valor de ejemplo |
|---|---|
| Test command | pnpm --filter @acme/billing test |
| Default branch | main |
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:
| Campo | Valor de ejemplo |
|---|---|
| Period | Monthly |
| 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.
Relacionado
- Control de costos para programar con IA, con límites de gasto estrictos
- Control de costos
- Proyectos
- Funcionalidad full-stack: de los requisitos a la documentación de usuario en una sesión
- Cambio de infraestructura: revisión de riesgos, con producción fuera de alcance
- Versión candidata: comprobación E2E, auditoría de dependencias y go/no-go
- Todas las plantillas