엔지니어가 아닌 제가 하나의 채팅방에서 5개의 AI 에이전트를 협업시킨 이야기

서론

저는 엔지니어가 아닙니다. 일본에서 인도적 지원 업무를 하고 있습니다.

최근 몇 주 동안, 업무에 필요한 작은 시스템이나 앱을 AI 코딩 에이전트와 함께 만들어 왔습니다. Claude Code 세션 3개, Codex 1개, Antigravity 1개입니다. 에이전트들은 스스로 이름을 정했습니다: Luna, Excalibur, Marslı(Claude Code), Leyla(Codex), Nezle02(Antigravity).

하지만 여러 에이전트를 같은 리포지토리에서 구동시키자 곧바로 문제가 발생했습니다.

• 누가 무엇을 하고 있는지 알 수 없다.
• 두 사람이 동시에 같은 작업을 시작한다.
• 한쪽의 사용 제한량(쿼터)이 초과되어 작업이 도중에 멈춘다.
• 제가 각 창 사이를 오가며 전달자 역할을 해야 한다.

그래서 에이전트들을 위한 '공유 채팅방'을 만들었습니다.

작동 원리

Excalibur Agent Hub은 자신의 컴퓨터 안에서만 구동되는 작은 채팅방입니다.

• 브라우저에서 127.0.0.1에 접속하면, 프로젝트별로 탭이 있습니다. 저는 그곳에서 모든 대화를 실시간으로 읽고 지시사항을 작성합니다. - 에이전트들은 hub라는 작은 명령어로 대화합니다. 인사를 하고, 작업을 선언(claim)하며, 업무를 인계하고, 완료하면 보고(done)하며, 제가 결정해야 할 것은 저에게 질문합니다. - 계정도 클라우드도 없습니다. 외부로 아무것도 전송하지 않습니다.
• 서버는 순수 JavaScript로 약 1,100줄이며, 화면은 HTML 파일 1개입니다. npm 패키지는 전혀 사용하지 않았습니다.

실제로 사용하며 만들어진 규칙들

사용하면서 자연스럽게 규칙들이 늘어났습니다. 모두 실패를 통해 탄생한 것입니다.

• 작업 선언(claim): 시작하기 전에 '이것은 제가 하겠습니다'라고 작성합니다. 같은 작업의 중복을 막아주었습니다. -
  2시간 침묵 = 인계 OK: 선언만 한 채 2시간 동안 아무 연락이 없으면, 다른 에이전트가 해당 브랜치부터 계속 진행해도 좋습니다. 대부분 사용 제한량이 다 된 경우일 뿐입니다. -
  코디네이터 교대: 총괄 역할(⭐)의 에이전트는 자신의 사용 제한량이 적게 남았을 때, 여유 있는 다른 에이전트에게 역할을 넘긴 후 멈춥니다. -
  출처 없는 숫자는 기재하지 않기: 자료나 보고서의 숫자에는 반드시 출처를 명시합니다. AI는 그럴듯한 가짜 숫자를 만들어낼 수 있기 때문입니다. -
  자신의 PR은 스스로 병합(merge)하지 않기: 반드시 다른 에이전트가 리뷰해야 합니다.

가장 놀라웠던 점

시스템 자체가 매우 작아서, 채팅으로 '사이드바를 조금 더 좁게 해줘'라고 요청하자, 에이전트들이 허브 자체를 수정해 주었습니다. 리뷰 담당 에이전트가 확인하고 페이지를 새로고침하니 반영되었습니다.

최근에도 Gemini에게 이 허브를 보여주자 개선안을 두 가지 받았습니다. 그것을 채팅에 붙이자 Leyla가 구현했고, Marslı가 리뷰 과정에서 버그를 하나 발견하여 수정된 후 적용되었습니다. 저는 코드를 읽지 않습니다. 대화를 읽고 결정만 할 뿐입니다.

맺음말

완벽한 도구는 아닙니다. 저희의 조금 어수선한 실제 작업 환경을 위해 만든 것입니다. 그럼에도 불구하고, 여러 에이전트와 함께 일하기 시작하는 분들에게 참고가 되기를 바랍니다.

오픈 소스(MIT)입니다:

의견이 있다면 부디 편하게 알려주시면 감사하겠습니다 🙂

Discussion