This page is also available in English.
Read in EnglishEsta página também está disponível em português.
Ler em portuguêsZones
La mayor parte de un repositorio es segura para que un agente la cambie. Unas pocas partes no lo son — el schema, los contracts, lo que diga tu historial de incidentes. Una zone es cómo dices cuál es cuál, en un fichero que revisas como código — y, en modo governance, los únicos paths que CommitCycle bloquea. El modo por defecto, memory, no tiene zones e impone una sola cosa: editar requiere una task activa.
✓ gate: four fields answered, no high-risk zone to approve
REQ-7 · schema · write · CC-42
Reason: the board query needs an index
Instead: hand the DDL to the owner
1 hour4 hoursUntil the task closes
✓ Approved — schema is open to CC-42 for 4 hours
En la consola una task cruza el gate hacia In Progress, y el owner de una zone responde a un access request — por una hora, cuatro, o hasta que la task se cierre.
> add an index on tasks.updated_at — the board query is slow
● Write(apps/api/migrations/0042_tasks_updated_at.sql)
⎿ PreToolUse:Write — ✗ Denied by CC
zone schema · risk high
owner ana@acme.dev
task CC-42 declared no protected zones
reason path is in a zone the task never asked for
● The schema zone is closed to CC-42. Asking its owner rather than looking for another way in.
● Bash(cycle request-access --zone schema --mode write --reason "the board query needs an index" --alternative "hand the DDL to the owner")
⎿ REQ-7 is with the zone owner
approve or deny: https://dash.commitcycle.com/requests
El hook rechaza la escritura antes de que ocurra, nombra la zone y su owner, y el agente pide acceso en vez de buscar otro camino. Claude Code es donde se ha visto funcionar este bloqueo.
Los path patterns dicen dónde. Un risk level dice cuánto cuidado. Una default policy dice quién puede leerla cuando no se ha concedido nada — escribir siempre necesita un grant. Y un owner dice a quién preguntar — que es el atributo que convierte un muro en una vía de entrada.
# El mapa propio de CommitCycle, recortado. Cuatro zones en el fichero real, no treinta,
# todas legibles desde el 2026-10-10 — escribir en cualquiera sigue necesitando un grant.
zones:
- id: schema
risk: high
owner: paulo@commitcycle.com
paths:
- "apps/api/migrations/**"
- "apps/api/src/db/schema/**"
default_policy: open
- id: enforcement
risk: high
owner: paulo@commitcycle.com
paths:
- "packages/hook/**"
- "packages/action/**"
default_policy: open
- id: brand
risk: medium
default_policy: open
# Todo lo que no está aquí queda sin proteger, a propósito.Mover una task a In Progress es lo que lo emite. Aparte de ese gate, sólo un owner que responde a un access request abre una zone, y cycle renew sólo vuelve a emitir el mismo alcance — no hay ningún comando open-zone, y nadie tiene que acordarse de cerrar nada.
Atado a una task
Abre las zones que esa task declaró, y nada adyacente. El cambio vecino tentador es justo el que los non-goals existen para nombrar.
Atado a una rama
La garantía es por checkout: dos agentes en un mismo directorio comparten una rama, y con ella una task y un grant. Éste es el fallo que este mismo producto sufrió primero (D-43, aún propuesta); la respuesta por ahora es un worktree por agente.
Caduca en ocho horas como mucho
El gate lo emite para ocho horas como mucho. Un owner que aprobó una zone de alto riesgo para una hora o cuatro adelanta la caducidad de todo el grant para que coincida (CC-1327).
Write apps/api/migrations/0007_add_org_index.sql
Al agente se le dice por qué en la misma respuesta que se lo deniega, así que pide acceso en lugar de intentar otra vía. Un bloqueo que sólo dice que no acaba siendo esquivado.
CC-42 quiere schema
apps/api/migrations/**Just-in-time: el grant caduca solo. Nadie tiene que acordarse de cerrarlo, que es justo el paso en el que falla cualquier proceso de acceso.
Mejor decirlo antes de que lo descubras tú: denegar una tool call en el momento ya lo tienen Claude Code, Codex, Cursor, Augment, Factory y Devin CLI, y es gratis en el que ya estés usando. Si eso fuera el producto, no necesitarías esta página.
Lo que ninguno de ellos tiene es el modelo que consulta esa denegación. Sus reglas son por máquina y permanentes. No hay un owner a quien preguntar, ni un momento de aprobación, ni caducidad, ni noción de una task a la que el permiso pueda estar atado.
Las reglas de todos los demás
Una lista de paths. Fijada una vez, cierta para siempre, igual para cualquier trabajo, sin nadie asociado.
Una zone más un grant
Path × owner × risk × esta task × esta rama × ocho horas como mucho, y un registro de quién lo abrió y por qué.
Contra CODEOWNERS y los rulesets de rama la diferencia es el cuándo: mismo vocabulario, preguntado después de que el cambio ya existe, impuesto en el host. Una zone se comprueba en la escritura, en tu portátil, sin conexión — y el check de CI que recalcula el diff después corre sólo en el propio repositorio de CommitCycle.
Cada cifra aquí lleva su límite en la misma frase.
cmd & dentro de otro — se le escapa hasta que el cierre comprueba el diff contra las zones (CC-1379). Medido el 2026-08-03 (CC-3). Los paths ignorados por git no se ven, así que un .env dentro de una zone no tiene contención. El corpus lo eligió el propio autor. El eval de falsos positivos en vivo no ha corrido.cycle export --audits imprime el historial del board, registros incluidos, en Markdown.Declara esos paths como una zone con un owner y un risk level. El agente sólo obtiene acceso a las zones que su task declaró, en la rama a la que esa task está atada, y el acceso caduca por sí solo. Todo lo que no declares queda sin proteger, que es lo correcto para la mayor parte de un repo.
CODEOWNERS es el mismo vocabulario aplicado después del hecho, en el host: pide una revisión una vez que el cambio ya existe. Una zone se comprueba en el momento de la escritura, en tu máquina, y lleva una caducidad y un alcance de task que CODEOWNERS no contempla.