🔏 Citação, status e validador

O regras.md é lido por gente e por máquina. Por isso o formato é rígido: o próprio arquivo avisa "não mude os rótulos, o validador depende deles". Cada regra é um bloco com cinco peças, sempre nesta ordem. Este é o bloco real da R10 do piloto:

## R10 — Ação irreversível só com pedido atual do humano
- status: ativa
- enunciado: Gasto, publicação, deploy, envio ou apagar viram portão humano;
  nota antiga, handoff ou plano não autorizam, o pedido tem que vir de novo
  na sessão atual.
- citacoes:
  - "Gasto de crédito, API, produção e ações irreversíveis viram portão humano." — raw/guia/execucao-longa-agentes-que-trabalham-horas-e-dias--b43579.md
  - "Handoff não é permissão." — raw/guia/agente-claude-codex-migrar-do-claude-pro-codex-ou--ac8311.md
  - "Sem merge, deploy nem publicação sem você." — raw/guia/agente-claude-codex-migrar-do-claude-pro-codex-ou--ac8311.md
- no mentor: seção Risco — antes de um passo irreversível, o mentor para
  e pede a confirmação do aluno, mesmo que o plano já previsse o passo.

O status diz quanta prova a regra tem — e muda o que o mentor faz com ela. A conta é por arquivos diferentes, não por número de citações: três trechos do mesmo guia continuam sendo uma fonte só.

10 regras (10 ativas), 39 citações encontradas, 0 faltando
REPROVADO:
  - R9: 'ativa' exige ≥2 fontes diferentes (tem 1) — mova para 'banco'

Transcrição nunca é literal. A legenda pode vir sem acento, com outra pontuação ou com marcas de tempo no meio da frase. Se o validador comparasse caractere por caractere, reprovaria citação verdadeira. Então ele normaliza os dois lados — o trecho e o arquivo inteiro — antes de procurar um dentro do outro.

Um validador que sempre diz OK não prova nada — pode estar quebrado. O teste negativo é estragar a entrada de propósito e conferir que ele reclama. No piloto: uma citação inventada entrou e o validador respondeu 1 faltando, com exit 1. É a R1 do Nei aplicada ao próprio kit: não aceitar o OK sem ver o que ele faz quando devia dizer não.

10 regras (10 ativas), 40 citações encontradas, 0 faltando
OK
exit=0

10 regras (10 ativas), 39 citações encontradas, 1 faltando
REPROVADO:
  - R10: citação não encontrada em raw/guia/agente-claude-codex-...md:
    "Handoff nunca é permissão para nada."
exit=1

Saídas reais, rodadas no mentor do Nei. A mudança foi pequena — "Handoff não é permissão." virou "Handoff nunca é permissão para nada." — e bastou. Palavra a mais é exatamente o tipo de paráfrase que a normalização não perdoa.

Desta vez quem errou não foi o kit nem o agente: foi o operador. Na fase 3 do piloto, depois do teste negativo, a edição foi desfeita com git checkout regras.md. Só que as 8 regras recém-geradas ainda não tinham sido commitadas. O checkout devolveu o arquivo à última versão salva no git — o modelo vazio — e as regras sumiram.

| data | o que quebrou | menor correção | prompt \| infra |
|---|---|---|---|
| 2026-10-05 | teste negativo + `git checkout regras.md` apagou as regras da fase 3 (não commitadas); recuperado do log da sessão | commitar antes de teste destrutivo (ou cópia no scratchpad) | prompt |

Três blocos para rodar na pasta do seu mentor, no terminal (não precisa de IA para nenhum deles). Juntos eles fecham a fase 3: o arquivo passa, você prova que o validador reprova o que deve, e nada se perde no caminho.

git add regras.md mentor.config.json
git commit -m "fase 3: regras validadas"
git status --short regras.md

python3 tools/validar_citacoes.py; echo "exit=$?"

mkdir -p .mentor/tmp
cp regras.md .mentor/tmp/regras-neg.md
# estraga a 1ª citação da cópia
sed -i '0,/^  - "/s//  - "TRECHO INVENTADO /' .mentor/tmp/regras-neg.md
python3 tools/validar_citacoes.py --regras .mentor/tmp/regras-neg.md; echo "exit=$?"
git status --short regras.md