🌳 Git worktree: o que é
Worktree é uma pasta paralela com uma branch checked out separadamente do clone original. Cada worktree tem node_modules, build cache, pytest cache próprios.
Comandos essenciais:
# Cria worktree pra branch existente
git worktree add ../proj-feature feature-branch
# Cria worktree + branch nova
git worktree add -b feature/new-api ../proj-new-api
# Lista worktrees
git worktree list
# Remove worktree quando terminou
git worktree remove ../proj-feature📊 Por que isso importa pra AI agents
Sem worktree, trocar de branch invalida cache de build. Com worktree, Claude trabalha em ../proj-claude/ e Codex em ../proj-codex/ — caches separados, builds rápidos em ambos.
🖥️ 2 terminais, 1 projeto (setup simples)
Antes de worktree, o setup mais simples: 2 terminais no MESMO diretório. Funciona pra 80% dos casos — pra tasks em arquivos DIFERENTES.
# Terminal 1
$ cd ~/projects/meu-app
$ claude
# Terminal 2 (mesma pasta)
$ cd ~/projects/meu-app
$ codex
# Pronto. Ambos veem o mesmo CLAUDE.md + AGENTS.md.
# Cada um faz sua task em arquivos próprios.É o setup do vídeo do Nate Herk. Simples, sem complicação. Cuidado vem quando os dois mexem no mesmo arquivo — próximo tópico.
⚠️ Evitando overwrite
O erro mais caro: Claude salva edição, Codex salva por cima sem ver, trabalho perdido. Disciplina vence.
✓ Protocolo
- 1Cada agente tem ARQUIVOS designados (sua "área")
- 2Antes de editar arquivo "do outro" → commit current
- 3Comunica via HANDOVER.md ou comentário no arquivo
- 4Para arquivos críticos: use worktrees separados (próximo módulo de hábitos)
✗ Erros
- ✗Os dois editando o MESMO arquivo "ao mesmo tempo"
- ✗Esquecer de commit entre passes
- ✗Não comunicar área de cada um
- ✗Achar que "o git resolve depois"
Hábito profissional: antes de cada handoff → git commit -am "wip: claude pass". 2 segundos. Salva horas se algo dá errado.
🤝 Padrão "stylist + restorer"
O caso real do vídeo do Nate Herk — uso colaborativo mais lucrativo. Forças complementares atacando o MESMO arquivo em alternância.
Claude: stylist
Desenha o HTML em dark mode moderno. Tipografia, espaçamento, sombras — Claude brilha aqui.
Commit + handoff
git commit -am "claude: dark mode pass" — depois HANDOVER pra Codex.
Codex: restorer
"Restaure clareza de valor — informação importante ficou escondida pelo styling". Codex devolve hierarquia visual, headlines mais punchy, CTAs visíveis.
Claude: polimento final
"Polir o que o Codex mexeu mantendo a essência de valor". Resultado: arquivo melhor que nenhum dos dois faria sozinho.
🏛️ As 3 camadas: filosofia final
O modelo mental que carrega TUDO que você aprendeu. 3 camadas independentes — qualquer agente lê camada 1, qualquer skill-capable agente roda camada 2, e cada agente tem sua camada 3 específica.
🌐 Camada 1: Shared Knowledge
Tudo que QUALQUER agente lê — humano ou IA. Inclui:
- • AGENTS.md (universal)
- • README.md, docs/, archives/
- • Reference docs, brand assets, decisions
- • Código-fonte (obviamente)
🛠️ Camada 2: Workflows / Skills
Padrão aberto, ambos leem. Inclui:
- • .agents/skills/ (Agent Skills standard)
- • SKILL.md por skill
- • Subagents narrow
⚙️ Camada 3: Tool-specific Config
Cada agente sua zona. Inclui:
- • .claude/settings.json, hooks/, agents/*.md, CLAUDE.md (com @import)
- • .codex/config.toml, agents/*.toml
- • .cursor/, .windsurf/, etc.
Princípio operacional: antes de criar algo no projeto, pergunte "qual camada?". Se for específico de ferramenta, vai na 3. Se for workflow reutilizável, vai na 2. Se for conhecimento puro, vai na 1.
🚀 Preparando pro próximo agente
Em 2026 já temos 10+ agentes coding. Em 2027 virá mais (Hermes, novos players, evoluções). Quem organizou nas 3 camadas adapta em horas, não semanas.
Agentes de coding já lendo AGENTS.md em 2026:
O curso não é sobre Codex + Claude. É sobre ser agnostic. Você sai daqui pronto pra qualquer ferramenta de 2027, 2028, 2030. O padrão e o mindset valem pra todos.
🎓 Resumo Final do Curso
🏆 Parabéns:
Você completou as 3 trilhas. Agora você é tool-agnostic. Cole AGENTS.md no seu próximo projeto e nunca mais fique refém de uma ferramenta.