AI에 전문가 역할 279개 붙이기: Agency Agents 설치 가이드

AI에게 일을 맡겼는데 답은 그럴듯해도 결과물이 매번 들쭉날쭉할 때가 있습니다.

이럴 때는 모델을 바꾸기 전에 맡길 역할과 작업 기준을 더 구체적으로 정해볼 수 있습니다. 사람에게도 “알아서 잘해줘”보다 기획자·디자이너·개발자 중 어떤 역할인지 알려주는 편이 낫습니다.

Agency Agents는 이런 역할 지침을 공개 파일로 모아둔 프로젝트입니다. 2026년 9월 18일 공식 설치기의 목록을 직접 확인하니 18개 팀, 279개 역할이 들어 있었습니다.

역할 파일에는 무엇이 들어 있나

역할 파일의 구성은 모두 같지 않습니다. 역할 설명, 필요한 역량, 사용하기 좋은 상황, 업무 원칙, 산출물 예시, 성공 지표 가운데 일부가 역할에 맞게 들어 있습니다.

content-creator에는 콘텐츠 전략과 사용 상황, 성공 지표가 있습니다. ui-designer와 frontend-developer에는 작업 원칙과 구체적인 산출물 예시가 더 많이 들어 있습니다. 모델을 279개 받는 것이 아니라 한 모델에 붙일 수 있는 279개의 역할 지침을 받는 셈입니다.

msitarzewskiagency-agentsRepository

GitHub API 기준 ★15.3만, MIT 라이선스였고 최근에도 업데이트되고 있었습니다. 숫자는 계속 바뀌므로 설치할 때 공식 저장소를 다시 확인하는 편이 안전합니다.

가장 쉬운 방법은 데스크톱 앱

터미널이 낯설다면 공식 앱이 가장 간단합니다.

https://agencyagents.app

맥·윈도우·리눅스용 앱에서 평소 쓰는 AI 도구를 고르고, 필요한 팀이나 역할만 체크한 뒤 설치하면 됩니다. Claude Code, Cursor, Codex, Gemini CLI, OpenCode 등을 지원합니다.

맥에서는 최신 릴리스가 안내하는 두 줄로 앱을 설치할 수 있습니다.

brew trust --cask msitarzewski/agency-agents/agency-agents
brew install --cask agency-agents

처음이라면 세 역할만

하고 싶은 일	먼저 골라볼 역할	하는 일
콘텐츠 기획·초안	content-creator	아이디어를 콘텐츠 구조와 초안으로 바꿈
웹·앱 화면 설계	ui-designer	화면 구조와 시각 기준을 잡음
화면을 코드로 구현	frontend-developer	확정된 설계를 실제 프론트엔드로 옮김

콘텐츠 제작이 목적이라면 social-media-strategist, 사업 아이디어를 검토하려면 business-strategist, 결과를 점검하려면 reality-checker를 추가할 수 있습니다.

279개를 한꺼번에 설치한다고 모델 성능이 올라가지는 않습니다. 지금 하는 일과 직접 연결된 역할부터 넣는 편이 낫습니다.

터미널 설치: 전역 도구와 프로젝트 도구를 구분하기

역할 저장소를 홈 폴더에 내려받습니다.

git clone https://github.com/msitarzewski/agency-agents.git "$HOME/agency-agents"
AGENCY="$HOME/agency-agents"

Claude Code, Codex, Gemini CLI는 기본적으로 사용자 전체에서 쓰는 경로에 설치됩니다. 처음에는 세 역할만 골라 설치해보세요.

"$AGENCY/scripts/install.sh" --tool claude-code \
  --agent content-creator,ui-designer,frontend-developer

"$AGENCY/scripts/install.sh" --tool codex \
  --agent content-creator,ui-designer,frontend-developer

"$AGENCY/scripts/install.sh" --tool gemini-cli \
  --agent content-creator,ui-designer,frontend-developer

Cursor와 OpenCode는 기본 설치 위치가 현재 폴더 안입니다. 저장소를 복제한 agency-agents 폴더에서 그대로 실행하면 그 폴더에 역할이 들어갑니다. 실제 작업할 프로젝트로 이동한 뒤 설치해야 합니다.

cd /내/프로젝트/경로

"$AGENCY/scripts/install.sh" --tool cursor \
  --agent content-creator,ui-designer,frontend-developer

"$AGENCY/scripts/install.sh" --tool opencode \
  --agent content-creator,ui-designer,frontend-developer

OpenCode는 현재 약 119개까지만 에이전트를 등록하는 상위 도구 문제가 있습니다. 전체 279개를 설치하면 약 160개가 등록되지 않을 수 있으므로 --division이나 --agent로 범위를 줄이세요.

부서 18개 전체 목록과 인원

영상에서 말한 “부서만 골라 까는” 옵션이 --division입니다. 설치기에 어떤 부서가 있고 각각 몇 명인지 미리 알아야 고를 수 있으니, 2026년 9월 23일 기준으로 install.sh --list divisions 결과를 그대로 옮겼습니다. 합계는 279명입니다.

부서 옵션값	하는 일	인원
engineering	엔지니어링	64
specialized	전문직(법무·의료 등)	59
marketing	마케팅	36
game-development	게임 개발	21
gis	지리정보(GIS)	13
security	보안	12
design	디자인	10
sales	영업	9
testing	테스트/QA	9
paid-media	유료 광고	7
project-management	프로젝트 관리	7
academic	학술	6
spatial-computing	공간 컴퓨팅(AR/VR)	6
support	고객 지원	6
finance	재무	5
product	프로덕트	5
healthcare	헬스케어	3
research	리서치	1

부서 하나만 설치하려면 옵션 뒤에 위 표의 옵션값을 적습니다.

"$AGENCY/scripts/install.sh" --tool claude-code --division engineering

쉼표로 여러 부서를 함께 넣을 수도 있습니다.

"$AGENCY/scripts/install.sh" --tool claude-code --division design,marketing

부서 이름과 인원은 저장소가 업데이트되면 바뀝니다. 설치 전에 직접 확인하는 명령이 따로 있습니다.

"$AGENCY/scripts/install.sh" --list divisions

specialized에는 법률 문서 검토처럼 개발과 무관한 역할이 모여 있어서, 이름만 보고는 무엇이 들어 있는지 알기 어렵습니다. 부서 안의 역할 이름까지 보려면 아래로 확인합니다.

"$AGENCY/scripts/install.sh" --list agents

설치한 역할을 실제로 부르는 법

도구마다 호출 방식이 다릅니다. 자연어로 역할을 흉내 내달라고 하는 대신 설치된 역할을 명시적으로 지정해야 합니다.

Claude Code에서는 역할 이름을 부릅니다.

Activate Content Creator and turn this idea into a five-card Instagram post.

Codex도 TOML 안의 역할 이름을 기준으로 호출합니다.

Use the Content Creator agent to turn this idea into a five-card Instagram post.

Cursor와 OpenCode에서는 @와 파일 슬러그를 사용합니다.

@content-creator 이 아이디어를 인스타그램 카드뉴스 5장 구조로 바꿔줘.

역할이 적용됐는지 확인하려면 첫 답변에서 사용한 작업 기준과 산출물 구조를 설명해달라고 요청하세요. 설치 전후의 답변 구조를 같은 요청으로 비교하는 것도 좋습니다.

무료이지만 AI 사용료까지 0원은 아니다

역할 파일은 MIT 라이선스로 공개돼 있어 무료로 내려받고 수정할 수 있습니다. 하지만 이 파일을 실행할 Claude, GPT, Gemini 같은 모델의 구독료나 API 비용은 별도입니다.

설치만으로 279명의 직원이 밤새 자동으로 협업하는 것도 아닙니다. 기본 실체는 역할별 파일입니다. 자동 실행, 일정 관리, 역할 간 작업 전달까지 원한다면 사용하는 도구의 에이전트 기능이나 별도 자동화가 필요합니다.

무료로 얻는 것은 “전문가 279명의 노동”이 아니라, 직접 정리하려면 시간이 드는 279개의 역할 정의와 업무 지침입니다.

하나만 붙여 오늘 써보기

지금 만드는 것이 글이면 content-creator, 화면이면 ui-designer, 코드면 frontend-developer 하나만 설치하세요. 평소 AI에게 하던 요청을 그대로 넣고 역할을 붙이기 전후의 결과물 구조가 어떻게 달라지는지 비교해보면 됩니다.

2026년 9월 18일 공식 저장소, 설치기 출력, 도구별 통합 문서와 최신 앱 릴리스로 확인했습니다. 역할 수·지원 도구·설치 명령은 업데이트될 수 있습니다.