Claude Code, Codex, Gemini를 결합한 엔지니어링 의사결정 도구: agent-council

커뮤니티 반응

작성자가 직접 도구를 개발하고 도그푸딩을 통해 버그를 잡는 등 실무적인 접근 방식에 대해 긍정적인 반응이 예상된다.

주요 논점

01찬성다수

CLI 에이전트는 로컬 컨텍스트에 접근할 수 있어 API 기반 모델보다 훨씬 정확한 엔지니어링 조언이 가능하다.

합의점 vs 논쟁점

합의점

기존 LLM 카운슬의 API 기반 방식은 프로젝트 맥락 파악에 한계가 있다.
CLI 에이전트의 로컬 파일 시스템 접근 권한이 실무적인 답변 생성에 핵심적이다.

논쟁점

Gemini CLI가 지침을 단계별로 따르지 않고 임의로 답변하는 등 모델 간의 일관성 부족 문제가 존재한다.

실용적 조언

Bun 런타임이 설치된 환경에서 npx cliagent-council 명령어로 즉시 실행 가능하다.
Claude Code나 Gemini CLI 등 기존 CLI 구독이 있는 경우 추가 비용 없이 사용 가능하다.

섹션별 상세

기존 API 기반 LLM 카운슬은 모델이 격리된 환경에서 답변하여 실제 프로젝트 상황을 반영하지 못하는 한계가 있었다. agent-council은 로컬 파일 시스템과 Git 이력에 접근 가능한 CLI 에이전트들을 활용하여 답변의 근거를 실제 코드에 둔다. 작성자는 grep 명령어나 마이그레이션 파일, git log 등을 직접 읽어 분석하는 방식이 더 정확한 엔지니어링 판단을 가능하게 한다고 주장했다. 이는 단순한 텍스트 생성을 넘어 개발 환경의 맥락을 이해하는 실무형 에이전트의 가능성을 보여준다.

이 도구는 Claude Code, Codex, Gemini CLI 등 사용자가 이미 구독 중인 CLI 도구들을 병렬로 실행하여 독립적인 답변을 생성한다. 이후 호출 에이전트가 각 모델의 답변을 취합하여 합의점과 이견을 요약하는 합성 과정을 거친다. 기존 CLI 구독을 그대로 활용하기 때문에 추가적인 API 호출 비용이 발생하지 않는 제로 마진 비용 구조를 실현했다. 여러 고성능 모델의 의견을 비용 부담 없이 교차 검증할 수 있는 실용적인 아키텍처를 제시했다.

bash

npx cliagent-council

agent-council 도구를 설치하고 실행하는 명령어

기술적으로는 Bun 런타임을 사용하여 외부 npm 의존성 없이 구현되었으며 파일 기반 핸드오프와 원자적 쓰기 방식을 통해 데이터 안정성을 확보했다. 41개의 테스트 케이스를 포함하고 있으며 실제 도구 자체의 리팩터링 여부를 결정하는 과정에 3개의 CLI를 동시 투입하는 도그푸딩을 진행했다. 이 과정에서 8개의 버그를 발견하고 수정하는 등 실질적인 품질 개선 효과를 거두었다. 다만 Gemini CLI가 지침을 엄격히 따르지 않는 등의 모델별 특성에 따른 제약 사항도 확인됐다.

용어 해설

명령줄 인터페이스 에이전트(CLI Agent): — CLI 환경에서 실행되며 파일 시스템 접근 및 시스템 명령 실행 권한을 가진 AI 에이전트이다. 로컬 개발 환경의 맥락을 직접 파악할 수 있어 일반적인 API 기반 챗봇보다 정교한 코딩 보조가 가능하다.
도그푸딩(Dogfooding): — 개발자가 자신이 만든 소프트웨어를 실제 업무나 일상에서 직접 사용하며 사용자 관점에서 문제점을 찾아내는 과정이다. 이 게시물에서는 3가지 CLI 에이전트를 동시에 사용하여 도구 자체의 버그 8개를 찾아내는 성과를 거두었다.
원자적 쓰기(Atomic Write): — 데이터 기록 작업이 중간에 중단되더라도 데이터가 손상되지 않도록 전체가 성공하거나 아예 수행되지 않음을 보장하는 방식이다. 다중 에이전트 간의 파일 기반 데이터 교환 시 발생할 수 있는 데이터 오염을 방지하는 데 필수적이다.

언급된 도구

agent-council추천

CLI 에이전트 앙상블 및 의사결정 합성 도구

Bun추천

JavaScript/TypeScript 런타임 및 패키지 매니저

Claude Code추천

Anthropic의 CLI 기반 코딩 에이전트

Gemini CLI중립

Google의 CLI 기반 AI 도구

언급된 리소스

GitHubagent-council GitHub Repository