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

실용적 조언

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

섹션별 상세

작업의 위험도에 따라 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)' 등을 사전에 차단한다. 이러한 게이트는 작업 계획 단계에서 작동하여 에이전트 간의 간섭과 비효율적인 자원 낭비를 방지한다. 사후 수습이 아닌 사전 예방을 통해 멀티 에이전트 환경의 혼란을 최소화한다.

용어 해설

컨텍스트 윈도우(Context Window): — LLM이 한 번의 추론 과정에서 기억하고 처리할 수 있는 최대 토큰의 범위를 의미한다. Nelson은 이 윈도우가 가득 차서 발생하는 지능 저하를 막기 위해 토큰 사용량을 실시간으로 모니터링하고 에이전트를 교체하는 기능을 제공한다.
멀티 에이전트 오케스트레이션(Multi-agent Orchestration): — 여러 개의 독립적인 AI 에이전트가 협력하여 복잡한 목표를 달성할 수 있도록 작업을 분배하고 조율하는 기술이다. Nelson은 19세기 해군 함대의 지휘 체계를 모방하여 에이전트 간의 역할 분담과 충돌 방지를 관리한다.
안티패턴(Anti-pattern): — 실제 문제 해결에는 도움이 되지 않으면서 부작용을 일으키는 반복적인 설계나 코딩 습관을 의미한다. Nelson은 '함교의 제독'과 같은 16가지 해군 비유 기반 안티패턴을 정의하여 에이전트 간의 충돌이나 비효율적인 작업을 사전에 방지한다.
토큰 수(Token Count): — LLM이 텍스트를 처리하는 최소 단위인 토큰의 총량을 의미한다. Nelson은 Claude Code의 세션 로그 파일을 분석하여 현재 에이전트가 소비한 토큰 수를 추적하고, 이를 기반으로 에이전트의 교체 시점을 결정한다.
서킷 브레이커(Circuit Breaker): — 시스템의 오류나 위험이 감지되었을 때 추가적인 피해를 막기 위해 작업을 즉시 중단시키는 안전 장치이다. 이 아티클에서는 고위험 작업 실행 전 인간의 승인을 강제하거나 파괴적인 동작을 차단하는 메커니즘으로 사용된다.

코드 예제

bash

/plugin install harrymunro/nelson

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

언급된 도구

Nelson추천

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

Claude Code중립

Anthropic의 CLI 기반 AI 코딩 도구

언급된 리소스

GitHubNelson GitHub Repository