navigator
무엇인가
Navigator는 Claude Code 세션에서 컨텍스트 윈도우를 관리하는 절차를 주입하는 플러그인이다. 프로젝트 문서 전체를 미리 적재하지 않고 필요한 시점에 필요한 만큼만 로드하도록 규율하며, 세션 시작·작업 루프·협업 진단·프로젝트 기억을 각각 독립된 스킬로 분리해 운용한다.
어떻게 동작하나
동작 방식은 자연어 의도 감지다. 설치하면 스킬 묶음이 등록되고, "Start my Navigator session"은 세션 시작 절차를, "Create context marker: checkpoint"는 컨텍스트 압축을, "Run until done: ..."은 진행 추적과 이중 조건 종료(휴리스틱 + 명시 신호)를 갖춘 루프 모드를 발동한다. nav-profile은 세션 간 사용자 선호를 저장하고 정정에서 자동 학습하며, nav-diagnose는 동일한 정정이 반복되면 품질 점검과 재정박 프롬프트를 트리거한다. 지식 그래프는 태스크·SOP·시스템 문서를 통합 검색하고 세션 시작 시 관련 컨텍스트를 자동 노출한다. 토큰 사용량과 효율 점수는 /nav:stats로 OpenTelemetry 기반 측정값을 확인한다.
무엇과 다른가
CLAUDE.md 한 파일에 규칙을 정적으로 적어 두는 방식과 달리, 문서 로딩 시점을 실행 중으로 미루고 절차를 스킬 단위로 쪼개 발동 조건을 붙인다. 슬래시 명령을 외워 호출하는 방식이 아니라 발화 의도로 스킬이 선택되며, 프롬프트를 매 세션 다시 주입해야 하는 방식과 달리 프로필과 지식 그래프는 세션 경계를 넘어 지속된다. 기존 워크플로를 대체하지 않고 그 위에 컨텍스트 관리 계층을 얹는 상위 집합 구조다.
어떻게 쓰나
설치는 플러그인 마켓플레이스 경로를 추가한 뒤 플러그인을 설치하고 Claude Code를 재시작한다. 이후 "Initialize Navigator in this project"로 프로젝트를 초기화하고, 매 세션 시작 시 "Start my Navigator session"을 호출한다. 코드 심볼 질의 정확도를 높이려면 스택에 맞는 언어 서버 플러그인(예: pyright-lsp, typescript-lsp, gopls-lsp)을 추가로 설치한다.
전제와 한계
지원 대상은 Claude Code이며 플러그인 마켓플레이스 등록이 선행되어야 한다. 언어 서버 플러그인은 선택 사항이고 서버 바이너리가 PATH에 있어야 하며, 없으면 기존과 동일하게 Grep 기반 텍스트 검색으로 폴백한다. README가 명시하는 범위는 여기까지이고, 다른 에이전트(Codex·Cursor 등)용 배포본은 안내되어 있지 않다. 라이선스는 MIT다.