書き込みパスと承認
書き込みフローは信頼の境界です。エージェントが提案し、人間が承認します。
書き込みフロー
- エージェントが 1 つ以上の候補を提案します。
save-session --query-level <n>を使うと、エージェントはアクセス可能な最近の人間とエージェントのチャットを最大 n 件まで検討できますが、それは提案のためのコンテキストとしてだけです。 自然な言い方の/engram ss -f last 50 sessionsは、同じ範囲に明示的な強制承認を加えたもので、engram save-session --query-level 50 --forceと同じです。 - Engram が候補のタイプと対象スコープを解析します。
- Engram がスキーマ、シークレット、プロンプトインジェクションのパターン、パスの安全性を確認します。
- 人間がプレビューを確認します。各候補には、決定的な
Verdict:の行が 1 行付きます。ADD、UPDATE <id>、SUPERSEDE <id>、NOOP duplicate of <id>のいずれかです(モデルは呼び出しません)。 - 直接の CLI では、
A、A 1,3、B <note>、Cで応答します。 - AI エージェントのチャットでは、表示された候補そのものに対して
yes、audit、cancelで応答します。 - 承認されたメモリだけが書き込まれます。
AとBはNOOPの候補をスキップし、SUPERSEDEを承認すると古いメモリは置き換え済みとしてマークされます。--forceと自動保存はSUPERSEDEを決して適用せず、レビューのために保留します。 - インデックス、グラフ、ハッシュ、変更履歴が更新されます。
承認の言葉
承認の言葉は yes、approve、confirm、save です。監査(audit)の言葉は audit、revise、correct、または編集した置き換えテキストです。キャンセルの言葉は cancel、stop、または拒否です。候補そのものが表示されたあとの承認だけが、それらの候補に対する engram save-session --force を許可します。
直接のターミナル CLI は引き続き A/B/C です。MCP の提案ツールは引き続き書き込みを行いません。
関連メモリのヒント
engram save が関連するアクティブなメモリを見つけた場合、承認プレビューでそれらを報告し、depends_on の提案か重複の可能性についての警告を添えます。承認するとプレビューのまま保存されます。保存の前に依存関係を再構成したり、重複をアーカイブしたりしたい場合は、先に拒否してください。
save-session --force では、これらの関連メモリのヒントが出ると、Engram は書き込む前に一時停止します。エージェントはその応答を使って、構造化した再実行を検討する必要があります。依存関係には DEPENDS_ON: memory-id を追加し、前提メモリより深いメモリには LEVEL: advanced を、重複の可能性があるものに候補を統合する場合は UPDATE: memory-id を使います。
証拠に基づくメモリ
アクティブなメモリになる前にレビューすべきソース素材については、次のようにします。
engram observe --file session.md
engram save-session --file .agents/.engram/inbox/<observation>.md
最初のコマンドはソースをサニタイズし、trace_id で識別される変更不可のトレースと、編集可能な inbox ラッパーを書き出します。2 番目のコマンドはラッパーをそのトレースに解決し、ハッシュとスコープを検証したうえで、人間が承認した schema v3 のメモリだけを evidence_refs 付きで書き込みます。## Raw Note を編集しても、トレースの証拠を置き換えることはできません。
保存時の安全性チェック
- スキーマの検証
- シークレットのスキャン
- プロンプトインジェクションのスキャン
- パスの安全性
- ハッシュの整合性
これが重要な理由
プロトコルがなければ、メモリは見えない状態になりえます。見えない状態はレビューしにくく、共有しにくく、エージェントが誤って汚染しやすいものです。
Engram は意図的にメモリを地味なものにしています。ファイル、差分、ハッシュ、レビューゲート、人間が再実行できるコマンドです。