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

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

에반게리온의 마기 시스템을 모방하여 세 가지 서로 다른 관점의 AI 에이전트가 코드와 설계를 검토하고 합의하는 Claude Code 플러그인이다.

배경

Claude Code를 위한 멀티 에이전트 플러그인인 MAGI를 개발하여 공유했다. 애니메이션 에반게리온의 마기 시스템에서 영감을 받아 세 가지 서로 다른 관점의 에이전트가 코드와 설계를 검토하도록 설계했다.

의미 / 영향

멀티 에이전트 시스템이 단일 LLM의 환각이나 편향을 줄이는 실질적인 도구로 활용될 수 있음을 보여준다. 특히 비판적 관점의 에이전트를 포함하는 것이 보안 및 안정성 검토에 효과적이라는 커뮤니티의 긍정적인 반응이 확인됐다.

커뮤니티 반응

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

주요 논점

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

실무 Takeaway

Claude Code에 멀티 에이전트 아키텍처를 도입하여 단일 모델의 한계를 극복하고 다각적인 코드 및 설계 검토가 가능하다.
서로 다른 페르소나(과학자, 실용주의자, 비판가)를 가진 에이전트들이 독립적으로 분석하고 가중 투표를 통해 최종 의사결정을 지원한다.
비동기 병렬 처리를 통해 실행 효율성을 높였으며, 에이전트 간의 의견 불일치를 통해 잠재적인 기술적 부채나 보안 위험을 효과적으로 식별한다.

언급된 도구

Claude Code추천

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

MAGI추천

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

pytest중립

파이썬 코드 테스트 및 검증

ruff중립

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

언급된 리소스

GitHubMAGI GitHub Repository