yohey-w/multi-agent-shogun

What it solves

이것은 여러 AI 코딩 에이전트를 실행할 때 발생하는 높은 API 비용과 조정 오버헤드를 제거합니다. 오케스트레이션(orchestration)을 위해 토큰당 비용을 지불하는 대신, 고정 요금제 CLI 구독을 활용하여 내부 통신에 토큰을 소모하지 않고 여러 독립적인 에이전트를 병렬로 실행합니다.

How it works

이 시스템은 tmux 분할 창(split-panes)과 디스크 상의 YAML 파일을 통해 구현된 일본 봉건 계급 구조(Shogun $\rightarrow$ Karo $\rightarrow$ Ashigaru)를 사용합니다.

• Shogun: 사용자 명령을 수신하고 이를 위임합니다.
• Karo: 작업을 세분화하고 작업자에게 배분하는 관리자 에이전트입니다.
• Ashigaru: 작업을 병렬로 실행하는 7개의 작업자 에이전트입니다.
• Gunshi: 보고서를 검토하는 전략가 에이전트입니다.

에이전트들은 YAML 파일을 통해 비동기적으로 통신하므로, 조정(coordination)을 위해 API 호출이 낭비되지 않습니다. Claude Code, OpenAI Codex, GitHub Copilot, Kimi Code, OpenCode, Cursor, Antigravity를 포함한 다양한 CLI 도구를 지원하며, 통일된 지침 빌드 시스템을 사용하여 서로 다른 벤더 간에 규칙을 일관되게 유지합니다.

Who it’s for

완전한 투명성과 예측 가능한 월간 비용을 유지하면서 복잡한 코딩 작업을 병렬로 처리하기 위해 AI 에이전트 """군대"""를 배치하고자 하는 개발자들을 위한 것입니다.

Highlights

• Zero Coordination Overhead: API 기반 오케스트레이션 대신 디스크 기반 YAML 통신을 사용합니다.
• Multi-CLI Support: 7개의 서로 다른 AI 코딩 CLI와 호환되어 사용자가 강점을 조합하여 사용할 수 있습니다.
• Bottom-Up Skill Discovery: 에이전트가 작업 중에 재사용 가능한 패턴을 자동으로 식별하고, 사용자가 승인할 수 있도록 영구적인 기술(skills)로 제안합니다.
• Live Observability: 모든 에이전트는 실시간 대시보드와 함께 자신만의 가시적인 tmux 창에서 실행됩니다.
• Mobile Command Center: 에이전트를 모니터링하고 SSH 및 음성 입력을 통해 명령을 보내는 전용 Android 앱이 포함되어 있습니다.