🧩 Fontes, temas, princípios e métodos

🧪 Copy-run — ache as ligações de mão única entre fontes e conceitos

Objetivo: até o kit 1.2, o validar_links.py não checava os dois sentidos. Este script, só com a biblioteca padrão do Python, lista os pares fonte↔conceito em que falta o link de volta. Rode na pasta do mentor:

cd ~/projetos/mentor-<slug>
python3 - <<'EOF'
import re
from pathlib import Path
LINK = re.compile(r"\[\[([^\]|#]+)(?:[#|][^\]]*)?\]\]")
pags = {p.stem: p for p in Path("wiki").rglob("*.md") if p.stem not in ("index", "hot", "log")}
sai = {s: {x.strip() for x in LINK.findall(p.read_text(encoding="utf-8"))} for s, p in pags.items()}
fonte = {s for s, p in pags.items() if p.parent.name == "fontes"}
n = 0
for a in sorted(sai):
    for b in sorted(sai[a]):
        if b in sai and a not in sai[b] and (a in fonte) != (b in fonte):
            print(f"sem volta: {a} -> {b}"); n += 1
print(f"{n} ligações fonte<->conceito de mão única")
EOF

Saída real no piloto (com o validar_links.py do kit 1.2 em exit 0):

sem volta: guia-agente-claude-codex-migrar-do-claude-pro-codex-ou-ac831 -> guia-de-projeto-landing
sem volta: subagentes -> video-live-100-videosdia-com-ia-agentes-metodos-e-escala-rea
sem volta: subagentes -> video-transcript
3 ligações fonte<->conceito de mão única

Como verificar: a última linha dá o total. Zero é o ideal; poucos casos se corrigem pedindo ao agente "acrescente o link de volta nestes pares" e rodando o script de novo até dar 0. Depois, validar_links.py tem que continuar em exit 0.

mão única: subagentes → fontes/video-transcript, mas a fonte não liga de volta

O wiki/log.md real do piloto (formato)

| data       | fonte                                  | páginas tocadas                | regras promovidas            |
|------------|----------------------------------------|--------------------------------|------------------------------|
| 2026-10-05 | acervo inicial (21 itens do MANIFESTO: | 21 fontes, 18 temas,           | — (fase 3 ainda não rodou)   |
|            | 15 vídeos, 6 guias)                    | 12 princípios, 19 métodos,     |                              |
|            |                                        | index, hot                     |                              |
| 2026-10-05 | /nei-ingere guia agente-claude-codex   | fonte nova; 2 métodos novos;   | R1, R2, R6 reforçadas;       |
|            |                                        | temas, princípios, index, hot  | R9 e R10 criadas já ativas   |

Duas linhas contam a história inteira da wiki: a compilação inicial e a primeira ingestão (trilha 6). O texto das colunas foi resumido e quebrado aqui para caber na tela.

🧪 Copy-run — confira o número do hot você mesmo

Objetivo: não confiar no número que o agente escreveu no hot; recontar as fontes que ligam cada princípio.

cd ~/projetos/mentor-<slug>
for p in <principio-1> <principio-2> <principio-3>; do
  echo "$p $(grep -l "\[\[$p\]\]" wiki/fontes/*.md | wc -l)"
done

Saída real no piloto (com os quatro princípios do topo):

verificar-antes-de-afirmar 18
menor-custo-que-resolve 17
medir-antes-de-acreditar 14
criterio-de-pronto-explicito 11

Como verificar: compare com cat wiki/hot.md. No piloto bate linha por linha: (18), (17), (14), (11). Se não bater no seu, o hot está desatualizado; peça ao agente para refazer só o hot a partir da contagem.

🧪 Copy-run — a auditoria em duas partes

Objetivo: o agente aponta candidatos a genérico; você confere os trechos com um comando. Parte 1, cole no Claude Code na pasta do mentor:

Leia wiki/hot.md e as páginas de wiki/principios/.
Para cada princípio, responda numa tabela:
1. nº de fontes que o ligam (conte os [[links]] em wiki/fontes/, não copie do hot);
2. um trecho literal curto que só <nome do especialista> diria, com o caminho raw/... ;
3. GENÉRICO ou DELE: GENÉRICO se o enunciado caberia em qualquer manual do domínio
   sem perder nada.
No fim, liste 3 páginas mais "dele" e 3 mais genéricas.
Não invente trechos: se não achar, escreva "sem trecho". Não altere nenhum arquivo.

Parte 2, no terminal: pegue três trechos da tabela e procure cada um no raw.

cd ~/projetos/mentor-<slug>
grep -rnF "<trecho copiado da tabela>" raw/ | cut -d: -f1,2; echo "exit=$?"
git status raw/

Saída real no piloto (trecho "Arquivo existir não é prova", do princípio verificar-antes-de-afirmar):

raw/guia/agente-claude-codex-migrar-do-claude-pro-codex-ou--ac8311.md:21
exit=0

Como verificar: cada trecho aparece com arquivo e linha; git status raw/ não lista nada (raw intocado). Trecho de guia que não aparece é inventado. Trecho de vídeo que não aparece pode ser o caso do próximo tópico: a frase existe, mas está quebrada entre duas linhas da legenda.

[00:25:40] né? eh, estrelas. Isso é muito legal
[00:25:43] porque mostra o movimento, mas é mais um
[00:25:46] movimento de de atenção. Objeto
[00:25:50] brilhante. Cuidado para vocês não
[00:25:51] perderem tempo com isso. O que que eu
[00:25:53] fiz? Eu baixei, instalei ele na minha
[00:25:56] máquina e eu estou rodando.

[00:25:40] né? eh, estrelas. Isso é muito legal porque mostra o movimento, mas é mais um movimento de de atenção. Objeto brilhante. Cuidado para vocês não perderem tempo com isso. O que que eu fiz? Eu baixei, instalei ele na minha máquina e eu estou rodando. …

🧪 Copy-run — veja a busca literal falhar numa frase que existe

Objetivo: sentir o problema na mão. No seu raw de vídeo, escolha duas palavras seguidas que estejam em linhas diferentes e procure as duas juntas.

cd ~/projetos/mentor-<slug>
grep -rnF "<fim de uma linha> <começo da próxima>" raw/videos/; echo "exit=$?"
grep -rnF "<fim de uma linha>" raw/videos/ | head -3

Saída real no piloto (com "Objeto brilhante"):

$ grep -rnF "Objeto brilhante" raw/videos/; echo "exit=$?"
exit=1

Como verificar: a frase falada não aparece (exit=1), mas cada metade aparece sozinha, em linhas vizinhas. Se o seu raw foi coletado com o kit 1.2 ou mais novo, a busca acha o parágrafo inteiro: sinal de que a correção chegou.