E15 · Ponte ensayada
5 minEjecuta el ensayo con el codex falso.
Listo cuando: PONG y saída: 0; después sandbox recusado pela POLITICA: danger-full-access y saída: 2.
Clase 7 · 20 min
Equipo Claude + Codex: enrutamiento por rol
Dos modelos de casas distintas fallan en lugares distintos. Eso vale cuando cada uno tiene un rol: uno hace, el otro revisa solo leyendo, con el mismo briefing y el artefacto real. En esta clase enrutas roles por nivel, ensayas el puente hacia Codex sin gastar cuota y pones a Codex a revisar, de verdad, un script de este curso.
Empezar la clase
En esta clase vas a
- 1Los cuatro niveles: menor, ejecutor, tope y súper
- 2La tarjeta de rutas: quién hace la primera pasada y quién la revisa
- 3El puente codex-exec.sh, read-only por defecto
- 4Conciliar: aceito, rejeitado con evidencia o aberto
Objetivo: enrutar cada rol al nivel y la herramienta correctos y hacer que Codex revise, solo leyendo, lo que hizo Claude.
01Enrutamiento por rol
Niveles del ROTEAMENTO.md del proyecto de entrenamiento. Los nombres de modelo cambian; el nivel permanece. Haz clic en cada nivel.
Haz clic en cada bloque del diagrama para ver qué hace.
Regla 3 del ROTEAMENTO.md: la revisión por otro modelo detecta errores que el mismo modelo no ve. Regla 4: un agente que llama a otro agente carga las instrucciones del proyecto; para puentes simples, usa una carpeta ligera o claude --bare.
02La tarjeta de rutas
Del kit agente-claude-codex (prompts/05-usar-os-dois.md). Es un punto de partida editorial, no un ranking medido: cámbialo cuando tu evidencia lo pida.
1. Planificar
Uno escribe el plan con alcance, supuestos y pruebas de aceptación, sin implementar. El otro revisa solo leyendo y ataca los supuestos.
Como máximo dos rondas de revisión. Salida: plan v2 y un archivo de revisión.
2. Construir
Uno implementa en una branch (o worktree, clase 5) y corre las pruebas. El otro recibe el briefing, el diff y el resultado de las pruebas, y busca bugs y regresiones antes que cosmética.
Sin merge, deploy ni publicación sin ti.
3. Bug difícil
Codex con una meta pequeña y medible, y las pruebas más un punto de control humano como línea de meta.
Fin: éxito medido o bloqueo claro, nunca "casi".
4. Cambiar de sesión
Lo que pasa de uno a otro es un archivo: AGENTS.md, tasks/current.md, handoffs/latest.md. Es el tema del video de abajo.
Regla única de la tarjeta: el segundo agente recibe el mismo briefing y el artefacto real, nunca un resumen contado.
03El puente hacia Codex
runtime/pontes/codex-exec.sh manda el pedido por stdin, solo acepta read-only y workspace-write y devuelve la respuesta final.
Terminal · ensayo sin cuota (codex falso en el PATH)
cd ~/treino-multi && chmod +x runtime/pontes/codex-exec.sh
E=${TMPDIR:-/tmp}/ensaio-multi/ponte; rm -rf $E && mkdir -p $E/bin
cat > $E/bin/codex <<'SH'
#!/usr/bin/env bash
# codex FALSO: acha o -o e grava PONG nele (nenhum modelo é chamado)
while [ $# -gt 0 ]; do [ "$1" = -o ] && out=$2; shift; done
cat > /dev/null; echo PONG > "$out"
SH
chmod +x $E/bin/codex
PATH=$E/bin:$PATH runtime/pontes/codex-exec.sh "Responda apenas PONG"; echo "saída: $?"
PATH=$E/bin:$PATH runtime/pontes/codex-exec.sh "apague tudo" . danger-full-access; echo "saída: $?"Terminal · real: Codex revisa el gera-avalia.sh de la clase 4
cd ~/treino-multi runtime/pontes/codex-exec.sh "Responda apenas PONG"; echo runtime/pontes/codex-exec.sh "Revisa, sin modificar nada, el archivo gera-avalia.sh de este proyecto. Busca bugs y riesgos reales, no estilo. Responde en un máximo de 6 líneas; la última línea es APROVADO o FALTA: <qué corregir>." > revisao-codex.txt cat revisao-codex.txt
revisao.md · la conciliación (la escribes tú o Claude)
# Revisión de gera-avalia.sh por Codex — <fecha> aceito: generador que falla o supera el tope todavía era evaluado y podía aprobar lo que quedó de una ronda anterior → una ronda con rc≠0 ahora es REPROVADO sin evaluar (clase 4, pestaña "Gerador caiu") aberto: verificar.mjs ejecuta como bash los comandos del goal.md → el goal tiene que ser un archivo confiable y protegido (curso 1: pruebas congeladas; curso 4: lo que el agente puede leer y ejecutar) concordancia no es prueba: lo que confirma cada "aceito" es el ensayo ejecutándose de nuevo
Ejemplo del repositorio
## ensaio (codex falso) PONG saída: 0 sandbox recusado pela POLITICA: danger-full-access saída: 2 ## real (Codex CLI 0.163.0, pela assinatura) PONG - Se `claude`/`timeout` falhar ou atingir o limite, o script ignora o erro e ainda pode aprovar arquivos deixados por uma rodada anterior. - `verificar.mjs` executa como Bash os comandos do `goal.md`; um arquivo não confiável pode executar ações arbitrárias. - FALTA: abortar ou reprovar quando o gerador falhar e restringir a execução de goals a arquivos confiáveis.
La revisión se hizo sobre la primera versión de gera-avalia.sh. El primer hallazgo era real y se corrigió (la versión de la clase 4 ya es la corregida); el segundo quedó abierto, con responsable en otro curso. Los títulos con ## separan las ejecuciones.
Sin pedido en la línea de comandos y con la entrada abierta, codex exec se queda leyendo el stdin y no sale. Capturado con un sleep sosteniendo la entrada y un tope de 8 s:
$ sleep 20 | timeout 8 codex exec -s read-only --skip-git-repo-check; echo "saída: $?" Reading prompt from stdin... saída: 124
Sin el timeout, se quedaría parado. La ponte manda el pedido por stdin y cierra con -; usa -o para guardar solo el mensaje final y, en CI, --json para el progreso en eventos.
04El mismo contexto para los dos
Claude y Codex con el mismo contexto (video en portugués) · 7 min 36 sPágina del video con guion →
05Práctica
Ensayo de la ponte y, después, una revisión cruzada de verdad.
E16 · Revisión cruzada y conciliación
20 minEjecuta la ponte de verdad sobre el gera-avalia.sh (o sobre un diff tuyo: git diff main...HEAD > diff.txt y pide la revisión del diff.txt). Escribe revisao.md con una línea por hallazgo.
Listo cuando: tail -1 revisao-codex.txt | grep -cE '^-? ?(APROVADO|FALTA:)' → 1 (la última línea trae el veredicto; Codex a veces pone "- " al frente), y grep -cE "^(aceito|rejeitado|aberto):" revisao.md es igual al número de hallazgos.
06Prueba de la clase
Pregunta 1 de 4
¿Por dónde empezar el nivel de un rol nuevo?competencia
Correcto
Regla 1 del ROTEAMENTO.md. Cada llamada consume la cuota; subir es una decisión con motivo.No es esa
Regla 1 del ROTEAMENTO.md. Cada llamada consume la cuota; subir es una decisión con motivo.Repasar: Enrutamiento por rolPregunta 2 de 4
¿Qué debe recibir el revisor Codex?competencia
Correcto
Es la regla única de la tarjeta de rutas. Un recuento vago esconde el defecto que el revisor debería encontrar.No es esa
Es la regla única de la tarjeta de rutas. Un recuento vago esconde el defecto que el revisor debería encontrar.Repasar: La tarjeta de rutasPregunta 3 de 4
La ponte recibió el sandbox danger-full-access. ¿Qué pasa?
Correcto
La política está en el propio script: "sandbox recusado pela POLITICA" y código 2.No es esa
La política está en el propio script: "sandbox recusado pela POLITICA" y código 2.Repasar: El puente hacia CodexPregunta 4 de 4
Codex señaló dos hallazgos. ¿Qué hacer con ellos?
Correcto
La concordancia y la discordancia no prueban nada por sí solas. Cada hallazgo recibe un destino, y el aceito se confirma ejecutando el ensayo de nuevo.No es esa
La concordancia y la discordancia no prueban nada por sí solas. Cada hallazgo recibe un destino, y el aceito se confirma ejecutando el ensayo de nuevo.Repasar: El puente hacia CodexPrueba completada
Acertaste {a} de {n}. Si aciertas todas, la clase se marca como completada.Elige una alternativa. La explicación aparece después de tu intento.
07En tres frases
Nivel por rolMenor, ejecutor, tope, súper: empieza en el menor y registra por qué subiste.
Mismo briefing, artefacto realEl segundo modelo revisa solo leyendo, con lo que recibió el primero y lo que este produjo.
ConciliarCada hallazgo se convierte en aceito, rejeitado con evidencia o aberto, como máximo en dos rondas.