Claude Code를 위한 해군 작전 절차 기반 다중 에이전트 협업 도구 'Nelson' 공개

실용적 조언

Claude Code 사용자라면 'npm install -g @harrymunro/nelson'을 통해 에이전트 협업 기능을 강화할 수 있다.
에이전트가 긴 작업을 수행할 때는 수동으로 맥락을 정리하기보다 Nelson의 자동 핸드오버 기능을 활용하는 것이 효율적이다.

섹션별 상세

다중 에이전트 환경에서 발생하는 코드 호환성 결여와 파일 수정 충돌 문제를 해결하기 위해 해군 지휘 체계를 도입했다. 제독(Admiral)이 함대를 구성하고 각 역할을 맡은 함장(Captain) 에이전트들에게 임무를 할당하며, 레드셀 네비게이터가 계획의 허점을 찾는 방식으로 운영된다. 이를 통해 개별 에이전트가 독립적으로 작업하면서 발생하는 인터페이스 불일치 문제를 구조적으로 방지했다.

컨텍스트 윈도우 고갈 문제를 해결하기 위해 실제 토큰 사용량을 모니터링하고 자동 교대 시스템을 구현했다. Claude Code의 세션 파일을 직접 읽어 토큰 수가 임계치에 도달하면 기존 에이전트가 인수인계 문서를 작성하고 새로운 에이전트가 즉시 투입되는 'Relief on station' 메커니즘이 작동한다. 추측이나 휴리스틱이 아닌 실제 데이터 기반의 핸드오버를 통해 긴 작업 과정에서도 맥락 유지가 가능하다.

에이전트의 오작동을 방지하기 위해 15가지 'Standing Orders'와 10가지 'Damage Control' 절차를 적용했다. 코디네이터가 직접 코딩을 시작하거나 팀 규모가 부적절할 때 경고를 보내는 가드레일을 설정했으며, 에이전트가 루프에 빠지거나 예산을 초과하는 경우에 대비한 복구 경로를 문서화했다. v1.9.0에서는 동일 파일에 대한 동시 수정을 감지하는 충돌 레이더 기능을 추가하여 실패 사례를 대폭 줄였다.

향후 로드맵에는 과거 임무를 체크포인트에서 재실행하는 미션 리플레이와 데이터 기반의 자동 가드레일 생성 기능이 포함되어 있다. 특히 에이전트의 과거 성과에 따라 자율 실행과 인간 승인 사이를 동적으로 전환하는 신뢰도 가중치 기반 보정 시스템을 개발 중이다. 현재 v1.9.1 버전으로 공개되었으며 MIT 라이선스 하에 Claude Code 스킬로 설치하여 즉시 사용 가능하다.

용어 해설

컨텍스트 윈도우 고갈(Context Window Exhaustion): — LLM이 한 번에 처리할 수 있는 토큰 한도를 초과하여 이전 대화나 코드 맥락을 잊어버리는 현상이다. 에이전트가 긴 작업을 수행할 때 발생하며, 이를 해결하기 위해 새로운 에이전트로 교체하거나 요약된 정보를 전달하는 핸드오버 전략이 필요하다.
다중 에이전트 협업(Multi-Agent Coordination): — 여러 개의 AI 에이전트가 각자 역할을 분담하여 복잡한 문제를 해결하는 방식이다. 각 에이전트가 작성한 코드 간의 호환성을 유지하고 작업 충돌을 방지하기 위한 지휘 체계와 통신 규약이 핵심적인 기술 요소이다.
결정론적 단계 엔진(Deterministic Phase Engine): — 에이전트의 작업 흐름을 상태 머신으로 정의하여 정해진 단계를 강제로 준수하게 만드는 메커니즘이다. 계획 승인 전에는 코드를 구현하지 못하도록 물리적으로 제어함으로써 에이전트가 임의로 절차를 건너뛰는 것을 방지한다.

언급된 도구

Nelson추천링크

Claude Code를 위한 다중 에이전트 협업 및 지휘 프레임워크

Claude Code중립

Anthropic의 CLI 기반 코딩 에이전트 도구

언급된 리소스

GitHubNelson GitHub Repository