ONEDEV

ccg-workflow

AI Agent OrchestrationCLIGo

★ 5,882주당 +20조회 4

무엇인가

CCG는 Claude Code 위에 얹히는 오케스트레이션 계층이다. 단일 모델 대화형 CLI를 여러 모델을 부리는 지휘자로 바꾸는 것이 목적이며, 사용자가 작업을 한 번 서술하면 의도 분석·전략 선택·모델 배분을 엔진이 대신한다. 코딩 에이전트의 작업 분배와 세션 상태 유지가 이 도구가 다루는 문제 영역이다.

어떻게 동작하나

구성은 세 부분이다. Claude Code가 리드 오케스트레이터로 남아 의도를 분석하고 전략을 고른다. Hook Engine은 4개의 JavaScript 훅으로 매 턴 상태를 세션에 주입한다. codeagent-wrapper는 컴파일된 Go 바이너리로, Claude와 외부 모델(Codex/OpenAI, Grok/xAI, Kimi Code/Moonshot, Antigravity) 사이의 호출을 중계한다. 작업 유형과 복잡도에 따라 10개 내장 전략 중 하나가 자동 선택되고, 중간 이상 복잡도 작업은 영구 디렉터리를 배정받는다. 메시지에 보안·캐싱·RAG·Kubernetes 같은 키워드가 있으면 해당 도메인 지식 파일이 자동 주입된다.

무엇과 다른가

차이는 상태 관리에 있다. Claude Code를 단독으로 쓰거나 여러 모델 CLI를 손으로 오가면 대화가 압축될 때마다 맥락이 끊기고 서브에이전트는 스펙 없이 시작한다. CCG는 훅으로 상태를 매 턴 재주입해 컴팩션 이후에도 맥락을 유지하고, 서브에이전트를 스펙이 프롬프트에 포함된 상태로 띄운다. 같은 패키지에 포함된 dsh-ccg는 DeepSeek Harness 안에서 같은 역할 매트릭스를 네이티브로 실행하며, 한 역할에 여러 모델을 붙여 같은 브리프에 독립적으로 답하게 하는 모델 패널과 턴을 넘어 유지되는 ccg_team 동료를 갖는다. 패널은 투표나 평균을 내지 않고 불일치 자체를 결과로 남긴다.

어떻게 쓰나

설치는 `npx ccg-workflow` 한 줄로 시작한다. 전체 설치 경로는 다중 모델 오케스트레이션과 명령, 훅, 바이너리를 함께 넣는다. 스킬만 필요하면 네이티브 플러그인으로 설치하며, 명령은 `/ccg:` 접두사로 호출한다. 환경 변수는 `~/.claude/settings.json`의 `"env"` 항목에 넣는다.

전제와 한계

전제 조건은 Node.js 20+와 Claude Code CLI다. Codex CLI, Grok CLI, Kimi Code CLI, Antigravity는 선택 사항이며, 설치해야 해당 다중 모델 기능이 켜진다. 네이티브 플러그인 경로는 스킬만 배포하고 다중 모델 명령은 포함하지 않는다 — 명령 템플릿이 설치 시점에 채워지는 플레이스홀더를 쓰기 때문이다. bt-panel 스킬은 자격증명을 환경 변수나 git에 커밋되지 않는 sites.json에서만 읽는다.

관련 논문 2

유사 도구