xsm-agent-message-channel-ko.md

글 목록
raw .md

AI / Agent

xsm: 에이전트 협업을 메시지 채널에서 시작하기

기존 작업환경과 에이전트의 자율성을 유지하면서, 사람이 이해하고 개입할 수 있는 협업을 구성하는 xsm의 설계.

Claude Code와 Codex를 여러 창에 띄워 API 구현과 화면 개발을 나눠 맡길 수 있습니다. 작업을 나누면 API 계약을 맞추고 서로의 결과를 전달하며, 전체 계획에서 무엇이 끝났는지 확인하는 일도 뒤따릅니다. 세션이 늘어날수록 사람이 그 사이를 연결하는 일이 많아집니다.

저는 에이전트에게 일을 맡기면서도, 누가 무엇을 맡아 진행하고 어떤 근거로 완료를 판단했는지 이해할 수 있는 구조를 원했습니다. 기존 작업환경과 각 에이전트의 자율성을 유지하면서 필요할 때 각 세션의 문맥을 읽고 직접 지시할 수 있어야 한다고 생각했습니다. 이런 요구에서 출발해 만든 도구가 xsm(Cross-Session Messaging)[1]입니다.

앞서 작업자와 도구의 분리에서 전문 소프트웨어의 기능과 사용 지식을 고객이 선택한 작업자에게 제공해야 한다고 썼습니다. xsm에도 같은 생각을 적용했습니다. 이미 사용하는 에이전트가 통신 도구를 익혀 다른 에이전트와 협업하게 하는 것입니다.

에이전트의 실행과 세션 간 통신

Claude Code와 Codex는 모델 호출과 파일 읽기·수정, 도구 실행을 이어가고 그 결과를 다음 판단에 반영하는 실행환경입니다. xsm은 그 안의 세션들을 연결합니다. 상대를 찾고 요청을 보내며, 들어온 메시지를 읽고 답을 회수하는 기능을 제공합니다. 팀이 함께 참조할 상태도 남길 수 있습니다.

기존 세션을 연결하면 그동안 구성한 작업환경을 협업에도 이어서 쓸 수 있습니다. 에이전트의 도구와 스킬, 익숙한 조작 방식과 승인 절차, 진행 중인 작업의 문맥이 그 바탕입니다. 런타임에 새로운 도구나 기능을 도입하면 협업에서도 활용할 수 있습니다.

사용자는 지금 쓰는 세션에서 원하는 일을 말합니다. 에이전트는 xsm의 스킬과 사용 지침을 읽고 필요한 도구를 호출합니다. 역할 배치와 작업 순서는 에이전트가 목표와 상황에 맞춰 판단합니다. 사용자가 새로운 오케스트레이션 문법을 배워 작업을 다시 기술하는 부담을 줄이려는 설계입니다.

독립적인 Claude Code와 Codex 세션이 xsm의 논리적인 통신 계약을 통해 메시지와 공동 상태를 주고받는 구조
그림 1. 각 세션의 실행과 문맥은 기존 런타임에 남습니다. 가운데의 xsm은 통신 기능의 경계를 나타내며, 별도의 에이전트 실행 서버를 뜻하지 않습니다.

이 경계를 README에는 다음과 같이 적었습니다.

All you need is a message channel. The rest is done by agents.

에이전트에게 일을 맡기려면 통신 결과가 분명해야 합니다. 누구에게 보냈는지, 상대 런타임에 전달됐는지, 답이 돌아왔는지를 구분해 알려줘야 합니다. 에이전트는 그 결과를 읽고 다음 행동을 결정합니다.

팀과 보드, 워커 생성과 인수인계 기능은 협업의 참여자와 기록, 실행·응답 상태를 명확히 다루도록 뒷받침합니다. 업무를 어떻게 나누고 우선순위를 바꾸며 결과를 수락할지는 에이전트와 사용자가 정합니다.

로컬의 Claude Code·Codex 연결은 각 런타임의 고유한 전달 경로를 사용합니다. 별도의 공용 로컬 데몬을 계속 관리하는 구조를 요구하지 않습니다. 추가 런타임에는 호스트 수명에 묶인 helper가 있고, 머신 간 통신을 위한 P2P 서비스는 사용자가 선택해 구성합니다. 통신을 분리한다는 것은 이런 연결의 실행 책임과 범위를 명확히 하는 일이기도 합니다.

조직은 자연어로 정합니다

알림 기능을 개발한다고 해보겠습니다. API, UI, 검증을 맡을 세션들이 있고, 전체 계획을 유지할 세션이 있습니다. 사용자는 팀장에게 이렇게 지시할 수 있습니다.

이번 알림 기능 개발의 팀장을 맡아 목표와 완료 기준, 계획과 진도를 관리해줘. API·UI·검증을 맡을 워커를 두고 담당과 보고 대상을 알려줘. 워커들은 필요한 상대와 직접 협의하고, 공통 결정과 진행은 팀 보드에 남겨줘.

이 지시는 전체 계획의 책임자, 필요한 역할, 직접 협의할 상대를 정합니다. 작업이 바뀌면 관계도 말로 바꿀 수 있습니다. 동등한 구성원들이 설계안을 토론하는 의회형 조직이나 서로의 결과를 검토하는 동료 조직도 구성할 수 있습니다. xsm이 특정 조직만 허용할 이유는 없다고 생각합니다.

다만 자연어로 역할을 정하는 것과 실제 연결을 설정하는 일은 구분해야 합니다. 사용할 모델과 세션을 선택하고, 팀을 등록하고, 필요한 통신 범위를 허용하는 절차는 도구로 수행합니다. 역할 지시만으로 사용자 승인이 생기지는 않습니다. 에이전트가 조직의 업무 규칙을 이해하고, xsm은 허용된 범위에서 그 협업을 연결합니다.

장기 개발에는 계획을 책임지는 팀장을 둡니다

규모가 크고 오래 이어지는 병렬 개발에는 제가 강하게 권하는 구성이 있습니다. 강한 모델의 팀장이 계획과 진도를 책임지고, 워커들은 서로 같은 생성 깊이에 배치됩니다. 조직 운영 문서[2]에도 이 구성을 기본 권고로 두었습니다.

팀장에는 Fable이나 Astra급 모델을 두고, Opus·Sol급 모델이 주력 구현과 검증을 맡도록 배치할 수 있습니다. 범위가 분명한 조사나 반복 검사에는 Haiku Max·Luna Max급 보조 워커를 붙일 수 있습니다. 이는 역할별 배치 예시입니다. 실제 모델과 추론 설정은 각 런타임에서 고르며, xsm이 모델을 자동 선택하는 것은 아닙니다.

Fable 팀장 아래에 API·UI·검증 워커가 같은 깊이로 배치되고, 워커끼리 직접 협업하며 공동 보드를 참조하는 구성
그림 2. 주력과 보조는 맡은 일의 차이입니다. 같은 생성 깊이에 두고 직접 협업하게 할 수 있습니다. 그림의 모델 이름은 배치 예시이며, 목표와 현행 결정은 공동 보드에 남깁니다.

팀장의 중요한 일은 작업 전체를 같은 기준으로 점검하는 것입니다. 알림 기능이라면 생성부터 목록 표시와 읽음 처리까지 무엇을 완성할지, 어떤 동작을 확인해야 완료인지 먼저 정합니다. 워커의 보고가 오면 그 기준과 대조해 끝난 일과 남은 일을 나누고, 막힌 일의 의존성을 확인해 다음 순서를 조정합니다.

팀장은 진척과 함께 사람이 판단해야 할 사항과 근거를 정리합니다. 사용자는 팀장의 보고를 통해 진행 상황을 파악하고, 세부 내용이 필요하면 해당 워커의 세션에서 문맥을 읽고 직접 지시할 수 있습니다. 예를 들어 사용자가 API 담당에게 알림 정책 변경을 지시했다면, 그 워커가 관련 변경을 팀장에게 알리고 팀장은 API와 UI의 계획을 다시 맞춥니다.

계획을 모델의 대화 문맥에만 두지는 않습니다. 목표와 완료 기준, 담당, 현행 결정, 검증 근거를 보드와 산출물에 남깁니다. 세션이 교체되거나 인수인계가 필요해졌을 때 다음 세션이 이 기록을 읽고 이어갈 수 있어야 합니다. 팀장 모델의 계획 능력을 활용하고, 그 판단의 근거도 함께 기록하는 구성입니다.

주력 워커가 보조 워커에게 도움을 요청한다고 생성 계층을 한 단계 더 만들 필요도 없습니다. API 담당이 조사 담당에게 관련 코드를 찾아달라고 하거나, 검증 담당에게 재현 조건을 물을 수 있습니다. 담당과 우선순위가 충돌하면 팀장이 조율합니다.

워커가 다시 워커를 만드는 계층이 깊어지면 배경 전달과 결과 회수, 진행 추적에 드는 비용도 커집니다. 어떤 판단이 결과로 이어졌는지 사람이 되짚는 부담도 늘어납니다. 잘못된 전제가 생겼을 때는 누가 이를 전달받았고 어떤 결과에 영향을 줬으며 무엇을 다시 확인해야 하는지 따라갈 수 있어야 합니다. 그래서 저는 역할을 나누되 생성 계층은 얕게 유지하는 쪽을 권합니다.

한 번의 요청과 그 결과로 끝나는 일은 하네스의 서브에이전트로 처리할 수 있습니다. 독립적인 문맥을 유지하며 여러 차례 협의할 상대는 개별 주소와 진행 상태를 갖춘 지속적인 워커로 둡니다.

직접 요청할 일과 함께 남길 상태

알림 API 담당이 읽음 상태의 표현을 바꾸려고 한다고 해보겠습니다. UI 담당에게 변경안을 보내고 영향을 물어볼 수 있습니다. UI 담당은 화면에서 필요한 조건을 답하고, 검증 담당은 읽음 처리와 재연결이 겹치는 경우를 확인합니다. 이런 요청과 답변은 해당 상대에게 보내는 DM으로 진행합니다.

협의 결과를 팀 전체의 기준으로 삼게 되면 보드에 남깁니다. 현재 합의한 API 계약, 각자의 담당, 막힌 일과 검증 결과처럼 이후에 참여한 세션도 알아야 할 상태입니다. 결정이 바뀌어 누군가 행동해야 한다면 관련 보드 항목을 가리키며 구체적인 요청을 보냅니다. 보드는 현행 상태를 읽는 자리이고, DM은 행동과 답을 요청하는 경로입니다.

이렇게 나누면 팀장이 모든 세부 대화를 중계할 부담을 줄일 수 있습니다. 워커끼리 협의하면서도 전체 계획에 영향을 주는 변경은 팀장에게 돌아옵니다. 공동 보드가 있다는 이유로 모든 메시지를 모두에게 보내거나, 다른 팀의 상태를 자동으로 읽을 수 있는 것은 아닙니다. 누구와 어떤 범위에서 소통하는지는 분명히 정해야 합니다.

통신 결과를 해석하는 기준도 필요합니다. 메시지가 저장됐다는 것, 상대 런타임에 전달됐다는 것, 읽은 뒤 수신 확인을 남겼다는 것, 실제 답이 왔다는 것은 서로 다릅니다. 답변이 왔어도 맡긴 일이 완료됐는지는 별도로 판단해야 합니다. 팀장은 워커의 결과와 검증 근거를 완료 기준에 맞춰 확인합니다. 보드가 개발 완료율을 스스로 추정하거나, 도착한 답을 곧바로 완료로 바꾸지는 않습니다.

큰 작업은 여러 팀으로 나눕니다

서비스 전체를 개발한다면 API와 UI 외에도 저장소나 배포를 맡는 팀이 필요할 수 있습니다. 각 팀에 팀장과 워커, 보드를 두고 자기 범위의 계획을 유지하게 할 수 있습니다. 모든 구현의 세부 사항을 한 팀장의 문맥으로 모으는 부담을 줄이는 방식입니다.

팀 사이에는 API 계약, 데이터 모델, 의존성과 통합 시점처럼 서로에게 영향을 주는 정보를 공유합니다. 팀장들이 자기 작업 팀과 별도의 조율 팀에 함께 속하도록 구성할 수도 있습니다. 조율 팀의 DM과 보드에서 합의한 내용을 각 팀장이 자기 팀의 계획에 반영합니다.

API 팀과 UI 팀이 독립적으로 일하면서 동일한 두 팀장이 조율 팀에도 참여하는 다중 소속 구조
그림 3. 조율 팀의 구성원은 각 작업 팀의 팀장들입니다. 같은 세션이 여러 팀에 속하며, 팀 간 계약과 의존성을 조율합니다. 이 관계를 만들기 위해 새로운 상위 지휘자를 둘 필요는 없습니다.

팀장들은 조율 팀에서 동등하게 협의할 수 있습니다. 필요한 정보만 공유하고, 합의가 자기 팀의 담당과 일정에 미치는 영향을 각자 반영합니다. 프로젝트가 커져도 각 팀의 책임과 팀 사이의 합의를 구분해 따라갈 수 있게 하려는 구성입니다.

위임의 범위와 운영의 책임

저는 위임을 늘릴 때 실행 능력과 함께 결과를 이해하고 검증할 여력도 살펴야 한다고 봅니다. 메시지와 로그가 많이 남더라도 어떤 결정이 어떤 결과로 이어졌는지 사람이 파악하기 어려울 수 있습니다. xsm의 얕은 조직과 공동 기록은 사람이 담당과 판단 근거를 따라갈 수 있도록 협업을 운영하려는 선택이며, 이 글의 권고도 그런 조건을 전제로 합니다.

많은 워커를 장기간 무인 운영하거나 여러 사용자의 작업을 중앙에서 관리하려면 권한 이력, 정형화된 작업 상태, 자동 복구, 배포와 감사 같은 요구가 핵심이 될 수 있습니다. 이 경우에는 그 책임을 명시적으로 맡는 운영 인프라가 중요해집니다. 어떤 구성이 적합한지는 과제가 요구하는 실행·검증·운영 범위를 함께 보고 판단해야 합니다.

기존 운영 도구에 xsm을 연결할 때도 워커 생성과 종료, 재시도, 완료 판정을 누가 맡는지 정해야 합니다. 같은 실행을 여러 도구가 각자 관리하면 책임과 상태가 중복될 수 있습니다. 도구를 선택하는 일은 이 운영 책임을 어디에 둘지 정하는 결정이기도 합니다.

기존 에이전트에게 설치를 맡기면 됩니다

이 글의 구성을 인터랙티브 데모[3]에서 볼 수 있습니다. 데모는 팀 구성, 워커 간 협업, 계획 갱신과 팀 간 조율을 설명하기 위한 재연입니다. 실제 개발 프로젝트의 수행 기록이나 성능 측정 결과를 보여주는 화면은 아닙니다. 장면마다 연결된 문서에서 같은 주제의 사용법을 읽을 수 있습니다.

0.6.0은 Claude Code와 Codex를 중심으로, Pi·OpenCode·Hermes·OpenClaw의 실험적 연결도 제공합니다. 추가 런타임은 깨우기, 질문 UI와 게이트웨이 동작이 서로 다릅니다. 사용하려는 환경의 연결 방식과 지원 범위는 런타임 안내[4]에서 확인할 수 있습니다.

Claude Code나 Codex를 사용한다면 지금 세션에 아래 요청을 보내는 것으로 시작할 수 있습니다.

text
https://github.com/ysys143/xsm 의 xsm을 이 머신의 Claude Code와 Codex에 설치해줘.
설치 상태를 검증하고 내가 직접 해야 하는 단계가 남으면 알려줘.

설치와 필요한 승인 절차를 마친 뒤에는 협업할 상대를 찾고 맡길 일을 설명하면 됩니다. 구체적인 시작 절차는 설치와 첫 협업[5]에 정리했습니다.

에이전트의 실행 능력과 도구 사용 능력은 기존 런타임에서 계속 발전합니다. 저는 xsm이 그 개선을 활용하면서, 사람이 판단할 수 있는 위임을 늘리는 소통 기반이 되기를 바랍니다. 그 위에 어떤 조직을 만들고 어떻게 일하게 할지는 사용자가 정합니다.

참고 링크 · 5

  1. [1] xsm(Cross-Session Messaging) — github.com
  2. [2] 조직 운영 문서 — github.com
  3. [3] 인터랙티브 데모 — ysys143.github.io
  4. [4] 런타임 안내 — ysys143.github.io
  5. [5] 설치와 첫 협업 — ysys143.github.io