CommitCycle para Claude Code Shipped
CommitCycle para Claude Code
O plugin instala a parte que diz não. As áreas do seu código que são perigosas de mudar ganham um owner, o trabalho declara de quais precisa, e o acesso é concedido para uma task em um branch — e devolvido quando você entrega.
Instalação
/plugin marketplace add pow-paulinho/commitcycle-plugin
/plugin install commitcycle@commitcycleEle traz os próprios binários. Não há npm install, nada é adicionado ao seuPATH, e nada fora do projeto em que você está trabalhando é tocado.
O que ele instala
| Componente | O que faz |
|---|---|
set-up-commitcycle | Configura um repositório perguntando sobre ele — quais áreas são perigosas, quem aprova cada uma, para qual board ele reporta |
start-work-inside-cc | Registra e delimita a task antes do trabalho, para que a regra chegue como um combinado e não como uma recusa |
Servidor MCP commitcycle | Cinco ferramentas de leitura: o mapa de zones, intake de uma linha, a entrevista, o scoping e o estado do board |
| O hook | A parte que de fato bloqueia uma escrita, em PreToolUse e PostToolUse |
Por que instalar isso não quebra seus outros repositórios
Os hooks de um plugin carregam no nível do usuário — rodam em todo repositório que você abrir, não só naquele que você configurou. Foi exatamente por isso que o hook ficou retido até saber distinguir "este repositório nunca instalou CommitCycle" de "esta task ainda não começou". Ele não sabia, respondia deny para as duas, e uma única instalação teria bloqueado cada escrita em cada projeto sem relação na máquina.
Agora sabe. Um repositório sem .zones/zones.yml é deixado em paz e em silêncio: permitido, sem registro, sem conselhos — você não deveria conseguir perceber que o hook rodou. E um mapa vazio não é a mesma coisa que um mapa ausente: isso é um projeto que fez a configuração e não protegeu nada, então ali uma task continua sendo exigida.
As cinco ferramentas, e a linha que elas não cruzam
cc_zones, cc_intake, cc_interview, cc_scope, cc_status. Nenhuma inicia trabalho, emite um grant ou aprova acesso a nada.
Isso não é um descuido a ser corrigido depois. Uma aprovação que chega por uma ferramenta chamada pelo agente é autenticada por um token que o agente carrega, então um board não teria como distinguir o seu sim do dele. As ferramentas descrevem o trabalho. Quem o inicia é uma pessoa.
Por que o board não é opcional
O mapa de zones, a auditoria do que é perigoso e os registros do que cada task declarou são arquivos do seu repositório, e continuam sendo seus. O que precisa de um board é o ciclo:o gate é o único emissor de um grant, e ele roda lá. Instale o hook sem board e nada conseguirá abrir coisa alguma — toda escrita é negada, inclusive nos paths desprotegidos. Por isso a skill de configuração pede o board em vez de oferecer um modo local que termina num repositório onde ninguém consegue escrever.
Onde isso para
O modelo de zones independe do agente; o ponto de enforcement precisa de um adaptador pequeno por harness. Claude Code, Codex, Cursor, Augment, Copilot e Devin CLI expõem a mesma primitiva — um hook antes da chamada que pode responder deny — então os adaptadores são finos.Hoje existe um publicado, e é este.
- O hook decide em 68–83 ms no p95 contra um orçamento de 100 ms — eo p99 encostou em 102 ms num caso. A margem é estreita e as alavancas estão nomeadas.
- O harness do Claude Code é fail-open nos quatro modos de falha que medimos contra sessões reais. Por isso o plugin traz um wrapper que fecha três deles, e por isso existe um check de CI para o quarto — o único que a CI consegue ver, onde o hook nunca chegou a ser instalado.
O mecanismo completo está na documentação (em inglês): areferência de instalação, omodelo de zones e asferramentas MCP.