メモリ機構: ファイル形式 + Linter 土台

背景

docs/plan/memory.md で決めたメモリ機構の永続化レイヤの土台。memory/* と knowledge/* の record を保存・編集する際の静的スキーマと、汎用 CRUD への post-write Hook として挟む Linter を成立させる。Phase 1/2、検索ツール、常駐注入、GC はすべてこの層に乗る。

Workflow（docs/plan/workflow.md）も同じ frontmatter / Linter 経路で扱うため、memory/workflow/<slug>.md の frontmatter 検証と書き込み制限も本チケットに含める。実行経路（/<slug> dispatch）は別。

要件

ディレクトリと record 種別

memory/summary.md — Always-on サマリ（1 ファイル固定）
memory/decisions/<slug>.md — Decisions
memory/requests/<slug>.md — Requests
memory/workflow/<slug>.md — Workflow（frontmatter 検証のみ対象）
memory/_staging/<id>.json — Phase 1 中間（本チケットはパス予約と Linter 対象外化のみ）
knowledge/<slug>.md — Knowledge（memory/ の兄弟）

slug は kebab-case（小文字英数とハイフン）。ファイル名がそのまま識別子で、frontmatter に id / name は持たない。

frontmatter スキーマ

種別ごとの必須フィールドは docs/plan/memory.md §ファイル形式 / §書き込み経路と Linter の表に従う。具体的な必須項目：

共通: created_at, updated_at
Decisions: sources, status: open | resolved | replaced、置き換え時 replaced_by: <slug>
Requests: sources
Knowledge: kind, description, model_invokation, user_invocable, last_sources
Summary: updated_at（optional: last_rewritten_from_range）
Workflow: description, auto_invoke, user_invocable, requires

Linter ルール

静的 error（post-write Hook が turn を戻し、sub-Worker に自己修正させる。N 回失敗で abort）:

frontmatter 必須 field 欠落・型違反
memory/workflow/ への書き込み禁止（sub-Worker のみ。人間編集は対象外）
同 slug での新規作成禁止（既存があれば update に切り替えるサイン）
#<slug> / replaced_by: <slug> / requires: [..] が実在 record を指す
Decisions status の enum 違反
model_invokation: true な Knowledge の description 1024 chars 上限
種別ごとの char 硬上限（具体値は設定ファイルで tune）

膨張抑制 Warn（error ではなく改善ヒント）:

低重要度 × char の天秤
sources 配列長の累積
類似 slug 乱立

適用経路

sub-Worker の汎用 CRUD（read/write/edit）への post-write Hook として挟む
人間編集（エディタ / git commit）に対しても同一ルールで検証できる CLI または pre-commit hook 経路を用意（詳細は実装で判断、結果として同じルールが一箇所で定義されていること）

範囲外

検索ツール、常駐注入、Phase 1/2、GC の実装
意味破壊（rewrite で主張が落ちる等）の検出 — 監査 LLM 層は将来検討
staging JSON の schema — Phase 1 チケット
Workflow の /<slug> 実行経路

完了条件

上記パスに手で record を置いて Linter を走らせると、スキーマ違反 / 参照切れ / 同 slug 競合が error として返る
sub-Worker が CRUD で書き込んだ際、違反時は turn が戻り自己修正が走る
Warn は error を止めず、出力されることが確認できる
memory/workflow/ への sub-Worker からの書き込みは error で止まり、人間編集は通る
既存ビルド・テストを壊さない

参照

docs/plan/memory.md §ファイル形式 / §書き込み経路と Linter / §Knowledge の採択基準
docs/plan/workflow.md §格納先とファイル形式 / §生成・更新ポリシー

3.9 KiB Raw Blame History Unescape Escape