🔥 01. agency-agents: 올인원 에이전시 프레임워크

한 번에 여러 전문 역할을 복사해 넣어 쓸 수 있게 만든 역할형 에이전트 라이브러리다. 프론트엔드, 백엔드, 보안, 코드리뷰, SRE, 마케팅처럼 각 분야별 에이전트 파일이 정리돼 있어 “일단 팀을 구성하고 시작”하고 싶은 사람에게 직관적이다.

이 레포는 1위 · ⭐ +23.2K로 회자된 프로젝트다. 별 숫자만 보면 유행처럼 보일 수 있지만, 실제로는 개발자들이 지금 어디에 시간을 쓰고 있는지를 꽤 솔직하게 드러낸다. 많은 팀이 이제 하나의 만능 에이전트보다 역할이 분리된 에이전트를 원한다. agency-agents는 그 요구를 아주 직설적으로 만족시킨다. 역할 설명, 말투, 산출물 기대치, 사용 시점까지 파일 안에 넣어놔서 복사 즉시 실험이 가능하다.

flowchart LR
A[문제] --> B[agency-agents]
B --> C[설치]
C --> D[최소 실험]
D --> E[업무 적용 판단]

칠판 판서형 치트시트

• 이 레포의 한 줄 키워드는 agency-agents다.
• 이번 보강에서는 설치와 사용 순서를 공식 README 기준으로 더 촘촘하게 정리했다.
• 읽을 때는 전제 조건 → 설치 → 첫 실행 → 검증 순서로 보면 된다.
• “대단해 보인다”보다 “내 업무에서 반복 비용을 줄이는가”를 먼저 본다.

이 레포를 한 줄로 보면

한 번에 여러 전문 역할을 복사해 넣어 쓸 수 있게 만든 역할형 에이전트 라이브러리다. 프론트엔드, 백엔드, 보안, 코드리뷰, SRE, 마케팅처럼 각 분야별 에이전트 파일이 정리돼 있어 “일단 팀을 구성하고 시작”하고 싶은 사람에게 직관적이다.

왜 지금 이 레포가 뜨는가

많은 팀이 이제 하나의 만능 에이전트보다 역할이 분리된 에이전트를 원한다. agency-agents는 그 요구를 아주 직설적으로 만족시킨다. 역할 설명, 말투, 산출물 기대치, 사용 시점까지 파일 안에 넣어놔서 복사 즉시 실험이 가능하다.

레포 안에서 먼저 볼 것

• 엔지니어링·디자인·세일즈·커뮤니티 등 직무별 에이전트 파일 묶음
• 각 에이전트마다 정체성, 워크플로우, 산출물 기대치, 성공 기준이 들어 있음
• Claude Code 외에도 Cursor·Copilot·aider·Windsurf용 변환 스크립트를 제공

설치 전에 확인할 것

• Git으로 레포를 내려받을 수 있는 환경
• Claude Code 또는 다른 코딩 하니스 하나
• 처음에는 역할 1~2개만 골라 시험할 작은 프로젝트

설치 방법

공식 확인 링크

• GitHub README: https://github.com/msitarzewski/agency-agents
• Claude Code 기준 빠른 설치 예시는 README의 Quick Start 섹션을 우선 본다.

기본 설치: Claude Code에 에이전트 복사

git clone https://github.com/msitarzewski/agency-agents
cd agency-agents
cp -r agency-agents/* ~/.claude/agents/

이 방식은 가장 단순하다. Claude Code를 쓰는 사람이라면 별도 빌드 없이 에이전트 파일을 복사해 바로 시작할 수 있다. 설치 후에는 ~/.claude/agents/ 아래에 역할별 markdown 파일이 들어왔는지 한 번 확인하면 된다.

다른 도구에 붙일 때

git clone https://github.com/msitarzewski/agency-agents
cd agency-agents
./scripts/convert.sh
./scripts/install.sh

특정 도구만 노린다면 아래처럼 직접 지정할 수 있다.

./scripts/install.sh --tool cursor
./scripts/install.sh --tool copilot
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf

README 기준으로는 먼저 convert.sh로 지원 도구용 통합 파일을 만들고, 그다음 install.sh로 실제 설치를 진행하는 흐름이다.

설치 확인

• Claude Code라면 ~/.claude/agents/에 파일이 생겼는지 본다.
• 다른 도구라면 설치 스크립트가 어떤 경로에 파일을 복사했는지 로그를 확인한다.

사용 방법

1. Claude Code 세션을 새로 열고, 바로 모든 역할을 섞지 말고 하나의 역할만 먼저 불러본다.
2. 예를 들어 activate Frontend Developer mode and help me build a React component처럼 역할명+작업을 같이 준다.
3. 첫 실행에서는 산출물 형식이 기대와 맞는지 본다. 코드, 문서, 리뷰 포인트가 원하는 톤으로 나오는지 체크한다.
4. 그다음에만 Code Reviewer나 Security Engineer 같은 검증 역할을 뒤에 추가해 이중 검토 구조를 만든다.

Hey Claude, activate Frontend Developer mode and help me build a React component.
Hey Claude, activate Code Reviewer mode and review this PR for security and maintainability.

이 프로젝트의 핵심은 “프롬프트 한 줄”보다 역할 파일 자체다. 그래서 실제 사용 전에는 해당 역할 markdown을 한 번 열어보고, 지금 프로젝트에 안 맞는 문장을 조금 덜어내는 편이 안정적이다.

어디에 바로 써먹을 수 있나

사례 A. 작은 제품팀

디자이너가 따로 없고 프론트엔드 인력도 부족한 팀이라면 UI Designer와 Frontend Developer 에이전트를 번갈아 붙여서 와이어프레임→구현까지 빠르게 굴릴 수 있다. 이때 핵심은 두 역할이 같은 일을 중복하지 않게, 한쪽은 화면 기준을 정하고 다른 한쪽은 코드 구현만 맡기도록 책임을 나누는 것이다.

사례 B. PR 품질 관리

코드를 막 짜는 에이전트보다 Code Reviewer나 Security Engineer 역할을 뒤에 붙이면 되돌림 횟수가 줄어든다. 실제 운영에서는 “생성 담당”과 “검증 담당”을 분리하는 순간 결과 품질이 확 올라가는 경우가 많다.

처음 해볼 최소 실험

1. engineering/ 폴더에서 지금 필요한 역할 1개만 고른다.
2. 역할 파일을 읽고 프로젝트에 안 맞는 문장을 3개 정도 수정한다.
3. 동일한 작업을 역할 적용 전/후로 한 번씩 시켜보고 산출물 차이를 비교한다.
4. 마지막으로 검증 역할 하나를 추가해 중복 지시 없이 잘 협업하는지 본다.

검증 포인트는 간단하다. 첫 실험에서는 속도보다 역할 충돌이 있는지만 본다. 같은 요구를 두 에이전트가 중복 처리하거나, 서로 다른 기준으로 답하면 설계가 덜 된 것이다.

볼 때 주의할 점

• 역할이 많다고 성능이 자동으로 좋아지지 않는다. 필요한 역할만 골라야 한다.
• 각 역할의 경계가 불명확하면 에이전트끼리 같은 일을 두 번 하게 된다.
• 만능 조직도처럼 보이지만, 결국 프로젝트 문맥에 맞는 현지화 작업은 필요하다.

다음 읽기

• 🔥 02. superpowers
• 🔥 09. Deep Agents
• 🔥 Git Trend 허브

이 글은 AI를 활용해 초안을 정리했고, GitHub README와 공식 링크를 다시 확인해 실무 적용 관점으로 풀어썼다.