당신의 에이전트는 똑똑하지만, 에이전트 팀은 그렇지 않습니다.
your agent is smart, but your team of agents isnt.
핵심 요약
여러 리포지토리를 다룰 때 에이전트 간 맥락 공유가 안 되어 발생하는 문제와 해결책으로 마크다운 트리 구조를 제안함.
- 맥락 공유 문제 — 여러 리포지토리에서 에이전트가 서로 다른 정보를 참조해 일관성 없는 결과가 발생함.
- 마크다운 트리 해결책 — 공유 Git 리포지토리에 마크다운 트리 구조를 두어 에이전트와 인간이 동일한 맥락을 참조하게 함.
- 쓰기 경합 방지 — 인터페이스별로 소유자를 지정해 에이전트 간의 데이터 충돌을 방지하는 전략이 필요함.
- 공유 지식 관리 — Linear 이슈나 전역 AGENTS.md 파일 등을 활용해 에이전트의 일관된 작업 환경을 구축함.
Cursor는 하나의 에이전트가 하나의 리포지토리에서 작업하는 건 정말 잘 해결합니다.
한 명의 인간 + 여러 에이전트가 하나의 리포지토리에서 작업하는 건 훌륭한 루프죠.
하지만 에이전트를 실행하고 4개의 리포지토리에 걸쳐 팀원들과 작업하기 시작한 순간, 멍청해지더군요. 각 세션마다 제가 이미 설명했던 아키텍처 결정을 다시 도출합니다. 프론트엔드 리포지토리의 에이전트와 백엔드 리포지토리의 에이전트가 몇 시간 차이로 서로 모순되는 API 형태를 결정해버립니다. 둘 다 상대방이 무엇에 동의했는지 모르는 거죠.
이유는 모델 때문이 아닙니다.
인간과 에이전트가 같은 맥락을 공유하지 않기 때문입니다. 저는 모든 맥락을 머릿속에 가지고 있지만, 에이전트는 열려 있는 파일에 있는 것만 보고, 많은 맥락이 에이전트와 공유되지 않습니다. 그래서 팀이 서로 다른 버전의 현실을 기반으로 운영되는 거죠.
필요했던 것: 저와 모든 에이전트가 읽고 쓸 수 있는, 최신 상태로 유지되는 맥락 공유 장소입니다. <- 같은 맥락에서 말이죠
제 해결책은 공유 Git 리포지토리에 있는 작은 마크다운 트리였습니다. 노드에는 소유자가 있습니다. 에이전트는 각 작업 전에 관련 노드를 읽고, 작업 후에 업데이트를 제안하며, 소유자는 PR처럼 승인합니다. 에이전트와 인간은 같은 수준의 맥락에서 작업을 마치게 됩니다.
다들 리포지토리 간의 맥락 공유를 위해 무엇을 하시나요? 제가 놓친 뻔한 답이 있는지 정말 궁금합니다.
(누구든 확인하고 싶다면 리포지토리는 agent-team-foundation/first-tree입니다. 완전 오픈소스입니다.)
