Claude Code를 위한 로컬 메모리 레이어 'Cosmos' 구축 및 멀티 에이전트 워크플로 실험

실용적 조언

멀티 에이전트 환경에서는 에이전트 간 작업 충돌을 방지하기 위해 git worktree를 활용하여 작업 공간을 분리할 것.
에이전트에게 프로젝트 구조와 과거 수정 이력을 실시간으로 제공하는 로컬 인덱싱 레이어를 구축하여 컨텍스트 로딩 효율을 높일 것.
에이전트의 작업 성공률과 학습 데이터 호출 횟수를 추적하여 워크플로의 개선점을 파악할 것.

섹션별 상세

작성자는 Claude Code와 MCP를 기반으로 에이전트들이 프로젝트 구조, 심볼, 과거 버그 수정 이력을 공유하는 로컬 메모리 레이어 'Cosmos'를 구축했다. 이 시스템은 프로젝트 폴더를 실시간으로 인덱싱하여 에이전트가 매번 전체 트리를 읽지 않고도 필요한 컨텍스트를 즉시 조회할 수 있게 한다. 결과적으로 에이전트의 '콜드 스타트' 문제를 해결하고 작업 효율을 높이는 효과를 거두었다.

멀티 에이전트 오케스트레이션 과정에서 작업 충돌을 방지하기 위해 오케스트레이터가 서로 다른 파일을 수정하는 두 개의 작업을 선택하고, 각각 별도의 git worktree에서 에이전트를 실행하는 방식을 채택했다. 이를 통해 에이전트들이 병렬로 작업하면서도 커밋 충돌 없이 순차적으로 병합할 수 있는 환경을 구현했다. 이는 복잡한 프로젝트에서 에이전트 간의 간섭을 최소화하는 실무적인 해결책이다.

실제 프로젝트 적용 결과, 30일간 141회의 레슨 호출과 67%의 첫 시도 성공률을 기록하며 시스템의 유효성을 입증했다. 특히 과거 버그 수정 이력을 기억하여 동일한 실수를 반복하지 않도록 설계한 점이 주효했다. 12번의 클린 런(재시도 없는 성공)을 통해 에이전트의 작업 품질이 향상되었음을 확인했다.

용어 해설

Model Context Protocol(MCP): — AI 모델이 로컬 파일 시스템이나 데이터베이스 등 외부 도구와 안전하게 통신할 수 있도록 표준화된 인터페이스 프로토콜이다. 에이전트가 외부 환경과 상호작용하는 방식을 통일하여 개발 효율을 높인다.
Git 워크트리(Git Worktree): — 하나의 Git 저장소에서 여러 브랜치를 동시에 체크아웃하여 작업할 수 있게 해주는 기능이다. 에이전트 간 파일 충돌 없이 병렬 작업을 수행하는 환경을 구축하는 데 유용하다.
오케스트레이터(Orchestrator): — 멀티 에이전트 시스템에서 전체 작업을 관리하고, 하위 에이전트에게 작업을 할당하며 실행 순서를 조정하는 상위 제어 에이전트이다. 작업의 우선순위를 정하고 충돌을 방지하는 역할을 한다.

언급된 도구

Claude Code추천

코딩 에이전트

MCP추천

모델 컨텍스트 프로토콜