📚 O agente propõe, você aprova

Um agente que reescreve as próprias regras pode, sem querer, afrouxar justamente a regra que o segurava. Uma linha "pode pagar boletos pequenos" e a política do módulo 4.1 deixa de valer.

Por isso o AGENTS.md do kit diz, com todas as letras: "Você não muda estas regras. Para propor uma mudança, acrescente uma linha na tabela 'Aprendizado' da runtime/POLITICA.md. Quem aprova é o humano."

Como ler o desenho: o caminho azul de baixo passa sempre pela caixa âmbar, que é você. O arco vermelho de cima é o agente escrevendo direto nas Lessons, sem passar por você. É esse atalho que o AGENTS.md proíbe.

A tabela fica no fim da runtime/POLITICA.md, sob o título "Aprendizado (propõe → aprova → incorpora)". No kit ela vem vazia: só o cabeçalho, esperando a primeira proposta.

Cada linha tem quatro colunas. A segunda pede evidência: não vale "achei melhor", vale "aconteceu isto, neste dia, com este resultado".

O agente **não muda as próprias regras**. Ele acrescenta uma linha aqui; você decide.

| data | o que aconteceu (com evidência) | proposta (1 linha) | status: proposto / aprovado / recusado |
|---|---|---|---|

O que olhar na tabela: as duas linhas são exemplos de como ficaria, escritos para este curso, não vêm no kit. Repare que a proposta cabe em uma linha e diz o que fazer, não o que sentir.

A POLITICA.md fecha a seção assim: "Aprovado → vira regra no CLAUDE.md/AGENTS.md". No kit, o lugar é a seção ## Lessons do AGENTS.md.

Por que no AGENTS.md e não no CLAUDE.md? Porque o CLAUDE.md do kit começa puxando o AGENTS.md. Uma regra escrita num lugar só vale para o Claude e para o Codex.

## Lessons

Regras aprovadas pelo humano, uma por linha:

@AGENTS.md

## Self-learning

Quando o humano corrigir você, ou você notar um erro seu: proponha a lição como uma linha na tabela "Aprendizado" de `runtime/POLITICA.md`. Depois de aprovada, ela entra em `## Lessons` do `AGENTS.md`.

Como ler o desenho: tudo passa pela caixa âmbar. Você escreve a regra uma vez no AGENTS.md, e as duas setas azuis levam a mesma regra aos dois agentes. Não existe uma versão "só do Claude" para ficar desatualizada.

## Lessons

Regras aprovadas pelo humano, uma por linha:
- Antes de consultar a agenda, repetir a data em AAAA-MM-DD e esperar confirmação.

Quando algo quebra e você conserta, a tentação é seguir em frente. O runtime/FALHAS.md pede trinta segundos antes: uma linha com a data, o que quebrou, a menor correção e se o problema era de prompt ou de infra.

O kit já traz uma linha real, de quando ele mesmo foi testado. É o melhor exemplo do formato:

| data | o que quebrou | menor correção | prompt \| infra |
|---|---|---|---|
| 2026-10-05 | `doctor.mjs` dizia "codex sem login" com o Codex logado | ler stdout **e** stderr (`codex login status` responde no stderr) | infra |

Nem todo problema é falha. Às vezes nada quebrou: o ambiente simplesmente não deixou. O sandbox bloqueou a rede, a ferramenta não tem o recurso, o site pede login. Isso vai para o runtime/LIMITES.md.

No kit ele vem só com o cabeçalho. A última coluna, status, diz se o limite continua aberto ou se você aceitou conviver com ele.

| data | o que tentei | o que barrou | contorno | status |
|---|---|---|---|---|

O que olhar na tabela: a pergunta que separa é "quebrou ou não deixaram?". Quebrou e consertou, FALHAS. Não deixaram, LIMITES. Mudou o jeito de trabalhar, Aprendizado.

-c sandbox_workspace_write.network_access=true

Os três arquivos só ajudam se alguém os lê. Uma vez por semana, peça ao agente para ler tudo e transformar o que se repete em propostas. Ele faz a parte chata. Você faz a parte que importa: decidir.

São dois pedidos. O primeiro só gera propostas. O segundo, que você escreve depois de ler, aprova o que você quiser.

Leia runtime/FALHAS.md, runtime/LIMITES.md e a tabela Aprendizado de runtime/POLITICA.md. Procure o que se repete ou ainda está aberto. Para cada caso, acrescente uma linha na tabela Aprendizado com data, evidência, proposta em uma linha e status proposto. Não marque nada como aprovado e não altere o AGENTS.md nem o CLAUDE.md. No fim, liste as linhas que você acrescentou.

Na tabela Aprendizado de runtime/POLITICA.md, mude para aprovado a linha <data e proposta> e para recusado a linha <data e proposta>. Copie só a proposta aprovada, em uma linha, para ## Lessons do AGENTS.md.