Cowork Context Management Kit, Claude의 파일 과부하 문제 해결

문제: Claude가 모든 파일을 읽는 현상

Claude AI와 함께 Cowork을 사용하는 컨설팅 회사 개발자는 462개 파일이 포함된 프로젝트 폴더 작업 중 성능 문제를 겪었습니다. Claude는 멈추거나, 이전 작업과 모순되거나, 오래된 문서를 참조하거나, 대체된 내용을 인용했습니다. 근본 원인: Claude는 각 세션 시작 시 폴더 내 모든 파일을 읽어 실제 질문을 처리하기 전에 컨텍스트 창의 절반을 관련 없는 정보로 채웠습니다.

솔루션: 3단계 컨텍스트 관리 키트

개발자는 엔터프라이즈 저장소 개념(근선형 계층화)을 차용하여 다음을 만들었습니다:

• 글로벌 지침을 Cowork 설정에 붙여넣습니다. 이는 Claude에게 먼저 매니페스트 파일을 찾고, 표준 문서를 읽고, 작업에 특별히 필요할 때만 다른 파일을 로드하도록 지시합니다.
• 매니페스트 템플릿 (_MANIFEST.md)을 폴더에 추가합니다. 이 간단한 마크다운 파일은 파일을 다음과 같이 태그합니다:
  • 계층 1: 진실의 원천 문서
  • 계층 2: 요청 시 로드
  • 계층 3: 특별히 요청하지 않는 한 무시
• 세션 간 일관성을 유지하는 Cowork 스킬

구현 및 결과

설정은 약 10분이 소요됩니다. 개발자는 구현 후 즉각적인 성능 향상을 보고했습니다. 이 키트는 MIT 라이선스로 https://github.com/hughtopian-gif/cowork-context-kit에서 GitHub에서 이용 가능합니다.

이 접근 방식은 특히 시간이 지남에 따라 누적된 문서가 있는 대규모 프로젝트에서 AI 코딩 어시스턴트가 관련 없는 파일에 컨텍스트 창 공간을 낭비하는 일반적인 문제를 해결합니다.