코딩 에이전트 2개로 어려운 프로젝트 작업 분배하기 (1994년 Jeep ECU 개발에서 배운 교훈)

Claude Code와 Codex가 3달러짜리 Arduino로 1994년식 지프의 엔진 컴퓨터를 리버스 엔지니어링했습니다. 그 이면에 있는 재사용 가능한 패턴을 소개합니다: 두 코딩 에이전트 간에 어려운 프로젝트를 나누는 세 가지 방법, 에이전트들이 서로 컨텍스트를 전달하는 방식, 그리고 사람이 승인해야 하는 지점입니다.

Ryan Mitchell

Ryan Mitchell

18 11월 2026

코딩 에이전트 2개로 어려운 프로젝트 작업 분배하기 (1994년 Jeep ECU 개발에서 배운 교훈)

빠른 답: 어려운 프로젝트를 두 코딩 에이전트에게 나누려면, 각 에이전트에게 서로가 검증할 수 있는 결과물을 만드는 역할을 주세요. 한쪽은 조사하고 배운 내용을 기록하고, 다른 한쪽은 그 기록을 기반으로 구축하거나, 양쪽이 같은 단계를 시도한 뒤 결과를 비교하는 방식입니다. 공유 컨텍스트는 두 에이전트가 모두 읽는 하나의 파일에 담고, 실제 세계에 영향을 주는 모든 작업 앞에는 사람의 승인을 두세요.

한 개발자의 1994년식 Jeep Cherokee에는 OBD2 포트(이후 차량의 표준 진단 소켓)가 없었고, 그의 말로는 "작동하는 스캔 툴이 없는" 차였습니다. 어떤 도구도 엔진 컴퓨터(ECU)를 읽을 수 없었습니다. 그는 3달러짜리 Arduino Nano를 진단 플러그에 연결하고, Claude Code와 Codex라는 두 코딩 에이전트에게 작업을 맡겼습니다. 이 프로젝트의 영상은 이번 달 Hacker News에서 450포인트와 230개가 넘는 댓글을 기록했습니다.

여러분 팀에 유용한 부분은 하나의 어렵고 낯선 프로젝트가 서로 다른 두 에이전트와 신중한 한 명의 사람에 의해 어떻게 완수되었는가 하는 점입니다. 이 가이드는 그 내용을 재사용 가능한 패턴으로 정리하고, 두 에이전트가 터미널 탭 두 개 이상의 규모로 성장했을 때 Sharkly가 어떻게 활용될 수 있는지 보여줍니다.

Jeep ECU 프로젝트가 두 코딩 에이전트에 대해 보여주는 것

원문이 말하는 내용만 정리하면 다음과 같습니다. 영상 설명에서 저자는 약 일주일에 걸쳐 에이전트들이 "컴퓨터를 실시간으로 읽고, 주행을 기록하고, 프로그램 전체를 복제했으며, 그 안에서 자체 코드를 실행했다"고 적습니다. 챕터 목록에서는 배선 파악과 연료 펌프 테스트 실행을 Claude의 공으로, 컴퓨터 내부에서 코드를 실행한 것을 Codex의 공으로 돌립니다. 한 챕터의 제목은 "The night drive: the tool was wrong"입니다.

이 프로젝트에서 탄생한 xj-scanner 저장소가 더 흥미로운 산출물입니다. 세 가지 세부 사항이 눈에 띕니다:

  1. 하나의 공유 지침 파일. AGENTS.md는 "이 저장소에서 작업하는 모든 에이전트"의 진입점입니다. CLAUDE.md는 이를 가리키는 한 줄로 되어 있어 Claude Code와 Codex가 같은 규칙을 읽습니다.
  2. 기록으로 남겨진 지식. docs/ 폴더에는 플러그 핀배치, 프로토콜, 스케일링 값을 갖춘 모든 파라미터가 담겨 있어, 다음 에이전트가 이전 에이전트가 학습한 내용에서 출발할 수 있습니다.
  3. 사람을 위한 확실한 정지점. 규칙에 따르면 읽기는 안전하지만, 고장 코드 삭제, 연료 트림 리셋, 그리고 "실제 하드웨어를 작동시키는" 액추에이터 테스트는 각각 사람의 사전 승인이 필요합니다.

영상은 공식적인 역할 분담을 공개하지 않으므로, 아래의 분업 방식은 세션 기록이 아니라 결과물에서 도출한 패턴으로 간주하세요.

어려운 프로젝트에 두 코딩 에이전트가 필요한 시점

확신에 찬 잘못이 큰 비용을 초래하는 작업에서는 두 에이전트를 사용하세요. 리버스 엔지니어링, 마이그레이션, 낯선 프로토콜, 문서 없는 디버깅이 모두 여기에 해당합니다. 다른 모델을 기반으로 하는 두 번째 에이전트는 독립적인 판단을 제공하며, 두 결과의 불일치는 행동할 수 있는 신호가 됩니다.

반면 작업이 작고 명확하게 정의되어 있다면 두 번째 에이전트는 생략하세요. Crews에 관한 Sharkly 문서도 조율에 대해 같은 요점을 짚습니다. 작고 잘 정의된 작업은 하나의 Agent에 할당하고, 누군가 목표를 해석하고 결과를 통합해야 할 때만 팀을 꾸리라는 것입니다.

코딩 에이전트 간에 프로젝트를 나누는 세 가지 방법

프로젝트 단위가 아니라 단계별로 하나의 패턴을 선택하세요. 탐색, 구축, 위험한 실시간 테스트는 각각 다른 분업 방식을 요구합니다.

패턴 Agent A Agent B 적합한 상황
탐색자와 구축자 조사하고 결과를 파일에 기록 그 결과를 기반으로 구축 도메인을 잘 모르고 문서가 부족할 때
두 독립 시도 단계를 혼자서 해결 같은 단계를 혼자서 해결 잘못된 답이 비용이 크고 발견하기 어려울 때
구축자와 검토자 변경 사항 작성 스펙과 데이터를 기준으로 검토 변경 내용은 명확하지만 위험이 클 때

탐색자와 구축자: 지도를 누가 작성하는가?

탐색자의 산출물은 코드가 아니라 문서입니다. xj-scanner에서는 docs/ 폴더가 그것입니다. 커넥터를 캐비티 하나하나 측정한 기록, 프로토콜, 파라미터 테이블입니다. 구축자는 그 파일을 기반으로 작업하며 핀배치를 다시 찾아낼 필요가 없습니다. 구축자가 모순을 발견하면 문서를 업데이트하므로, 지도가 단일 진실 공급원으로 유지됩니다.

두 독립 시도: 어떻게 비교하는가?

두 에이전트에게 같은 프롬프트와 같은 입력을 주되, 서로의 답을 보지 못하게 하세요. 그런 다음 신뢰할 수 있는 데이터를 기준으로 결과를 비교합니다. 프로토콜 디코더라면 같은 캡처 로그를 양쪽에 입력하고 디코딩된 값을 diff하는 방식입니다. 공정한 비교 환경 구성은 같은 버그를 놓고 비교한 Claude Code vs Codex에서 다룹니다.

구축자와 검토자: 검토자는 무엇을 확인하는가?

검토자는 스타일이 아니라 주장을 근거와 대조합니다. "연료 트림이 +40%로 읽힌다"는 주장이고, 검토자는 누군가 그에 따라 행동하기 전에 스케일링 공식이 올바른지 묻습니다. xj-scanner의 규칙도 이를 반영합니다. "잘못된 것처럼 보이는 측정값은 스케일링 문제일 수 있다." 별도의 검토자를 둔 혼합 모델 Crews에 관한 가이드에서는 저렴한 워커와 강력한 검토자의 페어링을 더 깊이 다룹니다.

두 코딩 에이전트가 서로 컨텍스트를 전달하는 방법

에이전트는 메모리를 공유하지 않으므로, 인계는 파일과 작업 기록에 담겨야 합니다. 다음 네 가지가 대부분의 역할을 수행합니다:

  • 두 에이전트가 모두 읽는 하나의 지침 파일. AGENTS.md는 Codex가 읽는 오픈 포맷이고, Claude Code는 CLAUDE.md를 읽으며 memory 문서에 다른 파일의 가져오기(import)가 설명되어 있습니다. AGENTS.md를 가리키는 한 줄짜리 CLAUDE.md만 두면 양쪽이 같은 규칙을 따릅니다.
  • 도메인별 결과 문서. 핀배치, 프로토콜, 특이 사항은 사라지는 채팅 기록이 아니라 docs/에 담습니다.
  • 공유 증거로서의 로그. xj-scanner는 모든 주행을 pc/logs/에 CSV로 기록하므로, 어느 에이전트든 같은 실행 데이터를 분석할 수 있습니다.
  • 단계별 인계 노트. 무엇을 시도했고, 무엇이 작동했고, 무엇이 검증되지 않았는지, 그리고 다음 명령이 무엇인지.

인계 노트는 이 정도로 짧아도 충분합니다(예시 값이며, 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

더 많은 형식은 코딩 에이전트 인계 템플릿과 코딩 에이전트 전환 시 컨텍스트 유지 가이드를 참고하세요.

사람이 결과를 검증해야 하는 지점

되돌리기 어려운 모든 단계에 사람을 배치하고, 그 외의 곳에는 두지 마세요. xj-scanner의 규칙은 깔끔한 템플릿입니다:

  1. 물리적 작업 전. "절대 12 V 캐비티에 무엇이든 연결하게 두지 마라." 사람이 모든 캐비티를 먼저 측정합니다.
  2. 파괴적인 명령 전. 코드 삭제는 학습된 연료 데이터까지 지우므로, 에이전트가 요청하고 설명합니다.
  3. 진단을 신뢰하기 전. "진단을 추측하지 마라. 데이터가 보여주는 것과 보여주지 않는 것을 보고하라."
  4. 예상 밖의 결과 이후. 야간 주행 챕터에서는 도구가 틀렸다고 밝혔습니다. 실제 세계의 데이터는 어떤 에이전트도 건너뛸 수 없는 검증입니다.

소프트웨어 팀에서도 같은 원칙이 적용됩니다. main으로의 머지, 스키마 마이그레이션, 이메일 발송이나 금액 지출이 수반되는 작업에는 사람의 게이트를 둡니다. 나머지는 에이전트 간에 흐르게 하면 됩니다. 검토가 이미 병목이라면 병렬 에이전트를 위한 검토 설계를 읽어보세요.

Sharkly에서 두 에이전트 분업 운영하기

터미널에서는 이 분업이 머릿속에만 존재합니다. 어느 탭이 어느 에이전트를 실행하는지, 누가 당신을 기다리고 있는지 알아야 합니다. Sharkly는 이를 하나의 작업(task) 위에 옮겨둡니다.

Computer를 연결하면 Sharkly가 그 위의 에이전트 도구를 Claude Code, Codex 같은 Runtime으로 감지합니다. 역할마다 Agent를 생성하세요. 그런 다음 Crew를 구성합니다. 리더 Agent와 탐색자, 구축자, 검토자 Agent들, 그리고 승인하는 People로 이루어진 팀입니다.

작업을 Crew에 할당하면 Crews 문서에 따라 리더 우선으로 실행이 진행됩니다. 리더가 작업과 Crew 지침을 읽고 필요한 Agent 멤버를 언급(mention)하면, 그 멤버들이 같은 작업에 대해 실행하고 결과를 리더의 채팅에 게시합니다. 리더가 이를 통합합니다. 여러분이 작성한 역할 설명이 Crew 지침이 됩니다. 검토자를 언제 참여시킬지, 두 시도를 어떻게 병합할지, 언제 사람이 결정할지가 그것입니다.

이 패턴에서 중요한 두 가지 세부 사항이 있습니다. 저장소 작업에는 실행마다 별도의 git worktree를 사용할 수 있어, 같은 단계를 시도하는 두 에이전트가 서로의 결과를 덮어쓰지 않습니다(작업 실행 문서). 그리고 모든 실행에는 작업의 실행 로그에 상태가 기록되므로, 터미널을 열지 않고도 어느 에이전트가 대기 중인지, 실행 중인지, 완료되었는지 확인할 수 있습니다.

두 에이전트 Crew의 대안

다른 선택지도 있으며, 어떤 것은 더 잘 맞을 수 있습니다:

  • 하나의 에이전트, 두 번의 패스. 같은 에이전트에게 구축을 요청한 뒤, 새로운 세션에서 검토를 요청합니다. 더 저렴하지만, 같은 모델은 자신의 맹점을 반복하는 경향이 있습니다.
  • 터미널 두 개, 공유 저장소 하나. Jeep 같은 주말 프로젝트에는 충분합니다. 하지만 여러 작업과 팀원이 얽히면 추적이 어려워집니다. 하나의 코드베이스에서 Claude Code와 Codex 함께 운영하기를 참고하세요.
  • 별도 작업에 병렬 에이전트. 처리량 확보에는 유용하지만, 서로를 검증하는 용도로는 적합하지 않습니다. 두 에이전트가 같은 파일을 편집할 때 벌어지는 일을 주의 깊게 살펴보세요.

결론

Jeep 프로젝트가 성공한 이유는 지식이 파일에 담겨 있었고, 두 에이전트가 같은 규칙을 읽었으며, 모든 위험한 작업 앞에 사람이 서 있었기 때문입니다. 이 세 가지 습관을 그대로 가져오면, 두 코딩 에이전트는 확신에 찬 추측 두 개가 아니라 서로를 검증하는 존재가 됩니다.

다음 단계: 이번 주에 어려운 작업 하나를 골라, 그 작업의 AGENTS.md 규칙과 인계 노트를 작성하고, 검토자 Agent와 승인 담당 사람을 두고 Sharkly에서 Crew로 실행해 보세요.

FAQ

Claude Code와 Codex가 같은 프로젝트에서 작업할 수 있나요?

네. 둘 다 저장소의 지침 파일을 읽습니다. Codex는 AGENTS.md를 읽고, Claude Code는 CLAUDE.md를 읽으며, 이 파일이 AGENTS.md를 가리킬 수 있습니다. 동시에 같은 파일을 편집하지 않도록 각각 별도의 worktree나 별도의 단계를 주세요.

코딩 에이전트는 어떻게 컨텍스트를 공유하나요?

메모리가 아니라 파일과 작업 기록을 통해서입니다. 규칙은 AGENTS.md에, 조사 결과는 docs 폴더에, 원시 데이터는 로그에 담고, 단계마다 짧은 인계 노트를 남기세요.

사람은 에이전트 작업을 어디에서 승인해야 하나요?

되돌리기 어려운 작업 전부, 그 앞에서 승인하세요. 하드웨어 조작, 파괴적인 명령, main으로의 머지, 마이그레이션, 메시지 발송이나 금액 지출이 수반되는 모든 작업이 그렇습니다. 나머지는 에이전트 간에 흐르게 두세요.

Claude Code와 Codex가 Jeep ECU를 스스로 리버스 엔지니어링했나요?

아니요. 배선, 측정, 주행은 개발자가 직접 했고, 저장소의 규칙상 위험한 명령을 실행하려면 사람의 승인이 필요합니다. 에이전트들은 컴퓨터를 읽고, 주행을 기록하고, 프로그램을 복제하고, 그 안에서 코드를 실행했을 뿐입니다.

두 코딩 에이전트를 운영하는 데 플랫폼이 필요한가요?

아니요. 하나의 프로젝트에는 터미널 두 개와 공유 저장소로 충분합니다. 여러 작업, 팀원, 승인이 동시에 진행되고 누가 무엇을 했는지에 대한 단일 기록이 필요해질 때 플랫폼이 본격적으로 빛을 발합니다.

더 둘러보기

GPT-6.2 Codex 완벽 가이드: Astra와 Sol로 코딩하는 방법

GPT-6.2 Codex 완벽 가이드: Astra와 Sol로 코딩하는 방법

GPT-6.2 Codex 설정: Astra와 Sol 중 언제 무엇을 선택할지, /model이나 config.toml로 모델을 전환하는 방법, 처음 시작할 때 적절한 추론 강도 설정, 그리고 팀의 Codex 에이전트를 라우팅하는 방법을 알아봅니다.

18 11월 2026

AI가 생성한 코드는 오픈소스여야 할까? 에이전트로 개발하는 팀이 알아야 할 것들

AI가 생성한 코드는 오픈소스여야 할까? 에이전트로 개발하는 팀이 알아야 할 것들

해커 뉴스(Hacker News) 게시글에서는 AI가 생성한 모든 코드를 오픈 소스로 공개해야 한다고 주장합니다. 이 글에서는 해당 주장과 반대 논거를 살펴보고, 미국과 영국 저작권법의 현행 상황, 그리고 논쟁이 어떻게 마무리되든 코딩 에이전트를 활용해 배포하는 모든 팀이 갖춰야 할 출처 기록(provenance record)에 대해 다룹니다.

18 11월 2026

ChatGPT의 비즈니스 활용: 소규모 팀에게 의미하는 것

ChatGPT의 비즈니스 활용: 소규모 팀에게 의미하는 것

중소 규모 팀을 위한 ChatGPT 기업용 기능 해설: Business Hub와 Business Agents가 하는 일, OpenAI가 밝힌 비용, 그리고 매주 이루어지는 관리 업무는 누구의 몫인지 정리했습니다.

17 11월 2026