GMaN1911/claude-cognitive

解決する問題

Claude Code は強力ですがステートレスです。新しいインスタンスは毎回ゼロから始まり、変更されていないファイルを再読み込みし、トークンを浪費し、欠落した統合を幻覚することがあります。このプロジェクトは Claude Code に永続的な作業メモリを提供し、セッションが生産的に再開され、重複作業を回避し、長期実行や並列使用でも整合性を保ちます。

仕組み

2 つの補完的なシステム：

• コンテキストルーター — ドキュメントファイルを言及頻度でスコアリングします。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 ライセンス、本番準備完了とマーク。