agents-config
La configuración detrás de mi forma de trabajar con agentes de IA para programar: una sola fuente que se aplica a cuatro herramientas de línea de comandos, con los skills, los hooks y las revisiones que mantienen el control cuando varios agentes construyen a la vez.
Repositorio privado
01Qué es
Un único repositorio contiene todo lo que les indico a los agentes de IA: instrucciones, skills, reglas, definiciones de subagentes y scripts de hooks. Un script de instalación escrito en Node.js genera, a partir de esa única fuente, la configuración de cuatro herramientas: Claude Code, Codex, Cursor y Antigravity. Cambio una regla una vez y cada herramienta lee el resultado. Tiene 60 skills y 308 commits desde el 25 de mayo de 2026.
02Cómo avanza una funcionalidad
Describo una funcionalidad a una sesión orquestadora. Primero resuelve conmigo las decisiones abiertas, redacta una especificación con criterios de aceptación y la divide en tramos. Cada tramo va a un agente constructor en su propio worktree de git, de modo que varios pueden construir a la vez sin tocar los archivos de los demás. En una funcionalidad reciente eso significó 18 decisiones resueltas antes de escribir código, una especificación con 25 criterios de aceptación, 14 tramos y hasta cinco agentes trabajando al mismo tiempo.
03Quién revisa el trabajo
Un constructor solo construye: compila, ejecuta las pruebas y escribe una nota de traspaso con lo que hay que comprobar en un navegador. Nunca revisa su propio trabajo. Después, una puerta de control examina la rama en un contexto nuevo, con agentes revisores que no escribieron el código, una segunda revisión de un modelo de otro proveedor, entre ellos Codex, y comprobaciones automatizadas. Una comprobación que no pudo ejecutarse cuenta como fallo, nunca como aprobada.
04Dónde sigo en el circuito
Unos scripts de hooks bloquean los comandos de git destructivos, mantienen a un constructor dentro de su tramo e impiden que un agente elija un modelo más caro de lo que permite su rol. La fusión y el despliegue siguen siendo míos, y un push necesita mi permiso explícito, concedido ejecución por ejecución. Cada cambio en el flujo de trabajo empieza como una nota fechada en una carpeta de investigación, con la pregunta, el método y lo que no se pudo confirmar.
“If you haven’t seen it run, it’s not a working system.”
Traducción«Si no lo ha visto funcionar, no es un sistema que funcione.»
Decidir qué construir y mirar la pantalla real siguió siendo tarea mía.
Cómo está construido
- Una solicitud de funcionalidad, planificada y repartida
- Un tramo terminado, revisado
- Una rama comprobada, entregada a mí
- Configuración aplicada a las herramientas
- Acciones comprobadas antes de ejecutarse
Usted
Decide y aprueba
Orquestador
Planifica el trabajo
Constructores
Escriben el código
Control
Comprueba el resultado
Configuración
Una fuente, cuatro herramientas
Seleccione una parte del diagrama para ver qué hace. Cada color es un flujo a través del sistema.