AgentTeam

AgentTeam은 MCP(Model Context Protocol)를 기반으로 구축된 재사용 가능한 AI 소프트웨어 개발 팀입니다. 제품 관리자, 프로젝트 관리자, UX 연구원, UX/UI 디자이너, 프론트엔드, 백엔드, 풀스택, 모바일, DevOps, QA, 보안, 데이터 엔지니어, 데이터 과학자 등 13명의 전문 에이전트가 공유 SQLite 데이터베이스를 통해 소프트웨어 프로젝트에서 협업하며, 각 에이전트는 자신의 역할에 엄격히 제한됩니다.

프로젝트 관리자가 전체를 조율합니다. 프로젝트를 생성하고, 필요한 전문가를 모집하며, 작업을 세분화하고, 호출 세션이 각 전문가를 독립적인 병렬 에이전트로 생성하는 데 사용하는 디스패치 매니페스트(dispatch manifest)(JSON 배열)를 반환합니다. 전문가들은 참여 시 프로젝트 요약 정보를 읽고, 작업 내용과 결정 사항을 기록하며, 구조화된 연구 결과물을 공유하여 다른 에이전트가 이미 찾은 내용을 다시 조사하지 않도록 합니다.

모든 프로젝트 상태는 SQLite에 영구 저장됩니다(12개 도메인에 걸친 44개의 MCP 도구: 프로젝트, 요약, 팀원, 작업, 작업 항목, 작업 댓글, 논의, 결정, 결과물, 사용자 저널). 프로젝트는 UUID로 범위가 지정되며 수명 주기가 관리되므로(활성 → 일시 중지 → 보관 → 종료), 팀은 컨텍스트 손실 없이 세션 간에 작업을 일시 중지하고 재개할 수 있습니다.

MCP를 통해 모든 Claude Code 프로젝트에서 호출되도록 설계되었습니다. claude_desktop_config.json을 서버에 지정하면 모든 프로젝트에서 전체 팀을 구성할 수 있습니다.

사용자 저널

팀이 작업하는 동안 프로젝트 관리자는 대화에서 귀하의 결정, 선호 사항 및 추론을 영구적인 사용자 저널에 기록합니다. 고려했거나 거부한 장치, 비용 제약, 폼 팩터 선호도, 다음 단계 의도 등이 포함됩니다. 이러한 내용은 프로젝트별(또는 프로젝트 간 선호도를 위한 전역적)로 범위가 지정된 구조화된 항목으로 저장되며, 세션 간에 중요한 내용이 손실되지 않도록 종료 시 검토됩니다. 저널은 list_journal_entries를 통해 쿼리할 수 있으므로 향후 에이전트가 새로운 작업을 시작하기 전에 과거 대화에서 확립된 내용을 읽을 수 있습니다.

프로젝트 구조

AgentTeam/
├── agents/               # Agent prompt files — one per role
│   ├── _base-protocol.md # Shared team protocol, constraints, efficiency rules
│   ├── project-manager.md
│   ├── product-manager.md
│   ├── backend-developer.md
│   └── ...
├── mcp-server/           # TypeScript MCP server
│   └── src/
│       ├── index.ts      # Server entry — all 44 tools registered
│       ├── db/
│       │   ├── schema.ts # Table definitions and migrations
│       │   └── connection.ts
│       └── tools/        # One file per domain
└── docs/                 # Design specs and reference guides

Related MCP server: Sprintra

MCP 도구 도메인

시작하기

1. MCP 서버 설치

한 줄 명령(권장):

claude mcp add agent-team -- npx agent-team-mcp

이것으로 끝입니다. Claude Code가 자동으로 서버를 실행하며, 첫 실행 시 /team 스킬이 전역적으로 설치됩니다.

또는 MCP 설정을 수동으로 편집하세요 (~/.claude/settings.json 또는 프로젝트 .claude/settings.json):

{
  "mcpServers": {
    "agent-team": {
      "command": "npx",
      "args": ["agent-team-mcp"]
    }
  }
}

또는 로컬 클론에서:

git clone https://github.com/RichardLemmon/AgentTeam.git
cd AgentTeam/mcp-server
npm install
npm run build
claude mcp add agent-team -- node /path/to/AgentTeam/mcp-server/dist/index.js

토큰 효율적인 아키텍처

에이전트 프롬프트 파일에는 역할별 ID(Identity) 섹션(각 약 100단어)만 포함됩니다. 공유 팀 프로토콜, 제약 조건 및 효율성 규칙은 단일 agents/_base-protocol.md 파일에 있으며, get_team_protocol MCP 도구를 통해 필요할 때 제공됩니다. 이러한 지연 로딩 방식은 모든 에이전트 파일에 프로토콜을 복제하는 것과 비교하여 전체 팀을 생성할 때 약 6,000단어의 컨텍스트를 절약합니다. 결과물 JSON 스키마는 share_artifact 도구 설명에 포함되어 있어 에이전트가 도구 자체에서 이를 발견할 수 있습니다.

2. 사용하기

/team 스킬은 첫 서버 시작 시 ~/.claude/skills/agent-team/에 자동으로 설치됩니다. 다음과 같이 입력하세요:

/team build me a REST API for task management

또는 인자 없이 /team을 사용하여 기존 프로젝트를 확인하고 작업할 프로젝트를 선택하세요.

빠른 시작

/team 스킬 사용 (Claude Code):

/team build me a REST API for task management

스킬 미사용 시:

"프로젝트 관리자를 실행하고 [주제]에 대해 조사하도록 요청해줘"

프로젝트 관리:

/team --projects              # list all projects
/team --projects active       # filter by status
/team --projects delete <name> # delete a project

작동 방식

1. PM이 프로젝트 설정 — 프로젝트 기록을 생성하고, 필요한 전문가를 모집하며, 작업을 생성하고, 프로젝트 요약을 작성한 후 디스패치 매니페스트를 반환합니다.

2. 호출 세션이 전문가 생성 — 매니페스트의 각 전문가는 project_id와 member_id를 가진 독립적인 에이전트로 실행됩니다.

3. 전문가들이 병렬로 작업 — 각 전문가는 프로젝트 요약을 읽고, 작업 항목을 기록하고, 결과물을 공유하며, 작업 댓글과 논의를 통해 소통합니다.

4. 세션 간 상태 유지 — 모든 에이전트는 현재 요약을 읽고 팀이 중단한 지점부터 작업을 재개하여 프로젝트에 다시 참여할 수 있습니다.

5. PM이 종료 — 완료 시 PM은 종료 요약을 작성하고 향후 참조를 위해 주요 사용자 결정 및 선호 사항을 저널에 기록합니다.