Kit abierto para Claude Code
El método de un experto convertido en tu mentor
Enseña construyendo, revisa antes de entregar y solo dice "funciona" después de ejecutar. Cada regla apunta a un fragmento real de lo que el experto publicó.
Enseña construyendo, revisa antes de entregar y solo dice "funciona" después de ejecutar. Cada regla apunta a un fragmento real de lo que el experto publicó.
Cuando le pides a una IA que te explique algo, suele explicar de más, parecer segura sin estarlo, suponer cosas sin avisar y responder en genérico. Este kit arma un mentor que enseña a la manera de alguien que admiras, con prueba para cada paso.
Todo lo que el experto publicó (videos, textos, repositorios, posts) se convierte en una wiki interconectada que la IA consulta sin perderse en el pajar.
Cada regla de conducta lleva un fragmento copiado del acervo y el lugar exacto de donde salió. Un script rechaza la cita inventada.
El mentor sigue un paso a paso fijo, y una compuerta automática no deja terminar el turno si se escribió código y no se ejecutó.
Cada fase tiene un comando que responde "¿terminó?" con exit 0 o con el motivo de la reprobación. Nada depende de que la IA diga que acabó.
raw/ es de solo lectura, con manifiesto y hash de cada ítem. La wiki tiene páginas de fuentes, temas, principios y métodos, además de index, hot y log.
activa exige 2 fuentes distintas; banco espera la 2.ª; inferencia se le avisa al usuario. La comparación ignora mayúsculas, acentos y puntuación.
Listo → Versión mínima → Predicción → Salida real → Versión rota → Informe con la regla que guio cada paso.
Los scripts usan solo la biblioteca estándar de Python. Nada de API de pago.
Para el generador, los recolectores y los validadores.
python3 --version git --version
Donde corren el agente, las skills y la compuerta.
claude --versionyt-dlp para subtítulos de video y un transcriptor local (Whisper, faster-whisper…) para videos sin subtítulos. pytest solo para probar el kit.
yt-dlp --versionComandos reales del kit. Cambia prof-redes por el nombre corto de tu mentor.
El ejemplo es una experta ficticia con 3 fuentes y 7 reglas, que pasa todos los 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
Genera la carpeta con el acervo, la wiki, las reglas, los scripts, el agente, las 6 skills y la compuerta de ejecución.
python3 novo-mentor.py prof-redes \ --nome "Nombre del experto" \ --dominio "enseñar redes neuronales construyendo desde cero" \ --destino ~/mentores
En ESCOPO.md van las fuentes. En mentor.config.json van las metas de recolección, los idiomas de subtítulos y tu transcriptor (ver docs/ADAPTAR.md (en portugués)).
cd ~/mentores/mentor-prof-redes # en mentor.config.json, por ejemplo: "transcrever_cmd": "seu-transcritor --url {url} --out {saida}"
En Claude Code, dentro de la carpeta del mentor. Un subagente por fuente, en paralelo. Lo que falle va a raw/RELATORIO-FALHAS.md.
/prof-redes-coletar # listo cuando: python3 tools/stats.py # → exit 0 (metas cumplidas, raw intacto)
La wiki enlaza fuentes, temas, principios y métodos en ambos sentidos. Las reglas salen con un fragmento copiado del acervo.
/prof-redes-compilar python3 tools/validar_links.py # → 0 enlaces rotos /prof-redes-regras python3 tools/validar_citacoes.py # → 0 faltantes
ensina construye contigo y verifica la respuesta por fuera. revisa predice dónde se rompe, lo reproduce y prueba la versión depurada lado a lado.
/prof-redes-ensina enséñame a hacer un tokenizador BPE desde cero /prof-redes-revisa scripts/coleta.py python3 tools/validar_resposta.py testes/respostas/<arquivo>.md
Un enlace nuevo se convierte en página de fuente, actualiza las páginas afectadas y puede promover una regla de banco a activa.
/prof-redes-ingere https://exemplo.com/post-novo python3 tools/stats.py && python3 tools/validar_links.py && python3 tools/validar_citacoes.py
Construir y enseñar; revisar un script que "funciona" pero se rompe sin UTF-8; ingerir una fuente nueva. Los resultados van en testes/aceitacao/RESULTADOS.md.
PYTHONIOENCODING=cp1252 python3 testes/aceitacao/script_emoji.py # → UnicodeEncodeError: el mentor debe preverlo antes de ejecutar
Salidas reales del ejemplo que viene en el kit, y la compuerta en acción. Salidas mostradas tal como las imprime el kit (en portugués).
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
# con una cita 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 o abrir el archivo (ls, cat), git commit o py_compile no cuentan como ejecución.
| 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 |La documentación completa está en el repositorio: plan de la solución, plan de entrenamiento y guía de adaptación.