CommitCycle CLI Shipped
El gate, el grant y el cierre, desde tu terminal
Un comando lleva una task de una frase a una rama con acceso adjunto, y otro la saca de vuelta con un registro. Lo de en medio es trabajo normal, hecho por el agente que prefieras.
Instalación
npm i -g commitcycleEl paquete es commitcycle y el comando es cycle. Esa separación es deliberada: en cualquier máquina Unix cc ya es el compilador de C del sistema, así que un cc global rompería node-gyp y cualquier Makefile que nunca sobrescribiera $(CC). Una herramienta de gobierno que ensombrece un compilador es una que la gente desinstala.
El bucle diario
cycle start "la cosa" \
--goal "…" --non-goals "…" --criteria "…" \
--topics backend,frontend # intake → scope → rama → gate → grant → contexto
# ... trabajo ...
cycle submit # In Progress → In Review, zones cerradas
cycle verify --close --evidence <url> # el manifest, los checks, el registroLos cuatro campos no son adorno en esa primera línea: el gate rechaza una task que no los trae y la deja en Todo, así que un start escrito sin ellos se detiene antes de abrir nada.
cycle start es la única vía de entrada a In Progress. No hay comando que abra una zone por su cuenta, y ése es justo el punto: en cuanto existe una segunda vía, es la que todo el mundo usa con prisa.
Qué sabe hacer
| Comando | Qué hace |
|---|---|
init | Prepara el repositorio — propone zones a partir del código, escribe el mapa y el contexto del agente |
start | Intake, scope, rama, gate, grant y contexto, en una sola llamada |
status | Qué task está activa, y exactamente qué tiene abierto ahora mismo |
sync | Envía el mapa de zones y los eventos, trae el grant de esta rama |
request-access | Pide al owner de una zone que la abra — con un motivo y una alternativa |
approve · deny | Responde a la petición de otra persona sin salir de la terminal |
submit · pause | Entrega el trabajo, o déjalo sin abandonarlo |
verify --close | Contrasta la rama con lo que declaró la task, y escribe el registro |
seed · challenge | Redacta playbooks desde el código, y después discútelos |
doctor | ¿Por qué se está comportando así CommitCycle? |
Unos treinta en total. La lista completa, flag por flag, está enla referencia de la CLI (en inglés).
Dónde se detiene
- No ejecuta tus agentes. CommitCycle registra, pone el gate y deja constancia; quien escribe el código es lo que ya uses.
- No puede cerrar una task por ti.
verify --closecomprueba y registra; si falta la evidencia que nombra el quality gate, se niega y dice cuál. - El enforcement no vive en la CLI. Bloquear una escritura mientras ocurre es cosa del hook, y el hook llega con el plugin del editor. La CLI es el flujo; el plugin es el muro.
- discard y promote aún no existen. Son de la fase 2, y lo dicen en lugar de fallar de forma rara.
La referencia de comandos está en la documentación (en inglés), y el modelo sobre el que actúa es el mapa de zones.