Mapa de la ruta de aprendizaje
Contenido detallado
🎚️ Modelo adecuado, la cuota rinde
El ROTEAMENTO.md: cuatro niveles de modelo en Claude Code, Codex y Ollama, y cuatro reglas para gastar menos cuota sin perder calidad.
Cada llamada consume la cuota de tu suscripción, el límite de uso por período. No es un cobro por uso, como en la API.
Usar siempre el modelo más potente agota la cuota antes de tiempo y bloquea el trabajo del día.
Cuota, suscripción, API, consumo por llamada.
La tabla de ROTEAMENTO.md: cuándo usar cada nivel y qué modelo corresponde a cada uno en Claude Code, Codex y Ollama (local, gratis).
Con la tabla a mano, eliges el modelo según la tarea, no por costumbre.
Nivel del modelo, esfuerzo, modelo local, Ollama.
La regla 1: la clasificación, el formato y la revisión van al modelo más pequeño; subes de nivel solo cuando se equivoca.
La mayoría de las tareas cotidianas caben en los niveles inferiores, y queda cuota disponible para lo difícil.
Lo mínimo que lo resuelve, subir de nivel, triaje.
La regla 3: la revisión de otro modelo, como Codex mediante el puente de la receta R1, detecta errores que el mismo modelo no ve.
Un modelo tiende a estar de acuerdo consigo mismo; una segunda mirada rompe ese punto ciego.
Segunda opinión, puente codex-exec, punto ciego.
Las reglas 2 y 4: un equipo de agentes solo cuando el trabajo justifica el costo de formarlo, y un agente dentro de otro agente lleva las instrucciones del proyecto.
Usar un equipo para una tarea pequeña solo multiplica el consumo; una carpeta reducida o el modo --bare hacen más ligeros los puentes sencillos.
Costo de armar el equipo, carpeta compacta, --bare.
Verifica los nombres de los modelos con claude --help y codex --help y actualiza la tabla de ROTEAMENTO.md.
Los modelos cambian de nombre y se reemplazan; una tabla antigua hace que el agente solicite un modelo que ya no existe.
--help, nombre de modelo, tabla vigente.
👥 Equipo de tres roles
La receta R2: planificador, ejecutor y revisor, cada uno con el modelo que necesita, trabajando en una sola sesión de Claude Code.
Tres subagentes de Claude Code: el planificador (potente) planifica, el ejecutor (medio) hace y el revisor (ligero) verifica.
Cada rol usa el modelo que necesita, y la cuota rinde más que con un modelo potente que lo haga todo.
Subagente, rol, planificador, ejecutor, revisor.
Los tres archivos de .claude/agents/, con el nombre, la descripción, el modelo, las herramientas y las instrucciones de cada rol.
Al leer los archivos, entiendes qué puede hacer cada rol: el planificador y el revisor solo leen; el ejecutor modifica (N3).
Archivo de papel, model:, herramientas, N3.
Abrir claude en la carpeta y pedirle al equipo que cree saudacao.txt con la frase «Hola, comunidad INEMA».
Es la forma más fácil de ver los tres roles trabajando en secuencia, con el revisor cerrando con APROBADO.
Sesión interactiva, prueba, APROBADO.
El mismo pedido en un solo comando, con claude -p, que termina con la respuesta del revisor.
Sin pantalla, se puede llamar al equipo mediante un script; la prueba del kit costó el equivalente a ~US$ 0,73 de API, que con la suscripción es cuota.
-p, ejecución sin pantalla, cat saudacao.txt, cuota.
Cambia la tarea: Sônia resume el CSV del ERP mientras el revisor verifica los totales; Clara enumera los horarios disponibles y el revisor verifica que no aparezca ningún horario ocupado.
El equipo solo vale la pena cuando resuelve tu trabajo real, con una revisión que entiendes.
Tarea real, verificación, totales, horario ocupado.
Editar la línea model: de un rol (haiku, sonnet, opus o inherit) y copiar un archivo de .claude/agents/ para crear un nuevo rol.
El equipo se adapta a tu caso sin programar: solo tienes que editar el texto.
model:, inherit, papel novo, descrição.
🧵 Equipo en segundo plano
La receta R4: varias sesiones con claude --bg, cada una con nombre, modo y modelo, supervisadas por observar.mjs.
La versión oficial de lo que los videos sobre extensiones llamaban "Threads": sesiones que trabajan solas, en segundo plano.
Es un comando documentado: no se rompe con la próxima actualización como el hilo improvisado de los videos.
Sesión, segundo plano, id, vía oficial.
Abrir claude en la carpeta una vez y cambiar la opción «No, exit» por «Yes, I trust this folder».
Sin esto, --bg responde Workspace not trusted y no se inicia ninguna sesión.
Carpeta confiable, aviso de confianza, Workspace not trusted.
Dos líneas de comandos: un revisor en modo de planificación, que solo lee, y un ejecutor con sonnet, que crea resumo.md.
Nombre, modo y modelo por sesión aplican la POLITICA y el ROTEAMENTO; y Claude rechaza -p junto con --bg.
--bg, --permission-mode plan, --model, --name.
observar.mjs muestra el id, el tipo, el nombre, el estado y la antigüedad de cada sesión de esta carpeta (o de todas, con --todas).
En segundo plano nadie ve si una sesión se bloquea; la columna estado muestra working, idle, done, blocked o failed.
observar.mjs, estado, blocked, --todas.
Tres comandos con el id de la tabla: claude logs lee la pantalla, claude attach entra en la sesión y claude stop la detiene.
Desbloqueas un blocked, lees la respuesta de un done y detienes una sesión que solo consume cuota.
logs, attach, stop, /painel.
Cada sesión guarda un archivo y una sesión principal (o el equipo de la R2) consolida y revisa todo al final.
Cada sesión consume cuota: empieza por la R2 y solo inicia sesiones paralelas cuando el trabajo lo justifique.
Archivo por sesión, sesión principal, consolidar, cuota.
🎯 Agente de larga duración con verificación
La receta R6: un goal con criterios de comando → salida, verificar.mjs como juez y puntos de aprobación humana escritos en el propio goal.
En tareas de varias horas, el agente pierde detalles y declara "listo" antes de tiempo; la R6 solo da por terminado el trabajo cuando los criterios lo demuestran.
El error que se descubre recién al usarlo cuesta más que una verificación automática en cada etapa.
Goal, criterio, salida 0 y 1, puerta humana.
Una línea de lista por criterio, con el comando y el texto esperado entre comillas invertidas, separados por una flecha.
Un buen criterio es de sí o no e imposible de superar sin hacer el trabajo; "dejarlo bien" no es un criterio.
Criterio verificable, texto esperado, goal de ejemplo.
Ejecutar verificar.mjs en el goal de ejemplo, que comprueba el puente de la agenda de Clara, el total de Sônia y el doctor.
El script no llama a ningún modelo ni consume cuota: pruebas al juez antes de entregarle el goal al agente.
verificar.mjs, OK, conteo, salida 0.
Cambiar un valor esperado en una copia del goal y ver cómo la línea pasa a FALLO, con salida 1, como se demuestra en el CHANGELOG 0.2.0.
Un juez que nunca rechaza no sirve; confirmas que detecte el error.
Copia del goal, FALHA, esperado, salida 1.
El pedido /goal de la R6: cumplir el goal, ejecutar el verificar después de cada etapa y detenerse solo cuando todo esté OK o ante una instancia de aprobación humana.
Funciona en Claude Code y en Codex, porque el juez es el mismo script para ambos.
/goal, ciclo de hacer-verificar-corregir, ejecución prolongada.
Frases de parada escritas en el goal para gastar, enviar, borrar y publicar, y una línea en FALHAS.md o en LIMITES.md por cada problema.
Un agente que persigue el OK durante horas no puede decidir por sí solo qué es irreversible.
Puerta humana, límite de la POLITICA, FALHAS.md, LIMITES.md.