Contexto del agente Shipped
El fichero de contexto que muere con la task
Todo agente de código lee un fichero de instrucciones, y casi todos están desactualizados. Éste se genera en el momento en que el trabajo queda autorizado y se retira en el momento en que se entrega — porque un contexto que sobrevive a su task es peor que no tener contexto.
El estándar, y la parte que faltaba
AGENTS.md es una convención que ahora custodia la Linux Foundation y que leen decenas de miles de repositorios y docenas de herramientas. Eso es una victoria real — un fichero, todos los agentes — y también es commodity: generar uno no es un producto, y preferimos decirlo a vendértelo.
Lo que ninguna convención aporta es un ciclo de vida. Un fichero escrito una vez se separa del repositorio que describe, y nada en el formato se entera. CommitCycle escribe un bloque delimitado dentro del tuyo, sólo ese bloque le pertenece, y lo retira al final.
Qué dice el bloque
<!-- cc:begin -->
## CommitCycle
### You are working on CC-326 — Seven Platform menu items still point at documentation
Branch `task/CC-326-seven-platform-menu-items...`. Access expires in about 8 hours.
**What it should do.** …el Goal de la task…
**What it must NOT do.** …sus non-goals, literales…
**No protected zone is open to this task.** Everything below is closed.
**Read before working** — the playbooks for this task's topics:
- .zones/playbooks/design.md
- .zones/playbooks/frontend.md
**Closed to this task.** You may not write there — nothing is stopping you,
so this one is on you:
- `schema` (deny): apps/api/migrations/**, apps/api/src/db/schema/**
<!-- cc:end -->Ése es un bloque real, recortado: el que se escribió para la task que produjo esta página. El bloque va en inglés porque el agente que lo lee trabaja en inglés y el dashboard también. Fíjate en la frase del medio: nothing is stopping you, so this one is on you. El fichero es honesto sobre ser un consejo.
Por qué caduca
Porque la alternativa se midió aquí, no se imaginó. Un bloque de una task cerrada estuvo en nuestro propio trunk anunciando que había trabajo activo; cada sesión que clonaba el repositorio lo leía y se lo creía, y el siguiente pull request heredaba el conflicto. El arreglo no fue un recordatorio mejor: fue hacer que la entrega commitee su propia limpieza, para que el fichero no pueda quedarse atrás por alguien con prisa.
Hay una segunda razón, y es la que decide arquitecturas. Un resumen de un proyecto es un artefacto de un instante sin ciclo de mantenimiento: el resumen guardado de un asistente describió este repositorio como si no tuviera código de producto, la misma semana en que cerró setenta y siete tasks. Los resúmenes orientan; nunca testifican.
Dónde se detiene
- Aconseja y no puede imponer. Nada aquí deniega una escritura. Eso es el modelo de zones, decidido en la llamada a la herramienta — y este fichero es la capa 1 de tres precisamente por eso.
- No puede obligar a un agente a leerlo. Ningún fichero de instrucciones puede. Lo que sí puede hacer el gate es mantenerlo al día, para que un agente que sí lo lea no acabe engañado.
- Le pertenece un bloque, no tu fichero. Todo lo que escribiste alrededor de la marca es tuyo y sigue intacto.
Los campos del bloque están en la documentación (en inglés), el mapa del que se genera es el mapa de zones, y la capa que de verdad dice que no es la pila de enforcement.