🌱 Ingestão contínua, atualização e reuso

O especialista publicou um guia novo. Você não recompila a wiki inteira nem reescreve regras à mão: roda /<slug>-ingere <link>. A skill coleta, cria a página da fonte, propaga pelas páginas afetadas, mexe nas regras se for o caso, registra no log e prova com os três validadores.

O caso real: um guia sobre usar dois agentes

cd ~/mentores/mentor-<slug>
git add -A && git commit -qm "antes da ingestão"
claude
# dentro do Claude Code:
/<slug>-ingere <link novo do especialista, fora do ESCOPO.md>
# de volta ao terminal:
tail -1 wiki/log.md
git status --short wiki/ regras.md
python3 tools/stats.py && python3 tools/validar_links.py && python3 tools/validar_citacoes.py; echo "exit=$?"

Na trilha 4 você viu os três status de uma regra. A ingestão é o momento em que eles se movem. Uma regra com uma fonte só fica no banco, esperando; quando chega a 2ª fonte diferente dizendo a mesma coisa, ela é promovida a ativa e passa a guiar o mentor.

No piloto aconteceu um caso curioso: R9 e R10 nasceram já ativas. O comportamento era novo no guia ingerido, mas a 2ª fonte já estava no acervo cru, dizendo o mesmo sem que ninguém tivesse transformado aquilo em regra — uma live, no caso da R9, e outro guia, no da R10. Veja a R9 como ficou:

## R9 — Revisar com outro agente, entregando o artefato real
- status: ativa
- enunciado: Pôr uma segunda IA para questionar e testar o que a primeira fez, dando a ela o mesmo
  briefing e o arquivo, diff ou saída de teste (nunca um resumo), e não tratar a concordância das
  duas como prova.
- citacoes:
  - "também é muito bom tu ter uma outra IA" — raw/videos/inema-vibecode-do-zero-dia-1-…txt@00:08:29
  - "dê ao segundo agente o mesmo briefing da tarefa e o artefato real" — raw/guia/agente-claude-codex-…md
  - "Os dois concordarem não é prova: eles podem dividir a mesma suposição errada." — raw/guia/agente-claude-codex-…md
- no mentor: seção Revisão — o mentor pede o artefato (arquivo, diff, saída) em vez da descrição…

cd ~/mentores/mentor-<slug>
git show HEAD:regras.md | grep -E '^- status:' | sort | uniq -c   # antes (último commit)
grep -E '^- status:' regras.md | sort | uniq -c                   # agora
git diff --word-diff regras.md | grep -E 'status|^## R'

O kit evolui — o 1.2 nasceu do piloto. Seu mentor já existe, com acervo, wiki e regras que custaram horas. Gerar de novo seria perder tudo. O --atualizar faz a separação: troca o que é código e instrução do kit e não encosta no que é conteúdo seu.

cd ~/caminho/do/kit/mentor-especialista && git pull && cat VERSION
cd ~/mentores/mentor-<slug> && git add -A && git commit -qm "antes de atualizar o kit"
python3 ~/caminho/do/kit/mentor-especialista/novo-mentor.py --atualizar ~/mentores/mentor-<slug>
git status --short | grep -E ' (raw|wiki)/| regras.md| ESCOPO.md' || echo "conteúdo intacto"
python3 tools/stats.py && python3 tools/validar_links.py && python3 tools/validar_citacoes.py; echo "exit=$?"

Nada no kit é específico do Nei. O que muda de um especialista para outro é o conteúdo — acervo, wiki, regras — e, às vezes, o formato da resposta. O núcleo (raw/, wiki/, regras.md, tools/) nem depende do Claude Code.

Três tipos de reuso

Exemplo de seções para um mentor de escrita, no mentor.config.json:

"secoes_resposta": ["Objetivo", "Rascunho mínimo", "Previsão de reação", "Teste com leitor", "Versão fraca", "Relatório"]

cd ~/caminho/do/kit/mentor-especialista
python3 novo-mentor.py <slug2> --nome "<Nome do 2º especialista>" \
  --dominio "<domínio numa frase estreita>" --destino ~/mentores
ls ~/mentores
ls ~/mentores/mentor-<slug2>/.claude/skills

Com dois ou mais mentores prontos, você pode juntá-los num projeto seu e consultar todos sobre a mesma pergunta. Cada um continua preso às próprias regras e citações: o conselho não mistura as vozes, compara os métodos.

mkdir -p ~/projetos/<meu-projeto>/.claude/agents
cp ~/mentores/mentor-<slugA>/.claude/agents/<slugA>-mentor.md ~/projetos/<meu-projeto>/.claude/agents/
cp ~/mentores/mentor-<slugB>/.claude/agents/<slugB>-mentor.md ~/projetos/<meu-projeto>/.claude/agents/
cd ~/projetos/<meu-projeto> && claude

# prompt para colar na sessão:
Consulte o subagente <slugA>-mentor e o subagente <slugB>-mentor, separadamente,
sobre: <sua pergunta>. Entregue aos dois o arquivo <caminho do artefato>, não um resumo.
Avise cada um de onde está o próprio núcleo: o <slugA>-mentor usa regras.md e wiki/
em ~/mentores/mentor-<slugA>/; o <slugB>-mentor, em ~/mentores/mentor-<slugB>/.
Depois compare numa tabela: onde concordam, onde divergem e qual regra (R1, R2…) de
cada um justificou a posição. Não escolha um vencedor: a decisão é minha.

O projeto final é o mentor completo de um especialista à sua escolha — você mesmo é uma opção forte. O acervo do curso é menor que o do piloto de propósito: 20 a 50 fontes, cerca de 50 mil palavras. Um acervo completo é caro demais para exercício.

cd ~/mentores/mentor-<slug>
for t in stats validar_links validar_citacoes; do
  python3 tools/$t.py >/dev/null 2>&1 && echo "ok   $t" || echo "FALHA $t"
done
python3 tools/validar_resposta.py testes/respostas/<arquivo do teste 1>.md \
  --transcript logs/teste1.jsonl >/dev/null && echo "ok   loop" || echo "FALHA loop"
grep -c '^| 20' testes/aceitacao/RESULTADOS.md     # linhas de resultado registradas
tail -1 wiki/log.md