O que você vai construir
Um mentor de verdade, para um especialista que você escolhe, numa pasta de projeto do Claude Code. São quatro peças, e cada uma tem um script que diz se ela está pronta.
Acervo + wiki
Tudo o que o especialista publicou, coletado com rastreio e compilado numa wiki interligada que a IA consulta sem se perder.
stats.py e validar_links.py → exit 0
Regras com prova
Cada regra de conduta tem citação e localizador. Uma citação inventada reprova no validador.
validar_citacoes.py → exit 0
Loop obrigatório
Definir pronto → menor versão → prever → rodar → mostrar a versão quebrada → relatório por regra.
validar_resposta.py → exit 0
Portão de execução
Um hook impede o turno de terminar quando houve código escrito e não executado. Vale também para subagentes.
bloqueio + liberação demonstrados
Novo aqui? Um mentor, neste curso, é um subagente do Claude Code com regras próprias e três skills de uso:
/<slug>-ensina (ensina construindo junto), /<slug>-revisa (revisa um arquivo seu em 5 seções) e
/<slug>-ingere (põe material novo do especialista na wiki). Hook é um script que o Claude Code roda sozinho em certos momentos, como no fim de um turno.
Os termos são explicados de novo, com calma, na primeira vez que aparecem em cada módulo.
As 6 trilhas
🤔 Por que um mentor
Os maus hábitos da IA quando ensina, e por que a resposta é copiar o método do especialista, não a voz. Termina com o escopo do seu mentor.
📥 Coleta do acervo
Legenda antes de transcrição, transcritor local, web e repositórios. Subagentes por fonte, manifesto com sha256 e relatório de falhas.
🕸️ Wiki compilada
O raw fica intocado, a wiki é viva. Páginas de fontes, temas, princípios e métodos, com links nos dois sentidos, index, hot e log.
📜 Regras com prova
Regra é conduta recorrente, não frase de efeito. Citação, localizador, status ativa/banco/inferência e um validador que reprova o inventado.
🤖 Agente, skills e portão
settings.json, agente e skills; o loop obrigatório; as skills ensina, revisa e ingere; e o portão de execução que impede o "parece certo".
🏁 Prova e evolução
Os 3 testes de aceitação do piloto real, a lição central (instrução não basta, precisa de mecanismo), ingestão contínua e reuso.
Do piloto real
O curso inteiro segue um piloto de verdade: o mentor do Nei Maldaner, montado com o kit a partir do conteúdo público dele. Os números abaixo são os medidos, com as falhas incluídas.
Placar do piloto
5/5 · nota 8- ✓Fases 1 a 3 com exit 0 (a fase 1 depois de calibrar a meta e somar uma fonte)
- ✓Portão bloqueou certo, sem bloqueio indevido
- ✓Teste 1 passou e ensinou algo novo: teto de bloqueio por sessão num hook Stop
- ✓Teste 2 passou na 4ª rodada (kit 1.3): o portão de previsão negou a execução, o mentor previu e só então rodou. Até o 1.3, era 4/5: reproduzia e provava, mas não escrevia a previsão antes
- ✓Teste 3 atualizou a wiki sozinho: 2 métodos novos e as regras R9 e R10
- ★Nota 8 em "reconheço a pessoa nas regras"
A lição central
No teste 2, mesmo com a instrução explícita "escreva a previsão antes de rodar", o mentor previu só no raciocínio e escreveu "a previsão bateu" depois. A sessão disse "o validador passa", mas tinha rodado o validador sem o log.
Instrução não basta: precisa de mecanismo (o portão de previsão, que o kit 1.3 trouxe) e de verificação de fora (o validador lendo o log da sessão). Na rodada 4, o portão negou a execução, o mentor escreveu a previsão e o validador com o log aprovou: 5/5.
Cada falha do piloto virou correção no kit, e você vê cada uma delas, com o antes e o depois, nos módulos.
Antes de começar
✓ Você precisa de
- ✓Claude Code no básico: abrir numa pasta, conversar e rodar um comando.
- ✓Python 3.10 ou mais novo e git. Os scripts do kit usam só a biblioteca padrão.
- ✓Um especialista para estudar, com 20 a 50 fontes públicas (cerca de 50 mil palavras). Pode ser você mesmo, se publica conteúdo.
- ✓Opcional:
yt-dlppara legendas de vídeo e um transcritor local para vídeos sem legenda.
✗ Este curso não é
- ✗Para quem nunca abriu o Claude Code. Comece por um curso introdutório e volte.
- ✗Clone de voz ou imitação de pessoa. O mentor copia o método, não a persona.
- ✗Dependente de API paga. Coleta por legenda, transcrição local e exportação manual resolvem.
- ✗Leitura passiva. Toda aula termina com uma tarefa e um comando que diz se você acertou.
Projeto final e rubrica
O mentor completo de um especialista à sua escolha. Aprovação com 8 de 10 pontos, e cada critério é conferido por comando ou por demonstração.
O que você entrega
- 1
ESCOPO.md+raw/MANIFESTO.json+raw/RELATORIO-FALHAS.md - 2Wiki com
index,hotelog - 3
regras.mdvalidado - 4Agente e skills ajustados ao domínio
- 5
testes/aceitacao/RESULTADOS.mdcom as 3 tarefas - 6Um vídeo curto ou print do mentor ensinando algo que você não sabia antes
| Critério | Pontos |
|---|---|
Acervo rastreável (stats.py exit 0) | 1 |
Wiki interligada (validar_links.py exit 0) | 1 |
| Regras com citação validada; inferências marcadas | 2 |
Mentor segue o loop, comprovado por validar_resposta.py | 2 |
| Portão funcionando (bloqueio + liberação demonstrados) | 2 |
| 3 testes de aceitação registrados | 1 |
| Ingestão atualiza a wiki sem edição manual + demonstração | 1 |
| Total (aprovação ≥ 8) | 10 |
O kit e o piloto, abertos
Kit Mentor-Especialista
O template, o gerador novo-mentor.py, os coletores, os validadores, o agente, as skills, o portão e um exemplo completo com especialista fictício.
Guia de uso do kit
O passo a passo curto, para consultar durante as trilhas: começo rápido, as cinco fases e os comandos de conferência.
inematds.github.io/mentor-especialista/guia ↗mentor-nei, o piloto
O mentor real usado no curso: acervo, wiki, regras com citação, as respostas dos testes, o diário do piloto e as falhas com a menor correção de cada uma.
github.com/inematds/mentor-nei ↗