Gate insatisfazível por bot: AGENTS.md declara versões à mão e todo bump de framework reprova o verify

[melgarafael]

tests/unit/agents-md-versoes.test.ts compara as versões declaradas à mão em AGENTS.md:22-25 com as do package.json. O teste é legítimo — nasceu porque o arquivo dizia "Zod 3" num repo em zod 4, numa seção rotulada CONFIRMADO, e um agente lendo aquilo escreveria idioma da major errada.

O problema é quem paga: todo bump minor de next, react, tailwindcss, @playwright/test, @sentry/nextjs ou typescript reprova o verify do Dependabot, e a correção é editar prosa em markdown — coisa que bot nenhum faz.

Medido no PR #211 (grupo de 17 deps): test:unit deu 1 failed | 3800 passed, e a única falha era AGENTS.md diz next 16.2, package.json tem 16.3.0. Consertei à mão (e0cf8efb) e fechou em 3801 passed.

Caminhos

1. Gerar a linha a partir do package.json num script, e o teste passa a comparar arquivo gerado com fonte — o Dependabot roda o script no mesmo PR (ou um workflow o faz).
2. Baixar a precisão declarada para a major só (Next.js 16), aceitando que minor não é o que engana. Mas o comentário do teste registra que o erro real que motivou tudo foi de minor.
3. Deixar como está e assumir que todo bump de framework precisa de um commit humano junto.

Prefiro a 1: mantém a precisão que pegou o defeito original e tira o humano do caminho.

[melgarafael]

Corrigido no PR #242.

O gate passa a cobrar a major. Medido antes, bumpando um pacote por vez como o grupo minor-and-patch faz, com o arquivo de teste real: 5 dos 8 reprovavam (next, react, typescript, tailwindcss, @playwright/test), e os 3 imunes eram exatamente os que o AGENTS.md declarava só com a major — o que confirma o diagnóstico da issue de que era a precisão declarada que tornava o gate insatisfazível.

O AGENTS.md passa a declarar só a major no mesmo commit. Sem isso ele ficaria certo na major e desatualizado na minor, afirmando uma precisão que nenhum gate cobre — que é literalmente como o "Zod 3" da #66 entrou. Há uma guarda de vacuidade que reprova se alguém reescrever a minor lá.

Sabotagens, com a contagem prevista antes de rodar: major divergente → 1 reprova; bump minor → 0 reprovam (o ponto da issue); doc declarando minor → 1 reprova; doc mentindo na major → 1 reprova.

De brinde, o mesmo parágrafo tinha uma afirmação falsa: dizia que o perf ainda builda em Node 20. Medido: node-version: 22 nos quatro sítios e .nvmrc = 22.