Como ler: da esquerda para a direita é a fase 3 inteira. A wiki (ciano) alimenta o regras.md,
que você aprende a escrever no módulo 4.1. O validador (ciano, à direita) confere cada citação contra o acervo cru, assunto do
módulo 4.2. A seta vermelha tracejada é o caminho de volta quando algo não bate: corrige-se a citação, nunca o validador. Só com
exit 0 as regras seguem para o agente. No piloto do Nei, saíram 8 regras e 31 citações na primeira passada; hoje são 10 regras e 40 citações.
Mapa da trilha
Conteúdo detalhado
🎯 Conduta, não frase de efeito
O que conta como regra, onde procurar na wiki, como fundir e cortar, as 10 regras do Nei, a linha "no mentor:" que liga a regra à resposta e a skill /<slug>-regras na prática.
A definição do kit: regra é o que a pessoa faz de forma recorrente ao ensinar ou construir, não uma frase de efeito. Tem um momento que a dispara, uma ação que dá para ver e trechos do acervo que a provam.
Frase bonita não orienta resposta nenhuma. Se a regra não diz o que fazer na próxima tarefa, o mentor não tem como segui-la e você não tem como cobrar.
Começa com verbo · Repete em fontes diferentes · Muda a resposta do mentor.
A leitura de wiki/principios/ cruzada com wiki/metodos/: o princípio que aparece como passo em vários métodos é o candidato forte a regra.
Reler 189 mil palavras de acervo para achar regra é desperdício. A wiki do piloto já tinha separado princípios e métodos, cada um com trechos e fontes.
Princípio vira gesto dentro de métodos · Contar fontes, não menções · Raw só para conferir a citação.
Juntar numa regra só os jeitos diferentes de dizer a mesma conduta (eles viram citações) e apagar o que não muda nenhuma seção da resposta.
O mentor lê o regras.md inteiro antes de cada resposta. Regra fraca dilui as fortes e alonga a resposta sem melhorar nada.
Fundir aumenta a prova · Cortar diminui o ruído · Teste do corte: "se eu apagar, o que muda?"
As regras do piloto, de R1 (conferir o resultado real antes de dizer "pronto") a R10 (ação irreversível só com pedido atual do humano), cada uma com uma citação de live ou guia.
É um exemplo completo e validado: 10 regras ativas e 40 citações, 8 delas criadas na fase 3 e 2 depois da ingestão de um guia novo.
Antes, durante e antes de entregar · Citação de live parece picada (e é literal) · Todas começam com verbo.
A última linha de cada regra, que diz em qual seção da resposta ela aparece (Custo, Sua vez, Risco…). No kit 1.2 esses nomes entram em secoes_resposta e o validador de resposta passa a cobrá-los.
O piloto achou o furo: as regras pediam seções próprias, mas o agente tinha um loop fixo. Sem esse elo, a regra existe no arquivo e não aparece na resposta.
1 a 3 seções novas, no máximo · ID estável (R1, R2…) no relatório · Regra que alguém de fora consegue cobrar.
A skill da fase 3, gerada no seu mentor pelo kit. Lê princípios e métodos, escreve o regras.md no formato exato e roda o validador.
No piloto, levou 1,1 minuto e saiu com 8 regras ativas, 31 citações e validador OK de primeira. Você ainda audita se cada regra é conduta.
Prompt pronto para colar · Pronto = exit 0 · Auditoria: gatilho, ação, seção, fontes.
🔏 Citação, status e validador
O formato exato do regras.md, os status ativa/banco/inferência, a normalização das citações, o teste negativo, o caso real do git checkout que apagou as regras e os comandos para rodar tudo.
Um bloco por regra com cinco peças: ## R<n> — título, status, enunciado, citações (trecho + caminho no raw + localizador) e a linha "no mentor:".
O validador lê o arquivo por expressão regular. Um rótulo diferente e a regra some da conferência sem aviso.
Cabeçalho, status e citações são da máquina · Enunciado e "no mentor:" são do agente · Localizador é para o humano.
Três níveis de confiança: ativa (≥2 arquivos diferentes), banco (1 fonte, espera a 2ª) e inferência (sem citação, o mentor avisa ao usar).
Algo dito uma vez pode ser acaso. O status separa o hábito da pessoa do comentário solto, e o mentor trata cada um de um jeito.
Conta arquivos, não citações · "mova para 'banco'" · Inferência é dita em voz alta.
Antes de comparar, trecho e arquivo perdem marcas [hh:mm:ss], acentos, maiúsculas e pontuação. "Handoff não é permissão." vira "handoff nao e permissao".
Transcrição nunca é literal. Sem normalizar, citação verdadeira reprova; com ela, só a paráfrase reprova.
Perdoa forma, não conteúdo · Copiar, não parafrasear · Legenda em parágrafos de ~30 s (kit 1.2).
Estragar uma citação de propósito e conferir que o validador reprova: no piloto, "1 faltando" e exit 1.
Validador que sempre diz OK pode estar quebrado. Só o teste negativo mostra que ele de fato morde.
Testar o teste · Fazer numa cópia com --regras · Uma palavra a mais já reprova.
No piloto, desfazer o teste negativo com git checkout regras.md apagou as regras da fase 3, que não estavam commitadas. Foram recuperadas do log da sessão.
O erro mais caro do piloto nessa fase não foi da IA. A lição ficou registrada como a menor correção possível: commitar antes de teste destrutivo.
Checkout não tem lixeira · Commit antes, ou cópia · Uma linha no FALHAS.md.
Os comandos para salvar o regras.md no git, rodar tools/validar_citacoes.py e fazer o teste negativo numa cópia em .mentor/tmp/.
É o fechamento da fase 3: o arquivo passa, você prova que o validador reprova o que deve e nada se perde no caminho.
Pronto = OK e exit 0 · Teste negativo = exit 1 · Nunca afrouxar o validador.