CommitCycle CLI Shipped
O gate, o grant e o fechamento, do seu terminal
Um comando leva uma task de uma frase até um branch com acesso anexado, e outro a traz de volta com um registro. O que fica no meio é trabalho comum, feito pelo agente que você preferir.
Instalação
npm i -g commitcycleO pacote é commitcycle e o comando é cycle. Essa separação é deliberada: em qualquer máquina Unix cc já é o compilador C do sistema, então um ccglobal quebraria o node-gyp e todo Makefile que nunca sobrescreveu $(CC). Uma ferramenta de governança que ofusca um compilador é uma que as pessoas desinstalam.
O ciclo diário
cycle start "a coisa" \
--goal "…" --non-goals "…" --criteria "…" \
--topics backend,frontend # intake → scope → branch → gate → grant → contexto
# ... trabalho ...
cycle submit # In Progress → In Review, zones fechadas
cycle verify --close --evidence <url> # o manifest, os checks, o registroOs quatro campos não são enfeite naquela primeira linha: o gate recusa uma task sem eles e a deixa em Todo, então um start escrito sem eles para antes de abrir qualquer coisa.
cycle start é a única porta para In Progress. Não existe comando que abra uma zone por conta própria, e é justamente esse o ponto: assim que existe uma segunda porta, é ela que todo mundo usa com pressa.
O que ele sabe fazer
| Comando | O que faz |
|---|---|
init | Prepara o repositório — propõe zones a partir do código, escreve o mapa e o contexto do agente |
start | Intake, scope, branch, gate, grant e contexto, numa única chamada |
status | Qual task está ativa, e exatamente o que está aberto para ela agora |
sync | Envia o mapa de zones e os eventos, traz o grant deste branch |
request-access | Pede ao owner de uma zone que a abra — com um motivo e uma alternativa |
approve · deny | Responde ao pedido de outra pessoa sem sair do terminal |
submit · pause | Entrega o trabalho, ou o deixa de lado sem abandoná-lo |
verify --close | Confere o branch contra o que a task declarou, e escreve o registro |
seed · challenge | Redige playbooks a partir do código, e depois discute com eles |
doctor | Por que o CommitCycle está se comportando assim? |
Cerca de trinta no total. A lista completa, flag a flag, está nareferência da CLI (em inglês).
Onde ele para
- Não executa seus agentes. O CommitCycle registra, coloca o gate e deixa o rastro; quem escreve o código é o que você já usa.
- Não fecha uma task por você.
verify --closeconfere e registra; se faltar a evidência que o quality gate nomeia, ele recusa e diz qual. - O enforcement não mora na CLI. Bloquear uma escrita enquanto ela acontece é trabalho do hook, e o hook chega com o plugin do editor. A CLI é o fluxo; o plugin é o muro.
- discard e promote ainda não existem. São da fase 2, e dizem isso em vez de falhar de um jeito estranho.
A referência de comandos está na documentação (em inglês), e o modelo sobre o qual ele age é o mapa de zones.