Nelson: 19세기 해군 함대 방식을 차용한 Claude Code 멀티 에이전트 조율 플러그인

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

핵심 요약

Claude Code를 위한 멀티 에이전트 조율 레이어로, 19세기 해군 지휘 체계를 모방한 위험 제어 및 컨텍스트 모니터링 시스템을 통해 복잡한 코딩 작업을 자동화한다.

배경

작성자가 조직 이론과 19세기 영국 해군의 지휘 체계에서 영감을 얻어, Claude Code 환경에서 여러 에이전트를 효율적으로 관리하고 충돌을 방지하기 위한 플러그인 'Nelson'을 개발하여 공유했다.

의미 / 영향

멀티 에이전트 오케스트레이션에서 기술적 제어만큼이나 조직 이론에 기반한 명확한 역할 분담과 위험 관리가 중요함을 시사한다. 특히 컨텍스트 모니터링을 통한 에이전트 교체 전략과 위험 기반 승인 절차는 프로덕션 환경의 AI 에이전트 설계에 즉시 적용 가능한 실무적 통찰을 제공한다.

커뮤니티 반응

작성자가 직접 개발한 도구에 대해 커뮤니티 기여가 이루어지는 등 긍정적인 반응을 얻고 있으며, 해군 용어를 활용한 독특한 접근 방식이 흥미롭다는 평가를 받고 있다.

주요 논점

01찬성다수

19세기 해군 지휘 체계와 같은 검증된 조직 이론을 AI 에이전트 조율에 적용하는 것이 실무적으로 효과적이다.

합의점 vs 논쟁점

합의점

LLM 에이전트가 장시간 작동할 때 컨텍스트 윈도우 관리가 성능 유지의 핵심이다.
에이전트 간의 파일 수정 충돌을 방지하기 위한 명확한 소유권 설정이 필요하다.

실용적 조언

에이전트 교체 시 인계 사항을 대화 메시지가 아닌 별도 파일로 전달하여 새 에이전트의 컨텍스트 윈도우 낭비를 방지하라.
복잡한 멀티 에이전트 워크플로에서 에이전트에게 구체적인 페르소나를 부여하여 행동 일관성을 높여라.

섹션별 상세

작업의 위험도에 따라 0(순찰)부터 3(트라팔가)까지 등급을 매겨 관리한다. 고위험 작업(Station 3)의 경우 체크리스트와 롤백 계획, 인간의 최종 승인이 있어야만 실행되도록 설계되어 파괴적인 실수를 방지한다. 저위험 작업은 빠르게 흐르도록 두되, 파괴적인 작업 직전에 '서킷 브레이커'가 작동하도록 하여 안전성을 확보했다. 이는 무분별한 코드 수정을 막고 안전한 자동화를 가능케 하는 핵심 메커니즘이다.

Nelson 플러그인이 실행 중인 터미널 화면 스크린샷 — ScreenshotClaude Code 환경에서 Nelson이 활성화된 모습을 보여준다. 위험 등급 설정 및 작업 상태를 터미널 UI로 확인할 수 있으며, 에이전트 팀 구성 및 미션 수행 과정을 시각적으로 나타낸다.

에이전트의 컨텍스트 윈도우 사용량을 실시간으로 추적하여 성능 저하를 방지한다. Claude Code의 JSONL 로그에서 토큰 수를 읽어 임계치를 넘으면 '교대(Relief on station)'를 수행하며, 기존 에이전트가 작성한 인계 문서를 새 에이전트가 읽고 작업을 이어받는다. 인계 사항을 메시지가 아닌 파일로 전달하여 새 에이전트의 초기 컨텍스트 소모를 최소화하는 전략을 사용했다. 이를 통해 장시간 실행 시 발생하는 지능 저하와 반복 문제를 해결했다.

에이전트에게 단순한 번호 대신 '항해사(Navigating Officer)', '포술장(Principal Warfare Officer)' 등의 구체적인 해군 역할을 부여한다. 연구 전용, 구현 전용, 테스트 전용 등 명확한 페르소나를 주었을 때 LLM의 행동 일관성이 크게 향상됨을 확인했다. 이는 단순한 장식이 아니라 LLM의 성능을 끌어올리는 '정체성 부하(Identity is load-bearing)' 효과를 활용한 것이다. 에이전트의 정체성이 명확할수록 지시 사항 준수율이 높아진다는 실무적 발견을 시스템에 녹여냈다.

커뮤니티 기여를 통해 16가지의 작업 안티패턴을 감지하는 게이트를 구축했다. 예를 들어 코디네이터가 직접 구현을 시도하는 '함교의 제독(Admiral at the helm)'이나 두 에이전트가 같은 파일을 수정하는 '갈라진 용골(Split keel)' 등을 사전에 차단한다. 이러한 게이트는 작업 계획 단계에서 작동하여 에이전트 간의 간섭과 비효율적인 자원 낭비를 방지한다. 사후 수습이 아닌 사전 예방을 통해 멀티 에이전트 환경의 혼란을 최소화한다.

코드 예제

bash

/plugin install harrymunro/nelson

Claude Code 환경에서 Nelson 플러그인을 설치하는 명령어

실무 Takeaway

멀티 에이전트 시스템에서 에이전트에게 구체적인 역할(Role)과 정체성을 부여하면 작업 수행의 일관성과 지시 준수율이 향상된다.
LLM의 컨텍스트 윈도우가 가득 차기 전에 토큰 사용량을 모니터링하고, 인계 사항을 파일로 전달하며 에이전트를 교체하는 전략이 장기 작업의 품질 유지에 필수적이다.
작업 위험도에 따른 차등적 승인 절차(Station Levels)를 도입하여 자동화의 속도와 시스템 안전성 사이의 균형을 잡을 수 있다.

언급된 도구

Nelson추천

Claude Code용 멀티 에이전트 조율 및 컨텍스트 모니터링 플러그인

Claude Code중립

Anthropic의 CLI 기반 AI 코딩 도구

언급된 리소스

GitHubNelson GitHub Repository