🚀 Projeto 1: migrar seu primeiro projeto real

Objetivo: criar o ~/.codex/AGENTS.md a partir do CLAUDE.md global, com revisão humana no meio.

# 1. gerar as propostas (não sobrescreve nada)
cd ~/projetos/agente-claude-codex
scripts/adapt-instructions.sh ~/.claude
# saída esperada: ~/.claude/AGENTS.proposto.md (71 linhas) e ~/.claude/CLAUDE.proposto.md (7 linhas)

# 2. revisar (abra os dois, corrija o que o grep errou)
less ~/.claude/AGENTS.proposto.md
less ~/.claude/CLAUDE.proposto.md

# 3. gravar: o portátil vai pro Codex E fica ao lado do CLAUDE.md pra 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 trocar
cp ~/.claude/CLAUDE.proposto.md ~/.claude/CLAUDE.md
rm ~/.claude/*.proposto.md

Como verificar: head -1 ~/.claude/CLAUDE.md mostra @AGENTS.md; wc -l ~/.codex/AGENTS.md dá por volta de 71.

Objetivo: medir o CLAUDE.md do piloto e separar o que é instrução do que é depósito, antes de rodar o adaptador.

P=~/projetos/<seu-piloto>
wc -l $P/CLAUDE.md
# cabeçalhos: o mapa do que tem lá dentro
grep -nE '^#{1,3} ' $P/CLAUDE.md
# candidatos a sair: histórico, lessons, decisões, datas
grep -cniE 'lesson|corrigido em|decidi|fase [0-9]|20[0-9]{2}-[0-9]{2}' $P/CLAUDE.md

Como verificar: se o segundo grep devolve dezenas de linhas, você tem depósito. Meta depois da faxina: AGENTS.md abaixo de 100 linhas, e cada seção removida com um destino nomeado em context/.

Objetivo: aplicar o kit inteiro no piloto, em uma sessão, sem sobrescrever nada.

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

# 1. diagnóstico (somente leitura)
scripts/doctor.sh && scripts/audit.sh

# 2. instruções: gera *.proposto.md ao lado do CLAUDE.md do piloto
scripts/adapt-instructions.sh $P
#    ... revisar + faxina (tópico 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] e [mantido])
scripts/init-core.sh $P
#    preencher: $P/context/overview.md, $P/tasks/current.md

# 4. só se houver skill local no piloto
ls $P/.claude/skills 2>/dev/null

# 5. checagem mínima do núcleo
bash $P/scripts/check.sh

Como verificar: check.sh imprime [ok] para os 7 arquivos obrigatórios. head -1 $P/CLAUDE.md mostra @AGENTS.md. O .bak existe.

Objetivo: obter as duas respostas e julgar se citam os arquivos certos.

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

# o que procurar nas respostas
grep -cE 'AGENTS.md|tasks/current|handoffs/latest|context/' relatorios/readback-*-$(date +%F).md

Como verificar: as duas respostas citam AGENTS.md, tasks/current.md e handoffs/latest.md, e a "próxima ação" bate com o que você escreveu em tasks/current.md. Se um runtime responde de memória genérica sem citar arquivo, falhou.

Objetivo: fechar com handoff e commit, em um bloco.

P=~/projetos/<seu-piloto>
cd $P
# handoff: preencha as seções do template (o que mudou, checks rodados e resultado, próxima ação exata)
$EDITOR handoffs/latest.md
# o piloto agora usa o núcleo: registre em tasks/current.md que o aceite passou
$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 aprovado em Claude e Codex"
git push
git status -sb | head -1   # esperado: ## main...origin/main

Como verificar: abra uma sessão nova no Codex dentro do piloto amanhã e peça "leia handoffs/latest.md e diga a próxima ação". Se ele responder a mesma frase que você escreveu, o ciclo fechou.