メモリシステム
このスキルの永続化レイヤーは、プロジェクトローカルのメモリを <project_root>/memories/ に保存し、scripts/memory <cmd> 経由で操作します(references/memory_tool をバックエンドとして使用。これはこのレイヤーの決定論的な真実の源であり、その出力を変更したり再実装したりしないでください)。ホストに他のメモリ機構が存在しないことを前提とせず、もし存在する場合は、このシステムはそれに加えてファイルベースの追加レイヤーとして扱います。標準出力はJSON形式です。ディスク上の状態を確認するには read を再実行してください。
バージョン1.1.0以降では、init により隠しファイル <project_root>/.memsys-db(SQLite + FTS5、journal_mode=DELETE、単一ファイル、-wal/-shm なし)も作成されます。これは再生成可能なインデックス兼検索プレーンです。Markdownが真実の源であり続けます。
以下の順序で開始してください:
- references/protocol.md — 取り込み→検索→推論→反映→実行→パッケージ化の完全なワークフローと、コマンドおよびクイックスタートの起動方法。
- references/layout.md — ストアのレイアウトと、特定のクエリに対して何を読み込むべきか。
- references/when-to-save.md — 分類: スキル vs. インデックス vs. トピック vs. 拒否、およびスキルとメモリのルーティング。
- references/constitution.md — 厳格なルール(シークレットスキャンを決してスキップしない、200行を超えない、
memories/以外に書き込まない、bashで列挙しない、台帳にWALを使用しない)。 - references/memsys-db.md —
.memsys-db台帳の契約: スキーマ、search/reindex/forget、およびDBがMarkdownより上位にならない理由。 - references/examples.md — 動作例: 正常パス、シークレット拒否、上書きからの復旧。
初回使用前に scripts/memory selftest でインストールを確認してください。