Resposta rápida: Para dividir um projeto difícil entre dois agentes de código, dê a cada agente um papel que produza algo que o outro possa verificar: um explora e registra o que aprendeu, enquanto o outro constrói com base nesse registro, ou ambos tentam a mesma etapa e você compara os resultados. Mantenha o contexto compartilhado em um único arquivo que ambos os agentes leiam, e coloque uma aprovação humana na frente de toda ação que toque o mundo real.
O Jeep Cherokee de 1994 de um desenvolvedor não tem porta OBD2, o soquete de diagnóstico padrão dos carros mais recentes e, nas palavras dele, "nenhum scanner que funcione nele". Nada conseguia ler o computador do motor (a ECU). Ele conectou um Arduino Nano de US$ 3 ao plugue de diagnóstico e delegou a tarefa a dois agentes de código, Claude Code e Codex. O vídeo do projeto recebeu 450 pontos e mais de 230 comentários no Hacker News neste mês.
A parte útil para a sua equipe é como um projeto difícil e desconhecido foi conduzido por dois agentes diferentes e um humano cuidadoso. Este guia transforma isso em um padrão reutilizável e mostra onde o Sharkly se encaixa quando os dois agentes ultrapassam duas abas de terminal.
O que o projeto da ECU do Jeep mostra sobre dois agentes de código
Veja o que a fonte diz, e nada mais. Na descrição do vídeo, o autor escreve que, ao longo de cerca de uma semana, os agentes "leram o computador em tempo real, registraram minhas viagens, copiaram seu programa inteiro e executaram seu próprio código dentro dele". A lista de capítulos credita ao Claude a descoberta da fiação e a realização do teste da bomba de combustível, e ao Codex a execução de código dentro do computador. Um capítulo se intitula "A corrida noturna: a ferramenta estava errada".
O repositório xj-scanner que surgiu disso é o artefato mais interessante. Três detalhes se destacam:
- Um arquivo de instruções compartilhado. O
AGENTS.mdé o ponto de entrada para "qualquer agente que trabalhe neste repositório". OCLAUDE.mdé uma única linha que aponta para ele, de modo que Claude Code e Codex leem as mesmas regras. - Conhecimento registrado por escrito. A pasta
docs/contém o pinout do plugue, o protocolo e todos os parâmetros com suas escalas, de modo que o próximo agente comece a partir do que o anterior aprendeu. - Paradas obrigatórias para um humano. As regras dizem que a leitura é segura, mas apagar códigos de falha, redefinir o fuel trim e testes de atuadores que "acionam hardware real" exigem, cada um, o aval prévio da pessoa.
O vídeo não publica uma divisão formal de trabalho, então trate a divisão abaixo como um padrão extraído do resultado, não como uma transcrição das sessões dele.
Quando um projeto difícil precisa de dois agentes de código
Use dois agentes quando o trabalho tiver um custo alto por estar errado com confiança. Engenharia reversa, migrações, protocolos desconhecidos e depuração sem documentação se enquadram todos. Um segundo agente com um modelo diferente por trás lhe dá uma leitura independente, e a discordância entre eles é um sinal no qual você pode agir.
Dispense o segundo agente quando a tarefa for pequena e bem especificada. A documentação do Sharkly sobre Crews faz a mesma observação sobre coordenação em geral: atribua trabalhos pequenos e bem definidos a um único Agent, e traga uma equipe apenas quando alguém tiver que interpretar o objetivo e combinar resultados.
Três maneiras de dividir um projeto entre agentes de código
Escolha um padrão por fase, não por projeto. Descoberta, construção e testes ao vivo arriscados pedem divisões diferentes.
| Padrão | Agente A | Agente B | Quando usar |
|---|---|---|---|
| Explorador e construtor | Investiga e registra as descobertas em um arquivo | Constrói com base nessas descobertas | O domínio é desconhecido e a documentação é escassa |
| Duas tentativas independentes | Resolve a etapa sozinho | Resolve a mesma etapa sozinho | Uma resposta errada é cara e difícil de detectar |
| Construtor e revisor | Escreve a alteração | Revisa conforme a especificação e os dados | A alteração é clara, mas o risco é alto |
Explorador e construtor: quem escreve o mapa?
O resultado do explorador é um documento, não código. No xj-scanner, é a pasta docs/: o conector medido cavidade por cavidade, o protocolo, a tabela de parâmetros. O construtor trabalha a partir desse arquivo e nunca precisa redescobrir o pinout. Se o construtor encontra uma contradição, ele atualiza o documento, para que o mapa permaneça a única fonte da verdade.
Duas tentativas independentes: como compará-las?
Dê a ambos os agentes o mesmo prompt e as mesmas entradas, e não deixe nenhum deles ver a resposta do outro. Depois compare os resultados com dados em que você confia. Para um decodificador de protocolo, isso significa alimentar ambos com o mesmo log capturado e comparar os valores decodificados. Abordamos uma configuração justa para isso em Claude Code vs Codex no mesmo bug.
Construtor e revisor: o que o revisor verifica?
O revisor verifica afirmações contra evidências, não estilo. "O fuel trim lê +40%" é uma afirmação; o revisor pergunta se a fórmula de escala está correta antes que alguém aja sobre ela. As regras do xj-scanner codificam isso: "Uma leitura que parece errada pode ser uma peculiaridade de escala". Nosso guia sobre Crews de modelos mistos com um revisor separado aprofunda a combinação de um trabalhador mais barato com um revisor mais forte.
Como dois agentes de código trocam contexto entre si
Os agentes não compartilham memória, então a transmissão precisa viver em arquivos e registros de tarefas. Quatro peças carregam a maior parte do peso:
- Um arquivo de instruções que ambos os agentes leem. O AGENTS.md é o formato aberto que o Codex lê; o Claude Code lê o
CLAUDE.md, e sua documentação de memória descreve a importação de outros arquivos. UmCLAUDE.mdde uma linha que aponta para oAGENTS.mdmantém ambos sob as mesmas regras. - Um documento de descobertas por domínio. Pinouts, protocolos e peculiaridades vão para a pasta
docs/, não para um histórico de chat que desaparece. - Logs como evidência compartilhada. O xj-scanner grava cada viagem em
pc/logs/como CSV, para que qualquer agente possa analisar a mesma execução. - Uma nota de transmissão por etapa. O que foi tentado, o que funcionou, o que está sem verificação e o próximo comando.
Uma nota de transmissão pode ser tão curta quanto esta (valores ilustrativos, não do repositório do Jeep):
## Handoff: SCI read of live sensor data
- Done: Nano bridge sketch flashed, DEMO mode passes on the laptop side
- Confirmed: cavities 2 (ground), 3, 4 measured with key ON
- Unverified: fuel trim scaling; reading looks high on idle
- Next: Codex decodes pc/logs/xj_2026-11-03.csv with both scaling formulas
- Needs a human: any actuator test or code erase
Para mais formatos, veja nossos modelos de transmissão para agentes de código e o guia sobre manter o contexto ao alternar entre agentes de código.
Onde o humano verifica o resultado
Coloque uma pessoa em toda etapa difícil de desfazer, e em nenhum outro lugar. As regras do xj-scanner são um modelo limpo:
- Antes de qualquer coisa física. "Nunca deixe nada ser conectado a uma cavidade de 12 V." A pessoa mede cada cavidade primeiro.
- Antes de qualquer comando destrutivo. Apagar códigos também limpa os dados de combustível aprendidos, então o agente pergunta e explica.
- Antes de confiar em um diagnóstico. "Não adivinhe um diagnóstico. Relate o que os dados mostram e o que não mostram."
- Depois de uma surpresa. O capítulo da corrida noturna diz que a ferramenta estava errada; dados do mundo real são a verificação que nenhum agente pode pular.
A mesma regra vale para uma equipe de software. Merges para a main, migrações de schema e qualquer coisa que envie e-mails ou gaste dinheiro recebem um gate humano. Todo o resto pode fluir entre os agentes. Se a revisão já é seu gargalo, leia projetando a revisão para agentes paralelos.
Executando uma divisão de dois agentes no Sharkly
Em um terminal, a divisão vive na sua cabeça: qual aba executa qual agente e quem está esperando por você. O Sharkly move isso para uma tarefa.
Você conecta um Computer, e o Sharkly detecta as ferramentas de agente nele como Runtimes, como Claude Code e Codex. Você cria um Agent para cada papel. Depois você monta um Crew: um Agent líder mais os Agents de explorador, construtor ou revisor, e as Pessoas que aprovam.
Atribua a tarefa ao Crew e a execução roda com o líder primeiro, conforme a documentação de Crews. O líder lê a tarefa e as instruções do Crew, menciona os membros Agent de que precisa, e esses membros executam na mesma tarefa e publicam seus resultados no chat dela. O líder os combina. Suas descrições de papéis viram instruções do Crew: quando envolver o revisor, como mesclar duas tentativas e quando uma pessoa decide.
Dois detalhes importam para esse padrão. Trabalho em repositório pode usar um git worktree separado para cada execução, para que dois agentes tentando a mesma etapa não sobrescrevam um ao outro (documentação de execução de tarefas). E cada execução tem um estado no log de execução da tarefa, para que você possa ver qual agente está na fila, em execução ou concluído sem abrir terminais.
Alternativas a um Crew de dois agentes
Você tem outras opções, e algumas se encaixam melhor:
- Um agente, duas passagens. Peça ao mesmo agente para construir e depois para revisar em uma sessão nova. Mais barato, mas o mesmo modelo tende a repetir seus próprios pontos cegos.
- Dois terminais, um repositório compartilhado. Funciona para um projeto de fim de semana como o Jeep. Fica difícil de acompanhar quando há várias tarefas e um colega de equipe. Veja executando Claude Code e Codex juntos em uma base de código.
- Agentes paralelos em tarefas separadas. Útil para throughput, não para checagem mútua. Fique atento a dois agentes editando o mesmo arquivo.
Conclusão
O projeto do Jeep funcionou porque o conhecimento viveu em arquivos, ambos os agentes leram as mesmas regras e um humano ficou na frente de toda ação arriscada. Copie esses três hábitos e dois agentes de código se tornam uma checagem mútua em vez de duas fontes de palpites confiantes.
Próximo passo: escolha uma tarefa difícil nesta semana, escreva as regras do AGENTS.md dela e a nota de transmissão, e execute-a como um Crew no Sharkly com um Agent revisor e uma pessoa na aprovação.
FAQ
Claude Code e Codex podem trabalhar no mesmo projeto?
Sim. Ambos leem arquivos de instruções no repositório: o Codex lê o AGENTS.md, e o Claude Code lê o CLAUDE.md, que pode apontar para o AGENTS.md. Dê a cada um um worktree separado ou uma etapa separada para que não editem os mesmos arquivos ao mesmo tempo.
Como os agentes de código compartilham contexto?
Por meio de arquivos e registros de tarefas, não de memória. Mantenha as regras no AGENTS.md, as descobertas em uma pasta de documentos, os dados brutos em logs e uma nota curta de transmissão por etapa.
Onde um humano deve aprovar o trabalho dos agentes?
Antes de qualquer coisa difícil de desfazer: ações de hardware, comandos destrutivos, merges para a main, migrações e qualquer coisa que envie mensagens ou gaste dinheiro. Deixe o resto fluir entre os agentes.
Claude Code e Codex fizeram engenharia reversa da ECU do Jeep por conta própria?
Não. O desenvolvedor fez a fiação, as medições e a direção, e as regras do repositório exigem o aval da pessoa antes de comandos arriscados. Os agentes leram o computador, registraram as viagens, copiaram seu programa e executaram código dentro dele.
Você precisa de uma plataforma para rodar dois agentes de código?
Não. Dois terminais e um repositório compartilhado funcionam para um projeto. Uma plataforma começa a valer a pena quando várias tarefas, colegas de equipe e aprovações estão em andamento e você precisa de um único registro de quem fez o quê.



