--- title: "AGENTS.md, y un fichero de task que caduca al entregar" description: "Un bloque en AGENTS.md lleva el mapa de zones, el board y la regla de deploy. La task activa va a un CLAUDE.local.md fuera de git y se borra al entregar." url: https://commitcycle.com/es/agents-md/ language: es --- # El fichero de contexto que muere con la task > Un bloque en AGENTS.md lleva el mapa de zones, el board y la regla de deploy. La task activa va a un CLAUDE.local.md fuera de git y se borra al entregar. Contexto del agente Shipped Todo agente de código lee un fichero de instrucciones. CommitCycle deja en AGENTS.md lo que no cambia con el trabajo, y escribe la task en sí en un fichero ignorado por git en el momento en que el trabajo queda autorizado, y lo retira en el momento en que se entrega — porque un contexto que sobrevive a su task es peor que no tener contexto. cycle start escribe la task en un CLAUDE.local.md ignorado por git, junto al mapa de zones de AGENTS.md, y cycle submit la vuelve a sacar. ## El estándar, y la parte que faltaba `AGENTS.md` es una convención que ahora custodia la Linux Foundation, y en nuestro recuento del 2026-08-09 estaba en más de 60.000 repositorios y la leían más de 25 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 y sólo ese bloque le pertenece: el mapa de zones, el board, la nota de entrega que espera y la regla de deploy, idéntico byte a byte entre tasks, así que no es el fichero en el que choca un merge. La task activa, sus non-goals y lo que abre su grant van a `CLAUDE.local.md` — ignorado por git, escrito en el gate y retirado al entregar. ## Qué dice el bloque de la task ``` ## 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/** ``` Ése es un bloque real, recortado: el que se escribió para la task que produjo esta página, antes de que CC-551 sacara esta mitad de AGENTS.md; las mismas líneas van ahora a `CLAUDE.local.md`. 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 primer arreglo fue hacer que la entrega commiteara su propia limpieza. El que se sostuvo fue **sacar la task del fichero commiteado por completo**, a uno ignorado por git que no puede llegar al trunk. 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 semana en que su board contaba setenta y siete tasks cerradas (2026-08-09). **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](https://commitcycle.com/es/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. - **De la mitad de la task sólo se sabe que llega a Claude Code.** `CLAUDE.local.md` es el fichero de Claude Code, y si otros editores lo cargan no se ha comprobado nunca; cuenta con que lean AGENTS.md, que lleva el mapa y las reglas pero no la task activa. Los campos del bloque están en [la documentación](https://commitcycle.com/docs/concepts/agents-md/) (en inglés), el mapa del que se genera es [el mapa de zones](https://commitcycle.com/es/zones/), y la capa que de verdad dice que no es [la pila de enforcement](https://commitcycle.com/docs/concepts/three-layers/). ## Preguntas que responde esta página ### ¿CommitCycle reemplaza mi AGENTS.md? No. Escribe un bloque delimitado dentro de él y sólo ese bloque le pertenece. Todo lo que hayas escrito alrededor queda intacto. El bloque contiene lo que no cambia con el trabajo; la task activa va a un CLAUDE.local.md ignorado por git, que se borra al entregar la task. ### ¿Un agente puede ignorar lo que dice AGENTS.md? Sí, y el propio bloque lo dice. El contexto aconseja — no puede denegar una escritura. Eso es el hook local, que es otra capa. El check de CI, que podría atrapar el trabajo hecho donde no se ejecutó ninguno de los dos, sólo corre en el propio repositorio de CommitCycle.