Codev: Flujo de trabajo de agente de IA para 106 PR en 14 días

Codev es un sistema de coordinación de agentes de IA de código abierto que aplica un flujo de trabajo de desarrollo estructurado. El proyecto demuestra cómo llevar la IA desde la creación de prototipos hasta el trabajo de producción con prácticas específicas extraídas del manejo de 106 solicitudes de extracción en 14 días.

Seis prácticas fundamentales

• Las especificaciones y planes son código fuente: Las especificaciones y planes residen en git junto con el código fuente, no en el historial de chat. Un nuevo agente lee arch.md para la visión general, luego su especificación específica. Esto garantiza que siempre sepas por qué se construyó algo.
• Tres modelos revisan cada fase: Claude, Gemini y Codex detectan errores casi completamente diferentes. Ningún modelo individual encontró más del 55% de los problemas. En las pruebas, se detectaron 20 errores antes del envío: Claude Code encontró 5 errores, mientras que Gemini y Codex detectaron otros 15, incluido un grave problema de seguridad que Claude pasó por alto.
• Aplica el proceso, no lo sugieras: Una máquina de estados fuerza la secuencia Especificación → Planificación → Implementación → Revisión → PR. La IA no puede saltarse pasos, y las pruebas deben aprobarse antes de avanzar. El sistema proporciona rieles porque las IA no se apegan al plan por sí mismas.
• Anota, no edites: La mayor parte del trabajo implica escribir especificaciones y revisiones que guían el código, en lugar de modificar archivos en un chat abierto.
• Los agentes coordinan agentes: Un agente arquitecto genera agentes constructores en espacios de trabajo git aislados. Tú diriges al arquitecto; él dirige a los constructores. Se envían mensajes entre sí de forma asíncrona.
• Gestiona todo el ciclo de vida: La mayoría de las herramientas de IA ayudan a escribir código más rápido (aproximadamente el 30% del trabajo). El otro 70% implica planificación, revisión, integración, scripts de implementación y gestión de entornos de pruebas frente a producción. Codev hace que la IA ejecute toda la canalización desde la especificación hasta la PR y más allá.

Resultados y costos

El sistema permitió que un ingeniero produjera lo que normalmente haría un equipo de 3-4 personas. La calidad del código se midió 1.2 puntos mejor en una escala de 10 puntos en comparación con usar solo Claude Code. El enfoque lleva más tiempo y utiliza más tokens, pero los costos siguen siendo razonables, aproximadamente $1.60 por PR.

Según el desarrollador, la aplicación del protocolo es el cambio radical: "Descubrí que la IA simplemente no se apegaría a las especificaciones o planes". La coordinación de agentes también resultó efectiva, con el agente arquitecto gestionando múltiples agentes constructores corrigiendo diferentes errores simultáneamente.