AI Long-Term Memory (ai-ltm)

~/ai-ltm-data/memory.db (SQLite) に、プロジェクト横断で再利用する学び・失敗・意思決定・中断点を蓄積する。

責任と読者

親が発動判断、query/summary、作業への反映、記録・同期の最終判断を持つ。直接実行する場合は、必要な script と reference だけをこの Skill の実体から読む。委任する場合は、親が実在確認した物理 path、対象範囲、起動権限、返却形式を worker に渡し、worker 自身に必要な資料を読ませる。

起動時の recall worker は bounded な recall だけを担当し、親の工程を再委任・再起動しない。worker は stage event と terminal record だけを返し、記録・embed・mark-used・同期を代行しない。利用できない非同期 API や未確認の path は本命を止める根拠にせず、未実行として返す。

自動発動とモード routing

自動発動は最上位のセッションで行い、委譲された担当では recall や record を起動しない。承認済みの自動モードは毎回確認せず、条件に該当したモードだけを実行する。単なる進捗や毎回のツール成功では発動しない。

条件	モード	参照
DB または repository の初回セットアップ、setup-needed の解消	setup	references/setup.md
最上位のセッションで過去の経緯や判断が今回の方針に関わる長い作業の開始・中断後の再開	bounded な非同期 recall	references/session-recall.md
前回の続き、過去の失敗、類似問題の参照	必要な範囲の search	references/search.md
学び・失敗・意思決定・中断点の確定	episode の record と embed	references/recording.md
最上位のセッションの終了・自然な会話終了・おやすみ・長く離れる旨	summary、embed、同期	references/session-close.md
記憶の削除・修正・一覧・archive	明示された management	references/maintenance.md
cleanup の明示依頼	対話的な cleanup	references/cleanup.md

短期の判断差分は /field-notes、感想・日記は /ai-diary に分け、同じ内容を二重に記録しない。cleanup は自動発動しない。

共通の前提

親はロードした SKILL.md の実体パスの親を SKILL_DIR とし、そこから script と reference の絶対 path を確定する。検索は既存 DB を read-only で開き、init.sql をスキーマの SSOT として不足や不正を自動補完しない。書き込みは親が明示した範囲で行い、recall の terminal record を観測する前の insert、embed、mark-used、archive、同期は defer または skip する。

注意事項

• 記録は簡潔に。1つのepisodeのsummaryは1-2文に収める
• contextには再現に必要な情報を入れるが、コード全体のコピーは避ける
• 機密情報（パスワード、トークン、秘密鍵）は記録しない
• 検索は控えめに。毎回全検索するのではなく、関連しそうなときだけ引く
• SQLにユーザー入力を埋め込む際は、シングルクォートを '' にエスケープする