tudoumashu/ai-memory-skillpack

解決する課題

無制限で追記のみ可能なハンドオフノートや変更ログを、永続的かつサイズ制限のあるメモリシステムに置き換えることで、AIエージェントにおける「コンテキスト汚染」を防ぎます。これにより、エージェントがセッション間で古い情報に数千トークンを浪費することを防ぎ、プロジェクトメモリへの機密情報の誤った漏洩を防止します。

仕組み

このシステムは、リポジトリに対して階層型メモリ構造（HOT、WARM、COLD）を実装しています。必須のスナップショット（HOT）のみが毎セッション読み込まれ、詳細なアーキテクチャやランブック（WARM）は検索を通じてアクセスされ、履歴（COLD）は明示的な要求があった場合にのみ読み込まれます。「憲法」(SYSTEM.md) を使用してバイト予算と帰属を強制し、CodexやClaude CodeのようなAIエージェントが自律的にシステムをセットアップできるエージェントネイティブなインストーラーを備えています。信頼性を確保するため、実行可能なアサーションとSHA256チェックサムを備えた検証ツールが含まれており、パッケージの整合性を保証します。

対象ユーザー

AIエージェント（特にCodex CLIおよびClaude Code）を使用しており、コンテキストウィンドウを肥大化させることなく、異なるセッション間でプロジェクトのコンテキストを構造化かつ保守可能な方法で記憶させたい開発者。

ハイライト

• 階層型メモリ: 情報をHOT、WARM、COLDの階層に分類し、トークン使用量を最適化します。
• エージェントネイティブなインストール: 実行可能な INSTALL.md を通じて、AIエージェント自身がインストールできるように設計されています。
• フェイルクローズなセキュリティ: 機密情報の保存を禁止する憲法と、終了コードを使用してインストール成功を証明する検証ツールが含まれています。
• 整合性保護: レシートベースのハッシュ比較を使用して、アップグレードがユーザーの編集を黙って上書きしないようにします。