🚀 Proyecto 1: migrar tu primer proyecto real

Objetivo: crear el ~/.codex/AGENTS.md a partir del CLAUDE.md global, con revisión humana en medio.

# 1. generar las propuestas (no sobrescribe nada)
cd ~/projetos/agente-claude-codex
scripts/adapt-instructions.sh ~/.claude
# salida esperada: ~/.claude/AGENTS.proposto.md (71 líneas) y ~/.claude/CLAUDE.proposto.md (7 líneas)

# 2. revisar (abre los dos, corrige lo que el grep hizo mal)
less ~/.claude/AGENTS.proposto.md
less ~/.claude/CLAUDE.proposto.md

# 3. grabar: lo portátil va a Codex Y queda junto al CLAUDE.md para ser importado
cp ~/.claude/AGENTS.proposto.md ~/.codex/AGENTS.md
cp ~/.claude/AGENTS.proposto.md ~/.claude/AGENTS.md
cp ~/.claude/CLAUDE.md ~/.claude/CLAUDE.md.bak-$(date +%Y%m%d)   # backup antes de reemplazar
cp ~/.claude/CLAUDE.proposto.md ~/.claude/CLAUDE.md
rm ~/.claude/*.proposto.md

Cómo verificar: head -1 ~/.claude/CLAUDE.md muestra @AGENTS.md; wc -l ~/.codex/AGENTS.md da alrededor de 71.

Objetivo: medir el CLAUDE.md del piloto y separar lo que es instrucción de lo que es depósito, antes de ejecutar el adaptador.

P=~/projetos/<seu-piloto>
wc -l $P/CLAUDE.md
# encabezados: el mapa de lo que hay adentro
grep -nE '^#{1,3} ' $P/CLAUDE.md
# candidatos a salir: historial, lessons, decisiones, fechas
grep -cniE 'lesson|corrigido em|decidi|fase [0-9]|20[0-9]{2}-[0-9]{2}' $P/CLAUDE.md

Cómo verificar: si el segundo grep devuelve decenas de líneas, tienes un depósito. Meta después de la limpieza: AGENTS.md por debajo de 100 líneas, y cada sección eliminada con un destino nombrado en context/.

Objetivo: aplicar el kit completo en el piloto, en una sesión, sin sobrescribir nada.

K=~/projetos/agente-claude-codex
P=~/projetos/<seu-piloto>
cd $K

# 1. diagnóstico (solo lectura)
scripts/doctor.sh && scripts/audit.sh

# 2. instrucciones: genera *.proposto.md junto al CLAUDE.md del piloto
scripts/adapt-instructions.sh $P
#    ... revisar + limpieza (tema 3) ...
mv $P/AGENTS.proposto.md $P/AGENTS.md
cp $P/CLAUDE.md $P/CLAUDE.md.bak-$(date +%Y%m%d) && mv $P/CLAUDE.proposto.md $P/CLAUDE.md

# 3. núcleo portátil (lista [criado] y [mantido])
scripts/init-core.sh $P
#    completar: $P/context/overview.md, $P/tasks/current.md

# 4. solo si hay una skill local en el piloto
ls $P/.claude/skills 2>/dev/null

# 5. verificación mínima del núcleo
bash $P/scripts/check.sh

Cómo verificar: check.sh imprime [ok] para los 7 archivos obligatorios. head -1 $P/CLAUDE.md muestra @AGENTS.md. El .bak existe.

Objetivo: obtener las dos respuestas y juzgar si citan los archivos correctos.

cd ~/projetos/agente-claude-codex
scripts/readback-test.sh ~/projetos/<seu-piloto> both
# guarda: relatorios/readback-claude-AAAA-MM-DD.md y readback-codex-AAAA-MM-DD.md

# qué buscar en las respuestas
grep -cE 'AGENTS.md|tasks/current|handoffs/latest|context/' relatorios/readback-*-$(date +%F).md

Cómo verificar: las dos respuestas citan AGENTS.md, tasks/current.md y handoffs/latest.md, y la "próxima acción" coincide con lo que escribiste en tasks/current.md. Si un runtime responde de memoria genérica sin citar ningún archivo, falló.

Objetivo: cerrar con handoff y commit, en un solo bloque.

P=~/projetos/<seu-piloto>
cd $P
# handoff: completa las secciones de la plantilla (qué cambió, checks ejecutados y resultado, próxima acción exacta)
$EDITOR handoffs/latest.md
# el piloto ahora usa el núcleo: registra en tasks/current.md que la aceptación pasó
$EDITOR tasks/current.md

git add AGENTS.md CLAUDE.md context tasks handoffs scripts
git -c user.name=inematds -c user.email=inematds@gmail.com commit -m "workspace portátil: AGENTS.md + núcleo (context/tasks/handoffs); readback aprobado en Claude y Codex"
git push
git status -sb | head -1   # esperado: ## main...origin/main

Cómo verificar: abre mañana una sesión nueva en Codex dentro del piloto y pide "lee handoffs/latest.md y dime la próxima acción". Si responde la misma frase que escribiste, el ciclo se cerró.