memory-write

gate-memory-write.sh が ~/memory/ への書き込みを ask で止めた。ここに来た時点で、私は 「書く」と決めてドラフトを持っている。その判断を一度ほどく。

順に通す。1つでも落ちたら、書かずに済ませるか、別の場所へ持っていく。

1. 書き場は本当にここか

既にある置き場のほうが、ほぼ常に正しい。メモリは最後の置き場である。

判定は「この知識を必要とする人は、どのファイルを開いているか」で行う。そのファイルに書く。

実例（過去に memory から追い出したもの）:

• 「worktree 中の main 直接編集は正当」→ その前提で動く関数の直上（zsh/functions/aiagent.sh）
• 「特定バージョンのツールが録画環境で起動しない」→ そのツールを使う skill
• 「ある端末で作業ツリーが dirty に見えるのは正常」→ そのリポの CLAUDE.md
• 「記事サイトの内部リンク形式」→ その記事を書く skill

既存の置き場に一言足せば済むなら、それが答え。二重に持つと必ず片方が腐る。

2. 二つの試験

上のどれでもなかった。次を両方満たすときだけ、メモリが正しい。

(a) そこにしか無い — コード・git 履歴・docs・skill のどれからも導けない。 なぜそう決めたか / 何を試して却下したか / 実測してどうだったか、が該当する。

(b) 次に行動を変える — 知っていると私の判断・提案が変わる。

判別法: 「これを読まずに作業したら、私は具体的に何を間違えるか」を1文で言う。言えないなら書かない。

• ○ 「age 鍵を restic リポの中に入れて、循環に気づかないまま復元不能にする」
• ○ 「HTTPS の clone URL を貼って、仕事用リポを私用アカウントで push する」
• ✗ 「バッテリーが76%だと知らずに……」→ 何も起きない。書かない

落ちる典型:

3. user に提案する

ここまで通ったものだけを出す。黙って書かない。 提案には次を含める。

memory に残すことを提案します。

宛先: ~/memory/<slug>.md（新規 / 既存の <name> を更新）
理由: <(b) の1文 — これを読まずに作業すると何を間違えるか>
他の置き場を採らなかった理由: <1 の表のどれに近く、なぜ違うか>

<本文のドラフト全文>

user が「覚えておいて」と明示的に頼んだ場合も、宛先とドラフトは見せる。承認されるまで書かない。

4. 書式

~/memory/<slug>.md の1ファイル1事実。サブディレクトリも索引ファイルも作らない（ls ~/memory/ が索引）。

---
name: <kebab-case。ファイル名と一致させる>
description: <1行。何が書いてあるかではなく、何が言えるかを書く>
---

<結論から書く。相対日付（「先週」）は絶対日付に直す>

**Why:** <そう判断した理由。ここが本体>

**How to apply:** <次に私が何を変えるか>

• 関連するメモリは [[name]] で結ぶ。存在しない名前へは張らない（索引が無いので切れたリンクは誰も直さない）
• 経緯を時系列で並べない。今そうである理由だけを書く
• 進捗・バージョン・完了報告を本文に混ぜない（1件が腐ると全体の信用が落ちる）
• 日本語の書きぶりは jp-writing に従う

5. 更新・削除・圧縮

• 書く前に ls ~/memory/ を見る。同じ主題があれば新規作成せずそちらを書き換える
• 前提が変わったメモリは追記せず書き換える。「以前はこうだった」を残さない
• 正本が他所（skill / docs / コード）にできたら、内容をそこへ移して削除する
• 削除も gate に止まる。user の承認を得てから消す

ls が索引として機能するのは十数件まで。それを超えたら分類を足すのではなく、2 の二つの試験を全件に掛け直して減らすことを提案する。