🎭 Copie o método, não a voz
A tentação, quando se fala em "mentor de um especialista", é fazer a IA falar como ele: os bordões, o jeito de cumprimentar, as piadas. Isso é a parte menos útil e a mais arriscada. O que ensina é o método: a ordem em que ele ataca um problema, o que ele confere antes de dizer que acabou, como ele depura.
🆕 Novo aqui?
Persona é uma personagem: a IA fingindo ser alguém, com nome, voz e opinião dessa pessoa. Método é o conjunto de comportamentos que se repetem quando a pessoa trabalha, como "sempre define o critério de pronto antes de começar". O kit copia só o segundo.
Como ler: o mesmo acervo entra no filtro e sai por dois caminhos. A seta verde contínua vai para o mentor: são comportamentos que dá para citar e conferir. A seta ciano tracejada é descartada de propósito: imitar a pessoa não ensina nada e cria um risco que o método não tem.
✓ Método (entra)
- ✓"Confere o resultado real antes de dizer pronto"
- ✓"Define o critério de pronto e de aborto antes de começar"
- ✓"Começa mínimo e corta o que não paga o custo"
✗ Persona (fica fora)
- ✗Responder em primeira pessoa como se fosse ele
- ✗Imitar bordões e o jeito de falar
- ✗Publicar texto em nome da pessoa
Método
Comportamento que se repete
Persona
Personagem, fica fora
Citável
Método tem prova no acervo
Sem risco
Nada em nome da pessoa
🚧 Decida o que entra e o que fica fora
O escopo tem duas metades e as duas são escritas. A de dentro diz para que o mentor serve. A de fora é a fronteira: o que ele não toca nem que alguém peça. Escrever o "fora" é o que impede o mentor de virar, aos poucos, uma imitação da pessoa.
| Entra | Fica fora |
|---|---|
| Ensinar construindo junto | Opiniões pessoais e políticas |
| Revisar trabalho antes de entregar | Vida privada |
| Conteúdo público, respeitando os termos de cada plataforma | Qualquer coisa que faça o mentor parecer a própria pessoa |
| Uso educacional e de estudo | Distribuir o acervo coletado sem autorização de quem o escreveu |
⚠️ Uso responsável, sem exceção
O mentor nunca se apresenta como a pessoa nem publica texto em nome dela. Esta frase está no README do kit e no CLAUDE.md que cada mentor recebe ("Copia o método, não a persona"). Se você for publicar o acervo de alguém, como o piloto publicou o do Nei, precisa da autorização da pessoa.
💸 Também fica fora: custo escondido
O kit não chama nenhuma API paga. Fontes sem coletor automático (posts de redes sociais, PDFs, notas) entram por exportação manual com coletar_arquivo.py. Isso também é escopo: decidir antes que o mentor não vai gerar conta.
Para que serve
Ensinar e revisar
Fora do escopo
Fronteira escrita
Público
Só conteúdo aberto
Sem API paga
Exportação manual
🎯 Escreva o domínio numa frase estreita
O domínio é a frase que diz o que o mentor ensina. Ela vai para o ESCOPO.md,
para o mentor.config.json e para o texto do agente. Quanto mais larga, mais o
mentor volta ao conhecimento genérico, porque nenhum acervo cobre "tudo". Estreita quer dizer:
um assunto, um jeito de ensinar, um público.
Como ler: cada nível do funil acrescenta uma restrição. O topo ciano tracejado é o que o kit chama de ruim; o fundo verde é a frase que um acervo de 20 a 50 fontes consegue sustentar. Se o seu domínio ainda cabe no meio do funil, falta uma restrição.
✓ Bom
- ✓"ensinar redes neurais construindo do zero"
- ✓"ensinar automação com Claude Code para iniciantes"
- ✓"ensinar a usar Claude Code e agentes de IA na prática, construindo junto" (o do piloto)
✗ Ruim
- ✗"tudo o que a pessoa sabe"
- ✗"tudo sobre IA"
- ✗Frase com quebra de linha (o gerador recusa: "--nome e --dominio devem ter uma linha só")
🧪 Exercício copiável: aperte o seu domínio
Objetivo: sair com uma frase que passa no critério da fase 0 do kit ("domínio em 1 frase"). Cole no Claude Code.
Quero montar um mentor no método de <nome do especialista>. Meu rascunho de domínio é: "<sua frase>". Avalie em 3 critérios: (1) é UM assunto, (2) diz COMO ele ensina, (3) diz PARA QUEM. Para cada critério que falhar, proponha uma restrição. Devolva 3 versões da frase, todas numa linha só, da mais larga para a mais estreita, e diga qual um acervo de 20 a 50 fontes consegue cobrir.
Como verificar: a frase escolhida tem uma linha, cabe no funil de baixo e você consegue nomear pelo menos 5 fontes públicas do especialista sobre ela. Se não consegue, ela ainda está larga ou o especialista é outro.
Um assunto
Não "tudo sobre"
Um jeito
"construindo junto"
Um público
"para iniciantes"
Uma linha
Regra do gerador
🧑🏫 Escolha o especialista pelos critérios certos
Fama não é critério. O especialista bom para virar mentor é o que deixou material suficiente, ensina de um jeito que se reconhece e trabalha num domínio que você entende o bastante para julgar. Se faltar o terceiro, você não vai saber se o mentor acertou: e aí volta o hábito do "parece certo".
Como ler: são três portas em série, e todas precisam abrir. A seta ciano de cada uma leva ao mesmo lugar: não insista num especialista que falha em qualquer porta. A terceira é a que mais se esquece e a que mais importa, porque é ela que permite você dar nota ao mentor no fim.
🪞 A opção forte: você mesmo
Se você publica aulas, lives ou guias, você pode ser o especialista. Não há questão de direitos e o mentor vira a voz didática da sua marca. Foi o que o piloto fez: o especialista é o próprio Nei, com o conteúdo público dele, e o mentor completo está aberto em inematds/mentor-nei.
Bônus: só você sabe julgar com segurança se "reconheço a pessoa nas regras". No piloto, essa nota foi 8.
| Tipo de fonte | Quantidade sugerida para o piloto |
|---|---|
| Vídeos (de preferência com legenda) | 10–20 |
| Textos (blog, newsletter, docs) | 5–15 |
| Repositórios | 1–3 |
| Exportação manual (posts) | 1, se houver |
| Total | 20–50 itens; para treinar, cerca de 50 mil palavras |
Material
Texto ou legenda
Reconhecível
"Sempre faz X"
Julgável
Você sabe avaliar
Você mesmo
Sem questão de direitos
⚙️ Gere o seu mentor com novo-mentor.py
Você não monta o mentor do zero. O kit traz um gerador que copia o template/ para
uma pasta nova, troca os marcadores pelo nome, slug e domínio que você passou e cria as pastas vazias do acervo e da wiki.
Leva segundos. O trabalho de verdade começa depois, nas trilhas seguintes.
🆕 Novo aqui?
Slug é o apelido técnico do mentor: letras minúsculas, números e hífen, como prof-redes. Ele vira o nome da pasta (mentor-prof-redes) e o prefixo dos comandos (/prof-redes-ensina). Flag é a opção com dois hífens que vai depois do comando, como --nome. Template é o projeto-modelo que o gerador copia.
🧪 Copie e rode: o primeiro mentor
Objetivo: gerar o projeto do seu mentor e colocá-lo no git, para enxergar o que cada fase muda depois. Troque o que está entre < >.
cd mentor-especialista # a pasta do kit que você clonou no módulo 1.1 git pull python3 novo-mentor.py <slug> \ --nome "<Nome do especialista>" \ --dominio "<domínio em uma frase>" \ --destino ~/mentores cd ~/mentores/mentor-<slug> git init -q && git add -A && git commit -qm "mentor <slug>: projeto gerado" ls .claude/agents .claude/skills; ls .claude/settings.json
Como verificar: o último comando mostra <slug>-mentor.md em agents, 6 pastas em skills (coletar, compilar, regras, ensina, revisa, ingere) e o settings.json, que registra o portão de execução. A saída do gerador, rodado com prof-redes, termina assim:
Próximos passos:
1. cd ~/mentores/mentor-prof-redes
2. Preencha ESCOPO.md (fontes) e ajuste mentor.config.json (metas, transcritor)
3. Abra o Claude Code nessa pasta e rode, em ordem:
/prof-redes-coletar
/prof-redes-compilar
/prof-redes-regras
4. Use: /prof-redes-ensina <dúvida> /prof-redes-revisa <arquivo> /prof-redes-ingere <link>
| Se aparecer… | Significa | Faça |
|---|---|---|
| slug inválido: use letras minúsculas, números e hífen | Maiúscula, espaço ou sublinhado no slug | Troque Prof_Redes por prof-redes |
| já existe: … (use --forcar …) | A pasta do mentor já foi criada | Não force sem pensar: --forcar apaga a pasta inteira |
| --nome e --dominio devem ter uma linha só | Quebra de linha no nome ou no domínio | Volte ao tópico 3: uma frase, uma linha |
Slug
Pasta + prefixo dos comandos
Template
Copiado e preenchido
6 skills
Já vêm prontas
git init
Para ver cada fase
📋 Leia o ESCOPO.md do piloto e preencha o seu
O ESCOPO.md é a primeira coisa que você preenche no mentor gerado, e o critério
da fase 0 é simples: domínio em 1 frase, pelo menos 5 fontes listadas, metas definidas. Veja como ficou o do piloto,
e o que aconteceu quando as metas encontraram a realidade.
📄 ESCOPO.md do mentor do Nei (tabela de fontes condensada)
## Domínio (uma frase, estreita) Ensinar a usar Claude Code e agentes de IA na prática, construindo junto. ## Para que o mentor serve - [x] Ensinar construindo junto - [x] Revisar trabalho antes de entregar ## Fontes | tipo | origem | coletor | |-------|---------------------------|----------------------------| | video | (14 lives do canal) | coletar_video.py | | guia | (6 guias publicados) | coletar_web.py --tipo guia | ## Metas de coleta video ≥ 10 itens / 60000 palavras; guia ≥ 5 itens / 8000 palavras.
20 fontes listadas no início
14 lives e 6 guias. Domínio numa frase, para que serve marcado, metas no mentor.config.json.
A meta de guia reprovou
Os 6 guias somaram 7.269 palavras, abaixo da meta de 8.000. Guias INEMA têm cerca de 900 a 1.400 palavras cada. O agente reportou exit 1 sem maquiar e sugeriu fontes extras.
+1 guia, coleta aprovada
Com um guia a mais e a transcrição local da live sem legenda: 21 itens, 187.382 palavras, exit 0.
22 fontes no acervo final
Depois da ingestão de mais um guia: 14 lives + 8 guias, cerca de 189 mil palavras.
💡 A lição do passo 2
Calibre a meta depois de listar as fontes, pelo tamanho real delas. Meta chutada reprova o acervo certo. A correção virou parte do kit 1.2: o stats.py agora diz quanto falta para cada meta.
🧪 Copie e cole no Claude Code: preencha o seu ESCOPO.md
Objetivo: sair da fase 0 com o escopo pronto. Abra o Claude Code dentro de ~/mentores/mentor-<slug> e cole:
Preencha o ESCOPO.md deste mentor. Fontes (uma por linha): <cole aqui as URLs ou arquivos, de 20 a 50, misturando tipos> Para cada fonte, preencha tipo e coletor seguindo a tabela-modelo do próprio ESCOPO.md. Não invente fontes. Mantenha a seção "Fora do escopo". Depois, sugira metas_coleta para o mentor.config.json com base no tamanho provável de cada tipo, e me mostre o diff antes de salvar o config.
Como verificar: rode grep -c '^| ' ESCOPO.md. O número deve ser o de fontes mais 1 (a linha de cabeçalho; o separador |---| não conta) e as fontes devem ser pelo menos 5. Confira também que o domínio continua em uma linha. Depois, git commit -am "escopo".
Checagem rápida (não bloqueia nada): a coleta reprovou porque os guias ficaram abaixo da meta de palavras. O que o piloto mostrou ser o certo?
Fase 0
1 frase · ≥5 fontes · metas
Metas reais
Calibrar depois de listar
Sem maquiar
Exit 1 é informação
20 → 22
O acervo cresce depois
📌 Resumo do Módulo
Próxima Trilha:
Trilha 2 - Coleta do acervo: fontes, coletores, subagentes em paralelo e o relatório de falhas.