GMaN1911/claude-cognitive

해결하는 문제

Claude Code는 강력하지만 상태가 없습니다. 모든 새 인스턴스는 처음부터 시작하고, 변경되지 않은 파일을 다시 읽고, 토큰을 낭비하며, 누락된 통합을 환각할 수 있습니다. 이 프로젝트는 Claude Code에 영구 작업 메모리를 제공하여 세션이 생산적으로 재개되고, 중복 작업을 피하며, 장기 실행 또는 병렬 사용에서 일관성을 유지합니다.

작동 방식

두 가지 보완 시스템:

• 컨텍스트 라우터 — 문서 파일을 언급 빈도에 따라 점수화합니다. HOT 파일(점수 > 0.8)은 전체 내용이 주입되고, WARM 파일(0.25–0.8)은 처음 25줄만, COLD 파일(< 0.25)은 제거됩니다. 점수는 턴마다 감소하고, 키워드 일치 시 상승하며, 공동 활성화를 통해 관련 파일을 부스트합니다.
• 풀 코디네이터 — 여러 Claude 인스턴스 간에 상태를 공유합니다. 자동 모드에서는 대화에서 작업 완료 또는 차단을 5분마다 감지합니다. 수동 모드에서는 명시적인 pool 블록을 작성합니다. 이는 병렬 또는 장기 세션을 동기화합니다.

히스토리 추적(v1.1+)은 각 턴의 주의 상태(HOT/WARM/COLD 전환)를 JSONL 파일에 기록하고, 쿼리, 필터링, 통계를 위한 CLI를 제공합니다. 설정에는 스크립트 복사, 인스턴스 ID 설정, 프로젝트별 keywords.json 구성이 포함됩니다.

대상 사용자

대규모 코드베이스(5만 줄 이상)에서 Claude Code를 사용하는 개발자, 여러 Claude 인스턴스를 동시에 실행하는 팀, 그리고 며칠 또는 장기 코딩 워크플로를 관리하는 모든 사람.

하이라이트

• 토큰 절약: 콜드 스타트 79% 감소(120K → 25K 문자), 웜 컨텍스트 70%, 집중 작업 75%.
• 새 인스턴스는 첫 메시지에서 생산적입니다. 환각된 가져오기나 통합이 없습니다.
• 8개 이상의 동시 Claude 인스턴스 및 며칠간의 세션에서 작동.
• 100만 줄 이상의 프로덕션 코드베이스(3,200개 이상의 Python 모듈)에서 검증됨.
• 자동 및 수동 풀 조정 모드.
• 필터링 및 통계를 갖춘 주의 히스토리 뷰어.
• MIT 라이선스, 프로덕션 준비 완료로 표시.