에반게리온에서 영감을 받은 Claude Code용 멀티 에이전트 리뷰 플러그인 'MAGI' 개발

커뮤니티 반응

대체로 매우 긍정적이며, 에반게리온의 컨셉을 실제 소프트웨어 공학의 다중 관점 분석에 성공적으로 접목했다는 평가를 받았다.

주요 논점

01찬성다수

단일 LLM의 판단보다 세 가지 서로 다른 페르소나를 통한 검토가 더 신뢰할 수 있는 결과를 제공한다.

합의점 vs 논쟁점

합의점

에이전트 간의 의견 불일치는 시스템의 결함이 아니라 중요한 분석 지표이다.
비동기 병렬 처리는 멀티 에이전트 시스템의 실용성을 확보하는 핵심 기술이다.

논쟁점

에이전트 수가 늘어남에 따라 발생하는 API 비용 증가와 성능 간의 균형 문제

실용적 조언

Claude Code 사용 시 claude --plugin-dir 명령어로 MAGI 플러그인을 설치하여 즉시 다중 에이전트 리뷰 기능을 사용할 수 있다.
복잡한 아키텍처 결정 시 analysis 모드를 활용하여 Redis와 Postgres 중 선택하는 것과 같은 트레이드오프 분석을 수행할 수 있다.

섹션별 상세

MAGI 시스템은 세 가지 고유한 페르소나를 가진 에이전트로 구성됐다. 기술적 엄밀함을 따지는 Melchior, 실용성을 중시하는 Balthasar, 비판적 시각의 Caspar가 각각 독립적으로 분석을 수행한다. 각 에이전트는 서로의 출력을 보지 못한 상태에서 구조화된 JSON 형식의 판결문을 생성한다. 이를 통해 단일 모델의 편향을 줄이고 다각적인 검토 결과를 도출했다.

의사결정은 가중치 기반의 합의 알고리즘을 통해 이루어졌다. 승인은 +1점, 조건부 승인은 +0.5점, 거절은 -1점으로 계산하여 최종 점수에 따라 'Strong Go'부터 'Strong No-Go'까지의 결론을 내린다. 에이전트 간의 불일치를 실패가 아닌 유용한 신호로 간주하여 잠재적인 위험 요소를 시각화했다. 이러한 방식은 단순한 텍스트 요약보다 명확한 의사결정 지표를 제공한다.

기술적으로는 Python 3.9 이상 환경에서 asyncio를 활용해 에이전트들을 병렬로 실행했다. claude -p 명령어를 통해 여러 에이전트가 동시에 추론을 수행하므로, 전체 소요 시간은 가장 느린 에이전트의 응답 시간과 동일하게 유지된다. 에이전트 중 하나가 실패하더라도 나머지 두 에이전트의 결과로 합의를 진행하는 성능 저하 모드(Degraded mode)를 지원하여 안정성을 확보했다.

bash

mkdir -p .claude/skills
ln -s ../../skills/magi .claude/skills/magi

Claude Code에서 MAGI 플러그인을 자동 인식하도록 심볼릭 링크를 생성하는 방법

사용자는 code-review, design, analysis의 세 가지 모드를 선택하여 활용할 수 있다. 코드 리뷰 모드에서는 구체적인 라인별 수정 사항을 제안하고, 디자인 모드에서는 아키텍처 결정의 트레이드오프를 평가한다. 일반적인 문제 분석 모드에서는 특정 기술 스택 선택과 같은 전략적 질문에 대한 답변을 제공한다.

용어 해설

멀티 에이전트 시스템(Multi-Agent System): — 여러 독립적인 AI 에이전트가 협력하거나 경쟁하며 복잡한 문제를 해결하는 아키텍처이다. 각 에이전트에게 고유한 역할과 페르소나를 부여하여 단일 모델보다 다각적인 분석이 가능하다.
적대적 검토(Adversarial Review): — 시스템의 취약점이나 오류를 찾기 위해 의도적으로 비판적인 관점에서 검토를 수행하는 방식이다. 보안 허점이나 엣지 케이스를 사전에 식별하여 소프트웨어의 안정성을 높이는 데 기여한다.
가중 다수결 투표(Weighted Majority Vote): — 각 투표권자에 서로 다른 가중치를 부여하여 최종 의사결정을 내리는 합의 알고리즘이다. 이 시스템에서는 승인, 조건부 승인, 거절에 각각 점수를 매겨 전체적인 합의 수준을 수치화한다.
비동기 입출력(Asyncio): — 파이썬에서 비동기 프로그래밍을 지원하는 라이브러리로, 입출력 대기 시간을 효율적으로 관리한다. 여러 AI 에이전트의 응답을 동시에 처리하여 전체 실행 시간을 단축하는 데 필수적이다.
클로드 코드(Claude Code): — Anthropic에서 출시한 터미널 기반 AI 코딩 에이전트 도구이다. 로컬 파일 시스템에 접근하여 코드를 직접 작성, 수정, 실행하며 복잡한 개발 작업을 자동화한다.

언급된 도구

Claude Code추천

AI 기반 코딩 도구 및 플러그인 실행 환경

MAGI추천

멀티 에이전트 기반 코드 및 디자인 리뷰 플러그인

pytest중립

파이썬 코드 테스트 및 검증

ruff중립

파이썬 코드 린팅 및 스타일 체크

언급된 리소스

GitHubMAGI GitHub Repository