에이전트 스웜: AI 코딩 어시스턴트를 위한 다중 에이전트 오케스트레이션 프레임워크

개발 작업을 위한 다중 에이전트 협업
에이전트 스웜은 AI 코딩 에이전트 팀이 자율적으로 함께 작업할 수 있는 프레임워크를 제공합니다. 이 시스템은 다양한 소스에서 작업을 수신하는 리드 에이전트를 사용하여 작업을 세부 작업으로 분해하고, 격리된 Docker 컨테이너에서 실행되는 워커 에이전트에게 위임합니다.
주요 아키텍처 및 기능
- 리드/워커 협업 – 리드 에이전트가 여러 워커 간 작업을 위임하고 추적합니다
- Docker 격리 – 각 워커는 완전한 개발 환경을 갖춘 자체 컨테이너에서 실행됩니다
- 통합 포인트 – 작업 생성을 위한 Slack, GitHub 및 이메일 통합
- 작업 수명 주기 관리 – 우선순위 큐, 의존성, 배포 간 일시 중지/재개
- 누적 메모리 – 에이전트가 모든 세션에서 학습하고 시간이 지남에 따라 개선됩니다
- 지속적 정체성 – 각 에이전트는 고유한 성격, 전문성 및 작업 스타일을 유지합니다
- 대시보드 UI – 에이전트, 작업 및 에이전트 간 채팅의 실시간 모니터링
- 서비스 디스커버리 – 워커가 HTTP 서비스를 노출하고 서로를 발견할 수 있습니다
- 예약 작업 – Cron 기반 반복 작업 자동화
빠른 시작 옵션
이 프레임워크는 여러 배포 접근 방식을 지원합니다:
옵션 A: Docker Compose (권장)
git clone https://github.com/desplega-ai/agent-swarm.git
cd agent-swarm
# 환경 구성
cp .env.docker.example .env
# .env 편집 — 최소한 API_KEY와 CLAUDE_CODE_OAUTH_TOKEN 설정
# 모든 항목 시작
docker compose -f docker-compose.example.yml --env-file .env up -dAPI는 3013 포트에서 실행됩니다.
옵션 B: 로컬 API + Docker 워커
git clone https://github.com/desplega-ai/agent-swarm.git
cd agent-swarm
bun install
# 1. API 서버 구성 및 시작
cp .env.example .env
# .env 편집 — API_KEY 설정
bun run start:http새 터미널에서 워커를 시작합니다:
# 2. Docker 워커 구성 및 실행
cp .env.docker.example .env.docker
# .env.docker 편집 — API_KEY(위와 동일) 및 CLAUDE_CODE_OAUTH_TOKEN 설정
bun run docker:build:worker
mkdir -p ./logs ./work/shared ./work/worker-1
bun run docker:run:worker옵션 C: Claude Code를 리드 에이전트로 사용
# API 서버 시작 후(옵션 B, 1단계):
bunx @desplega.ai/agent-swarm setup이렇게 하면 Claude Code가 스웜에 연결되도록 구성됩니다. Claude Code를 시작하고 "에이전트 스웜에서 리드 에이전트로 자신을 등록하세요."라고 말하세요.
작동 방식
시스템은 다음 흐름을 따릅니다: Slack DM, GitHub @멘션, 이메일 또는 API를 통해 직접 작업을 보냅니다. 리드 에이전트는 작업을 분해하고 워커에게 세부 작업을 할당하여 계획을 세웁니다. 워커는 git, Node.js, Python 및 기타 개발 도구를 갖춘 격리된 Docker 컨테이너에서 실행됩니다. 진행 상황은 대시보드를 통해 실시간으로 추적됩니다.
이러한 다중 에이전트 시스템은 작업을 분해하고 병렬로 실행해야 하며 각 에이전트가 작업의 다른 측면에 특화된 복잡한 개발 워크플로우를 자동화하려는 개발자에게 유용합니다.
📖 전체 소스 읽기: HN AI Agents
👀 See Also

OpenClaw와 LLM 사용에 관한 실제 통찰: 도전 과제와 한계
OpenClaw 사용자가 Discord 봇과의 통합 문제를 설명하며, 무의미한 응답을 언급했습니다.

넬슨: 해군 함대처럼 AI 에이전트를 조율하는 클로드 코드 플러그인
Nelson은 19세기 해군 함대의 원칙에서 영감을 받은 조직적 원칙을 사용하여 AI 에이전트 작업을 조정하는 Claude Code 플러그인입니다. 세 가지 실행 모드, 위험 분류 시스템, 선체 무결성 모니터링 및 일반적인 안티패턴을 방지하는 상비 명령 게이트를 특징으로 합니다.

Repowise: 클로드 코드를 위한 사전 계산된 코드베이스 컨텍스트가 토큰 사용량과 작업 시간을 절반으로 줄이다
Repowise는 코드베이스를 네 개의 계층(의존성 그래프, Git 신호, 문서 위키, ADR)으로 인덱싱하여 Claude Code에 8개의 MCP 도구를 제공합니다. 30개 파일을 탐색해야 했던 작업을 5번의 MCP 호출과 2분으로 줄여줍니다.

Depct 도구는 Claude가 프로덕션 문제를 디버깅하는 데 도움이 되도록 런타임 데이터를 수집합니다.
Depct는 Node.js 애플리케이션에서 런타임 계측 데이터를 수집하고, 이를 그래프로 구성한 후 AWS Bedrock을 통해 Claude에 전달하여 간헐적으로 발생하는 프로덕션 장애를 디버깅하는 데 도움을 주는 도구입니다. 또한 런타임 동작에서 아키텍처 다이어그램과 의존성 맵을 생성합니다.