매번 에이전트를 복사/붙여넣기 하고 있었다

Claude Code의 서브 에이전트 (sub-agent)는 최고지만, 사용하다 보니 같은 작업을 반복하고 있다는 사실을 깨달았습니다. 새로운 프로젝트를 시작할 때마다 동일한 에이전트 집단 —— 구현 담당, 리뷰 담당, 스택 규약을 준수하는 담당 —— 을 매번 복사/붙여넣기 하고 있습니다. 꽤 괜찮은 구성임에도 불구하고, 하나의 리포지토리(repository)에 갇혀 있어 재사용할 수 없습니다.

또한, 새로운 기술 스택으로 개발할 경우, 다시 새로운 서브 에이전트를 고민해야 합니다.

그래서 ccteams를 만들었습니다. **에이전트 팀의 패키지 매니저 (package manager)**입니다. 1개의 명령어로 준비된 Claude Code 서브 에이전트 '팀'을 프로젝트에 적용할 수 있습니다.

npm install -g ccteams
ccteams use go-api

예를 들어, 이를 통해 현재 프로젝트에 net/http에 맞춰 튜닝된 Go의 builder + reviewer가 들어옵니다. 작업이 바뀌면 전환하기만 하면 됩니다.

ccteams use next-ts # Next.js App Router + TypeScript + Tailwind
ccteams use generalist # 요구사항 정의 → 설계 → 구현 → QA → 출시 (스택 비의존)

애초에 **어떤 팀이 좋을지 모르겠다!**는 경우에도 안심하세요. 플러그인 (plugin) 기능을 준비했으므로, /ccteams:choose-team을 사용하여 직접 AI에게 물어볼 수 있습니다.

/plugin marketplace add toffyui/ccteams
/plugin install ccteams@ccteams
/ccteams:choose-team 뭔가 괜찮은 앱을 만들고 싶어

이렇게 하는 것만으로, AI가 당신을 위해 자동으로 괜찮은 팀을 골라 설정까지 완료해 줍니다.

「팀」이란 무엇인가

ccteams가 말하는 팀이란 Claude Code 서브 에이전트 군입니다. 각 에이전트는 친숙한 markdown (name / description / tools의 프론트매터 (frontmatter) + 시스템 프롬프트 (system prompt))으로 구성되며, 여기에 orchestration.md (CLAUDE.md에 포함되는 규칙)가 붙습니다. 특별한 메커니즘이나 독자적인 포맷은 없습니다. 직접 수동으로 만들어야 했을 구성을 처음부터 갖추어 재사용할 수 있다, 그뿐입니다.

동봉된 팀은 8개입니다:

• generalist — 스택 비의존. 기능을 요구사항 정의 → 설계 → 구현 → QA → 출시까지 담당
• next-ts — Next.js App Router + TypeScript + Tailwind
• frontend — 프레임워크 비의존 UI/UX · 접근성(accessibility)
• go-api — Go의 HTTP API
• python-fastapi — FastAPI + Pydantic v2
• rails — Ruby on Rails
• debug — 재현 → 원인 특정 → 수정 → 회귀 테스트 (regression test)
• research — 선택지를 비교하여 제안 (코드는 작성하지 않음)

ccteams use가 실제로 하는 일

블랙박스로 만들지 않았습니다. ccteams use <team>의 동작은 다음과 같습니다:

• 팀의 agent 파일을 .claude/agents/에 복사
• .claude/active-team.md를 배치하고, CLAUDE.md에 @.claude/active-team.md의 import 행을 추가
• 배치된 파일들을 .claude/.ccteams-manifest.json으로 추적하여 팀 전환을 깔끔하게 처리
• 직접 작성한 동일한 이름의 agent는 덮어쓰지 않음 (충돌 방지 기능 포함)

다른 팀으로 전환할 때는 이전에 ccteams가 배치했던 것만 삭제합니다. 직접 작성한 파일에는 손대지 않으므로, 이미 어느 정도 서브 에이전트를 직접 만들어 두었더라도 안심할 수 있습니다.

플러그인 기능

더 편리하게 사용할 수 있도록 플러그인 기능도 준비했습니다.

이 플러그인을 설치하면 Claude Code를 벗어나지 않고 슬래시 명령어 (slash command)로 조작할 수 있습니다.

/plugin marketplace add toffyui/ccteams
/plugin install ccteams@ccteams

이제 /ccteams:list-teams,
/ccteams:use-team <team>,
그리고 개인적으로 가장 유용하다고 생각하는 /ccteams:choose-team을
사용할 수 있습니다. choose-team은 하고 싶은 일을 자연어 (natural language)로 작성하면 최적의 팀을 선택해 주는 명령어입니다.

서브 에이전트 간의 상호 작용을 원하는 분들을 위해

서브 에이전트들을 병렬로 구동하여 서로 상호 작용하게 만들고 싶다면 --agent-teams를 붙여서 agent-teams 모드를 활성화할 수 있습니다.

ccteams use generalist --agent-teams

이렇게 하면 프로젝트에 대해 팀을 만들어서 xx해줘라고 요청함으로써 에이전트 팀 (agent team)이 기동됩니다.

직접 시도해 보세요

pm install -g ccteams
ccteams list

오픈 소스 (MIT)입니다: github.com/toffyui/ccteams. GitHub에서 스타 (star)를 눌러주시면 큰 힘이 됩니다.

또한, 실제로 사용하고 싶은 기능이 있다면 수시로 팀을 늘려나갈 계획이니 편하게 댓글 남겨주시면 감사하겠습니다!

Discussion