Dois Agentes de Programação, Um Projeto Difícil: Como Dividir o Trabalho (Lições de uma ECU de Jeep de 1994)

O Claude Code e o Codex fizeram engenharia reversa do computador do motor de um Jeep de 1994 usando um Arduino de US$ 3. Este é o padrão reutilizável por trás disso: três formas de dividir um projeto difícil entre dois agentes de programação, como eles trocam contexto entre si e onde um humano...

Ryan Mitchell

Ryan Mitchell

18 novembro 2026

Dois Agentes de Programação, Um Projeto Difícil: Como Dividir o Trabalho (Lições de uma ECU de Jeep de 1994)

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:

  1. Um arquivo de instruções compartilhado. O AGENTS.md é o ponto de entrada para "qualquer agente que trabalhe neste repositório". O CLAUDE.md é uma única linha que aponta para ele, de modo que Claude Code e Codex leem as mesmas regras.
  2. 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.
  3. 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. Um CLAUDE.md de uma linha que aponta para o AGENTS.md manté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:

  1. Antes de qualquer coisa física. "Nunca deixe nada ser conectado a uma cavidade de 12 V." A pessoa mede cada cavidade primeiro.
  2. Antes de qualquer comando destrutivo. Apagar códigos também limpa os dados de combustível aprendidos, então o agente pergunta e explica.
  3. 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."
  4. 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ê.

Explore mais

Guia do GPT-6.2 Codex: como usar Astra e Sol para programar

Guia do GPT-6.2 Codex: como usar Astra e Sol para programar

Configuração do GPT-6.2 Codex: quando escolher Astra ou Sol, como alternar com /model ou config.toml, qual nível de raciocínio usar no início e como rotear os agentes Codex de uma equipe.

18 novembro 2026

O código gerado por IA deve ser open source? O que isso significa para equipes que desenvolvem com agentes

O código gerado por IA deve ser open source? O que isso significa para equipes que desenvolvem com agentes

Uma publicação no Hacker News defende que todo código gerado por IA deveria ser open source. Aqui está o argumento, os contra-argumentos, como estão as leis de direitos autorais dos EUA e do Reino Unido e o registro de procedência que toda equipe que faz deploy com agentes de código precisa,...

18 novembro 2026

Negócios no ChatGPT: o que isso significa para pequenas equipes

Negócios no ChatGPT: o que isso significa para pequenas equipes

ChatGPT para empresas explicado para equipes pequenas: o que fazem o Business Hub e o Business Agents, quanto a OpenAI diz que custa e de quem é a responsabilidade pela manutenção semanal.

17 novembro 2026