zero in the loop

01 Sinopsis

Una fábrica de software que corre en tu máquina y convierte pedidos en cambios entregados.

Le pedís trabajo desde el chat de tu cliente de IA o desde la terminal. La fábrica lo especifica, lo construye, lo verifica, lo revisa y lo integra sola, en segundo plano, aunque cierres el chat.

Nunca pisa tu trabajo: cada pedido trabaja en su propia copia (git worktree) y su propia rama. Es open source (Apache-2.0) y gratuita. Cada uno tiene su propia fábrica: nadie se conecta a la tuya.

02 La línea de producción

Seis estaciones, cada una con contrato.

Cada estación recibe y entrega algo verificable. Si algo falla, el trabajo vuelve a build con la retroalimentación concreta.

1. spec

   Escribe los requisitos y escenarios WHEN/THEN como un change de OpenSpec. Solo lectura.

2. build

   Escribe el código y los tests en su propia copia y su propia rama.

3. verify

   Corre la verificación de la línea y detecta tests borrados o desactivados y rutas protegidas tocadas.

4. review

   Revisa el cambio; los hallazgos que citan archivos o líneas inexistentes se descartan. Solo lectura.

5. security

   Una segunda revisión, solo de seguridad, que puede usar otro motor. Solo lectura.

6. integrate

   Hace merge, deja una rama o abre un pull request, y lo funde solo si la línea lo pide.

Estado en SQLite, una traza por trabajo con su costo, y el townhall: la memoria colectiva de la fábrica.

03 Autonomía

Cuatro niveles. Vos elegís dónde entrás.

Por defecto la fábrica se configura en L3. L3 exige la caja de aislamiento lista; mientras falte algo, trabaja en L2 y dice exactamente qué falta. Las consultas nunca bloquean la fábrica: el trabajo queda esperando, los demás siguen, y si nadie responde a tiempo se aplica la acción por defecto.

Autonomía por línea

Cada línea decide hasta dónde llega sola una propuesta del turno nocturno:

propose

Por defecto. La propuesta espera tu decisión.

build

Se convierte sola en un trabajo, pasa por todas las estaciones y se detiene antes de integrar: nunca se integra sin tu aprobación.

auto

Se construye y se integra o despliega sola, según la línea, sin preguntar.

04 Turno nocturno

Cuando la fábrica está libre, busca trabajo.

scout

Estación de solo lectura que mira cada línea una vez por período: el townhall, las trazas, las specs sin tests, las notas de investigación y los issues abiertos sin etiqueta. Escribe hasta tres propuestas por línea; zero descarta las que tocan rutas protegidas, piden credenciales nuevas o repiten un título.

research

Investiga en la web una vez por día, solo en las líneas con una skill de investigación: skills, servidores MCP y tecnologías útiles. Cada nota trae sus fuentes. Lo que viene de la web es dato, nunca instrucciones.

• Tus pedidos van primero: un trabajo del turno nocturno nunca pasa delante de los tuyos.
• Tope diario de trabajos automáticos, sumando todas las líneas.
• Si revertís algo que el turno integró solo, la fábrica lo detecta y no lo vuelve a proponer.
• Lo que agrega dependencias, servidores MCP o código de terceros espera tu decisión aunque la línea esté en auto.

05 Garantías

zero aplica las garantías, no el motor.

• Rutas protegidas

  Las rutas protegidas no se tocan: si un trabajo las toca, se detecta y espera al dueño.

• Verificación

  Todo debe pasar la verificación de la línea antes de la revisión, y se detectan tests borrados o desactivados.

• Secretos fuera de los archivos

  Si la configuración de la fábrica trae algo con forma de credencial, zero se niega a cargarla. Las claves viven en el llavero del sistema y nunca van en la línea de comandos.

• Caja de aislamiento

  El setup, los agentes y la verificación corren en un contenedor (Podman o Docker) sin privilegios, con un clon propio, y salen a internet solo por la puerta de zero, que registra cada conexión.

• Solo lectura de verdad

  spec, review y security son de solo lectura: si un motor escribe, se descarta.

• Contratos validados

  Tiempo límite por estación, salidas estructuradas validadas y hallazgos con citas verificadas.

06 Instalación

Instalación y primeros pasos.

zero se instala desde el repositorio y necesita Node 22.

git clone https://github.com/kaelen-phoenix/zero
cd zero
npm install && npm run build
node dist/cli.js init
node dist/cli.js install
node dist/cli.js box setup

1. init

   Crea la definición de la fábrica y agrega el repo actual como línea.

2. install

   Registra zero en Claude Code y muestra cómo hacerlo en Codex y OpenCode.

3. box setup

   Prepara la caja de aislamiento; pide permiso antes de instalar nada.

Después, en tu chat: "zero, quiero que mi tienda calcule descuentos". O desde la terminal, con los comandos de abajo.

Instalador en un solo paso en camino

07 Flujo de trabajo

Desde la terminal o desde el chat.

1. zero request "…"

   Pide un trabajo; la fábrica se enciende sola si estaba apagada.

2. zero status [trabajo]

   Cómo va todo, o el detalle de un trabajo y la pregunta si te está esperando.

3. zero approve <trabajo>

   Aprueba lo que te espera, o lo rechaza con --reject --note.

4. zero proposals

   Las propuestas del turno nocturno, que se aprueban o rechazan con approve y reject.

5. zero trace <trabajo>

   Paso a paso: estaciones, intentos, agentes, comandos y costo.

6. zero briefing

   El informe: producción, costo, aprendizajes y lo que te necesita.

7. zero stop [trabajo]

   El andon: para un trabajo o toda la fábrica; zero resume la retoma.

En el chat son las mismas herramientas: zero_request, zero_status, zero_answer, zero_stop, zero_briefing, zero_trace…

08 Compatibilidad

Lo que soporta hoy.

Un motor distinto por estación si querés, y motores de reemplazo cuando uno se queda sin cupo.

09 Enlaces

Seguir leyendo.

• GitHub
• Documentación (README)
• Especificaciones (OpenSpec)
• Decisiones (ADR)
• Licencia Apache-2.0

Próximas etapas

• Instalador en camino
• Exportación de trazas por OTLP en camino
• Motores ACP/OpenCode en camino
• Pedidos desde Linear y Jira en camino
• Simulacro de regeneración desde las especificaciones en camino