jnMetaCode/agency-orchestrator

Agency Orchestrator – 무엇인가요

Agency Orchestrator (AO) 는 Node.js 기반의 도구로, 여러 AI "전문가" 를 함께 실행하여 작업을 해결할 수 있습니다. 짧은 YAML 워크플로우를 작성하거나, AO가 단일 자연어 프롬프트에서 워크플로우를 자동 생성하도록 할 수 있습니다. 엔진은 선택된 대규모 언어 모델(LLM) 제공업체를 호출하고, 가능한 경우 단계를 병렬로 실행하며, 출력을 통합하여 최종 결과물을 생성합니다.

핵심 개념

개념	AO의 구현 방식
다중 에이전트 협업	AO는 267개의 중국어 역할 (다국어 팩 포함)을 기본 제공합니다. 각 역할은 LLM이 특정 전문가(예: "프로덕트 매니저", "재무 기획자")처럼 행동하도록 지시하는 시스템 프롬프트입니다.
코드 없이 오케스트레이션	ao compose "<작업 설명>" --run을 실행하면 AO가 적절한 전문가를 선택하고, DAG(방향성 비순환 그래프)를 설계하고 실행합니다. YAML이나 코드가 필요 없습니다.
YAML 워크플로우 파일	반복 가능한 파이프라인을 위해 steps, 각 단계의 role, task 프롬프트, 선택적 acceptance 기준, depends_on 관계를 포함하는 짧은 YAML 파일을 작성합니다. AO는 파일을 분석하고 DAG를 구축한 후 실행합니다.
그래픽 스타디오	로컬 웹 UI(ao web)를 통해 노드를 드래그 앤 드롭하고, 역할을 선택하고, 프롬프트를 편집하며 실시간 진행 상황을 확인할 수 있습니다. UI는 CLI와 동일한 역할 라이브러리와 워크플로우 파일을 공유합니다.
제공업체 유연성	AO는 11개의 LLM 제공업체(Claude, DeepSeek, OpenAI, Gemini 등)를 지원합니다. 그 중 7개는 로컬에 설치된 CLI(Claude-code, Copilot-cli 등)를 사용해 API 키 없이 작동합니다.
안전 우선 서비스 전환	AO는 하위의 Claude 서비스를 사용자 정의 엔드포인트로 교체할 수 있으며, 원래 설정을 자동 백업하여 문제가 발생했을 때 한 번의 클릭으로 복원할 수 있습니다.
결과 공유	실행 후 ao report로 자체 포함형 HTML 리포트를 생성하거나, --notify를 사용해 Webhook을 통해 DingTalk, Feishu, WeChat 그룹에 결과를 전송할 수 있습니다.

누구에게 적합한가요?

• 개인 창업가: 비즈니스 계획, 시장 분석, 콘텐츠 캘린더 등을 AI 팀으로 작성하고 싶은 사람.
• 프로덕트 매니저: 빠른 실현 가능성 조사, PRD 리뷰, 다학제 설계 리뷰가 필요한 사람.
• 개발자: AI 생성 코드 리뷰, 아키텍처 평가, 스크래핑을 원하고 이후 코딩 에이전트에게 인계하고 싶은 사람.
• 콘텐츠 크리에이터: AI 기반 브레인스토밍, 스크립트 작성, 동영상 생성 파이프라인을 원하는 사람.
• 팀: 반복 가능하고 감사 가능한 워크플로우(승인 기준, 버전 관리된 출력, 재개 가능한 실행)가 필요한 사람.

시작하기 (3단계 빠른 시작)

1. 설치 – npm install -g agency-orchestrator (또는 제로 설치 경험을 위한 Electron 데스크톱 클라이언트 다운로드).
2. 원라인 실행 – ao compose "내가 AI 회계 도구를 만들 수 있는지 분석해줘" --run. AO가 적절한 전문가를 선택하고 DAG를 구축한 후 간결한 요약을 출력합니다.
3. 템플릿 탐색 – ao run workflows/一人公司全员大会.yaml -i idea="..."로 사전 구축된 "1인 회사" 워크플로우를 실행합니다. 계획, 마케팅, 재무 등이 포함됩니다.

주요 명령어 (CLI 체트 시트)

명령어	기능
ao demo	다중 에이전트 협업의 간단한 데모.
ao compose "<문장>"	자연어에서 워크플로우 생성.
ao compose "..." --run	생성 하고 즉시 실행.
ao run <workflow.yaml>	저장된 YAML 워크플로우 실행.
ao team save <workflow.yaml> --name <team>	역할 라인업을 재사용 가능한 "팀"으로 저장.
ao run --team <team> "<새 작업>"	저장된 팀을 새 프롬프트로 재사용.
ao prompt optimize "<프롬프트>" --save <name>	AO가 프롬프트를 최적화하고 저장.
ao report	마지막 실행 결과의 공유 가능한 HTML 리포트 생성.
ao serve	MCP 서버를 시작하여 Claude Code, Cursor 등 도구가 AO 워크플로우를 프로그래밍 방식으로 호출할 수 있도록 함.

아키텍처 핵심

• 역할 라이브러리는 ~/.ao/roles (또는 사용자 지정 AO_AGENTS_DIR)에 위치합니다. 각 역할은 시스템 프롬프트를 포함하는 마크다운 파일입니다.
• 워크플로우 엔진은 YAML을 읽고 DAG를 구축하며, 단계 간 {{variables}}를 해결하고, 선택된 LLM 제공업체를 통해 각 단계를 실행합니다.
• 병렬 처리 – AO는 독립적인 브랜치를 자동 감지하고 병렬 실행(설정은 concurrency로 가능)합니다.
• 승인 및 검증 – 단계는 acceptance 기준이나 assert 규칙(파일 수, 토큰 크기, 정규 표현식 매칭)을 선언할 수 있습니다. 실패한 검증은 재시도 또는 방향성 있는 재작업을 트리거합니다.
• 재시작 가능 – --resume 및 --from을 사용하면 이전에 저장된 출력을 사용해 특정 단계에서 재시작할 수 있어 저비용 반복이 가능합니다.
• 확장 가능한 "스킬" – 작은 재사용 가능한 방법론(예: 테스트 주도 개발, 구조화된 코드 리뷰)은 skill 필드를 통해 단계에 연결할 수 있습니다.

생태계 및 확장 기능

• 다국어 역할 팩(agency-agents-ko, pt-br, ar 등)은 npm을 통해 설치 가능하며, 스타디오에서 선택 가능합니다.
• 크리에이티브 자산 – AO는 1500개 이상의 이미지 프롬프트와 76개의 동영상 템플릿을 포함하며, UI에서 직접 사용 가능합니다.
• Docker / NAS 배포 – 공식 이미지 ghcr.io/jnmetacode/agency-orchestrator로 간단한 docker run 명령어로 실행 가능하며, 볼륨 마운트된 ao-data로 키와 출력을 지속화합니다.
• 통합 – 14개의 AI 코딩 어시스턴트(Claude Code, Cursor, Copilot 등)에 내장된 MCP 어댑터로, 글루 코드 없이 AO 워크플로우를 호출할 수 있습니다.

AO를 사용해야 하는 경우 vs. 간단한 대안

상황	AO 사용	단일 채팅 LLM 사용
여러 전문가 시각(제품, 기술, 재무, 마케팅)이 필요	✅ AO가 팀을 구성하고 결과를 통합	❌ 반복해서 질문하고 수동으로 통합해야 함
반복 가능하고 감사 가능한 파이프라인(승인 검사 포함) 필요	✅ YAML + assert/acceptance	❌ 내장된 검증 없음
그래픽 드래그 앤 드롭 뷰 선호	✅ 스타디오 UI	❌ GUI 없음
API 호출료 없이 로컬에서 실행하고 싶음	✅ Claude-code, Copilot-cli, Ollama 등의 CLI 또는 무료 키 없이 사용 가능한 제공업체 사용	❌ 대부분의 단일 채팅 서비스는 키 필요

---

결론: Agency Orchestrator는 복잡하고 다학제적인 작업을 해결하기 위해 여러 AI 에이전트를 오케스트레이션하는 진정한 프로덕션 준비된 프레임워크입니다. 저코드 CLI와 완전 기능의 웹 스타디오를 모두 제공하며, AI 에이전트/다중 LLM 오케스트레이션 분야에 명확히 위치하고 있습니다.