Kit aberto para Claude Code
O método de um especialista virando seu mentor
Ensina construindo, revisa antes da entrega e só diz "funciona" depois de rodar. Cada regra aponta para um trecho real do que o especialista publicou.
Ensina construindo, revisa antes da entrega e só diz "funciona" depois de rodar. Cada regra aponta para um trecho real do que o especialista publicou.
Quando você pede a uma IA para explicar algo, ela costuma explicar demais, parecer certa sem estar, supor coisas sem avisar e responder no genérico. Este kit monta um mentor que ensina do jeito de alguém que você admira, com prova para cada passo.
Tudo o que o especialista publicou (vídeos, textos, repositórios, posts) vira uma wiki interligada que a IA consulta sem se perder no palheiro.
Cada regra de conduta tem um trecho copiado do acervo e o lugar exato de onde veio. Um script recusa citação inventada.
O mentor segue um passo a passo fixo, e um portão automático não deixa o turno terminar se houve código escrito e não executado.
Cada fase tem um comando que responde "terminou?" com exit 0 ou com o motivo da reprovação. Nada depende de a IA dizer que acabou.
raw/ é somente leitura, com manifesto e hash de cada item. A wiki tem páginas de fontes, temas, princípios e métodos, além de index, hot e log.
ativa exige 2 fontes diferentes; banco espera a 2ª; inferência é avisada ao usuário. A comparação ignora caixa, acentos e pontuação.
Pronto → Menor versão → Previsão → Saída real → Versão quebrada → Relatório com a regra que guiou cada passo.
Os scripts usam só a biblioteca padrão do Python. Nada de API paga.
Para o gerador, os coletores e os validadores.
python3 --version git --version
Onde o agente, as skills e o portão rodam.
claude --versionyt-dlp para legendas de vídeo e um transcritor local (Whisper, faster-whisper…) para vídeos sem legenda. pytest só para testar o kit.
yt-dlp --versionComandos reais do kit. Troque prof-redes pelo nome curto do seu mentor.
O exemplo é uma especialista fictícia com 3 fontes e 7 regras, passando em todos os validadores.
git clone https://github.com/inematds/mentor-especialista.git cd mentor-especialista python3 exemplo/tools/stats.py --raiz exemplo python3 exemplo/tools/validar_citacoes.py --raiz exemplo
Gera a pasta com o acervo, a wiki, as regras, os scripts, o agente, as 6 skills e o portão de execução.
python3 novo-mentor.py prof-redes \ --nome "Nome do especialista" \ --dominio "ensinar redes neurais construindo do zero" \ --destino ~/mentores
No ESCOPO.md vão as fontes. No mentor.config.json vão as metas de coleta, os idiomas de legenda e o seu transcritor (veja docs/ADAPTAR.md).
cd ~/mentores/mentor-prof-redes # no mentor.config.json, por exemplo: "transcrever_cmd": "seu-transcritor --url {url} --out {saida}"
No Claude Code, dentro da pasta do mentor. Um subagente por fonte, em paralelo. O que falhar vai para raw/RELATORIO-FALHAS.md.
/prof-redes-coletar # pronto quando: python3 tools/stats.py # → exit 0 (metas batidas, raw intacto)
A wiki liga fontes, temas, princípios e métodos nos dois sentidos. As regras saem com trecho copiado do acervo.
/prof-redes-compilar python3 tools/validar_links.py # → 0 links quebrados /prof-redes-regras python3 tools/validar_citacoes.py # → 0 faltando
O ensina constrói junto com você e confere a resposta por fora. O revisa prevê onde quebra, reproduz e prova a versão enxuta lado a lado.
/prof-redes-ensina me ensina a fazer um tokenizador BPE do zero /prof-redes-revisa scripts/coleta.py python3 tools/validar_resposta.py testes/respostas/<arquivo>.md
Um link novo vira página de fonte, atualiza as páginas afetadas e pode promover uma regra do banco para ativa.
/prof-redes-ingere https://exemplo.com/post-novo python3 tools/stats.py && python3 tools/validar_links.py && python3 tools/validar_citacoes.py
Construir e ensinar; revisar um script que "funciona" mas quebra sem UTF-8; ingerir uma fonte nova. Os resultados vão em testes/aceitacao/RESULTADOS.md.
PYTHONIOENCODING=cp1252 python3 testes/aceitacao/script_emoji.py # → UnicodeEncodeError: o mentor precisa prever isso antes de rodar
Saídas reais do exemplo que vem no kit, e o portão em ação.
tipo itens palavras meta blog 1 123 ≥1 itens / ≥100 pal. posts 1 73 ≥1 itens / ≥50 pal. video 1 145 ≥1 itens / ≥100 pal. TOTAL 3 341 OK: acervo dentro das metas
7 regras (4 ativas), 12 citações encontradas, 0 faltando
OK
# com uma citação inventada:
7 regras (4 ativas), 11 citações encontradas, 1 faltando
REPROVADO{"decision": "block",
"reason": "Você escreveu código e não rodou: calc.py.
Rode cada um (ou os testes) e mostre a saída real
antes de dizer que funciona."}
Listar ou abrir o arquivo (ls, cat), git commit ou py_compile não contam como execução.
| passo | rodou | saiu | regra |
|------------------|--------------------|--------------------|--------|
| menor versão | contar('a b a') | {'a': 2, 'b': 1} | R2 |
| previsão × saída | o mesmo | bateu | R3, R4 |
| versão quebrada | 'a b'.split(' ') | ['a', '', 'b'] | R5 |A documentação completa está no repositório: plano da solução, plano de treinamento e guia de adaptação.