Contexto do agente Shipped

O arquivo de contexto que morre com a task

Todo agente de código lê um arquivo de instruções, e quase todos estão desatualizados. Este é gerado no instante em que o trabalho é autorizado e removido no instante em que é entregue — porque um contexto que sobrevive à sua task é pior do que contexto nenhum.

O padrão, e a parte que faltava

AGENTS.md é uma convenção hoje mantida sob a Linux Foundation e lida por dezenas de milhares de repositórios e dezenas de ferramentas. Isso é uma vitória real — um arquivo, todos os agentes — e também é commodity: gerar um não é um produto, e preferimos dizer isso a vender para você.

O que nenhuma convenção fornece é um ciclo de vida. Um arquivo escrito uma vez se afasta do repositório que descreve, e nada no formato percebe. O CommitCycle escreve um bloco delimitado dentro do seu, só esse bloco lhe pertence, e o retira no fim.

O que o bloco diz

<!-- 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.** …o Goal da task…
**What it must NOT do.** …seus non-goals, na íntegra…

**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 -->

Esse é um bloco real, recortado: o que foi escrito para a task que produziu esta página. O bloco fica em inglês porque o agente que o lê trabalha em inglês, e o dashboard também. Repare na frase do meio: nothing is stopping you, so this one is on you. O arquivo é honesto sobre ser um conselho.

Por que ele expira

Porque a alternativa foi medida aqui, não imaginada. Um bloco de uma task já fechada ficou no nosso próprio trunk anunciando que havia trabalho ativo; cada sessão que clonava o repositório lia aquilo e acreditava, e o pull request seguinte herdava o conflito. A correção não foi um lembrete melhor — foi fazer a entrega commitar a própria limpeza, para que o arquivo não possa ficar para trás por alguém com pressa.

Há uma segunda razão, e é a que decide arquiteturas. Um resumo de um projeto é um artefato de um instante, sem ciclo de manutenção: o resumo guardado de um assistente descreveu este repositório como se não tivesse código de produto, na mesma semana em que ele fechou setenta e sete tasks.Resumos orientam; nunca testemunham.

Onde ele para

• Ele aconselha e não impõe. Nada aqui nega uma escrita. Isso é o modelo de zones, decidido na chamada da ferramenta — e este arquivo é a camada 1 de três exatamente por isso.
• Não consegue obrigar um agente a lê-lo. Nenhum arquivo de instruções consegue. O que o gate consegue é mantê-lo atual, para que um agente que o leia não seja induzido ao erro.
• Um bloco lhe pertence, não o seu arquivo. Tudo o que você escreveu em volta da marca é seu e continua intacto.

Os campos do bloco estão na documentação (em inglês), o mapa a partir do qual ele é gerado é o mapa de zones, e a camada que de fato diz não é a pilha de enforcement.