aim-write

aim-write

永続的な Wiki ページを保存します。ユーザーが明示的に記憶するよう求めた確定的な知識にのみ使用してください。通常のセッションメモはフックによって自動的に記録されます。それらを手動で書かないでください。また、恒久的な注釈にハンドオフを使用しないでください。

手順

1. インスタンスを選びます。 リポジトリの MCP 設定から選びます。複数の ai-memory サーバーが設定されている場合は、書き込み先のエンドポイントを尋ねてください。

2. ワークスペース／プロジェクトを選びます。 リポジトリの .ai-memory.toml を既定とします。別の場所に書き込む場合は確認してください。

3. パスと種類を選びます。 kind が導出され、想起が整理されるよう、フォルダーの規則に従ってください。

   • decisions/ADR-NNNN-<slug>.md → decision
   • _rules/<slug>.md → rule
   • gotchas/<slug>.md → gotcha
   • それ以外はトピック別のパス（例：runbooks/<slug>.md、<area>/<slug>.md）。 frontmatter の node_type またはツール引数で、kind を明示的に設定することもできます。

   _rules/ のプレフィックスは重要です。アンダースコアを使ってください。 _rules/（およびピン留めされた _slots/）配下のページは、ai-memory の最もシグナルの高い階層です。memory_briefing／memory_explore／ダッシュボードにそのまま表示され、path GLOB '_rules/*' をキーにします。通常の rules/ フォルダー（アンダースコアなし）は通常のページにすぎず、これらの機能は一切適用されません。明示的なクエリ／読み取りでのみ見つかります。そのため、永続的なルールは必ず _rules/ に書き込み、rules/ には書き込まないでください。

   共有ルール／プロジェクト横断ルール（すべてのリポジトリで再利用されるグローバルなエージェント規約など）は、専用スコープ、つまり予約済みの default／_global スコープ内の _rules/ に置きます（scope: "global" を指定して書き込みます）。想起は（ワークスペース、プロジェクト）ごとに行われるため、他のプロジェクトからは memory_query scopes:[…]／memory_read_page を使ってスコープをまたいで参照します（aim-query を参照）。自動的には参照されません。

4. 本文を作成します。 frontmatter（title、node_type、tags、任意の source:）を含む Markdown で記述します。関連ページには [[path.md]] でリンクします（パスには .md を含め、リンク先は完全一致するパスで解決されます）。ページに有効なシークレット／認証情報を記載しないでください。伏せ字にしてください（<see secret manager>）。

5. memory_write_page（または同等の管理者向け書き込み機能）を呼び出し、ワークスペース／プロジェクト／パス／本文を指定します。

6. 確認します。 ページが想起可能であることを確認します（トピックを指定して aim-query を簡単に実行します）。

ページは簡潔にまとめ、焦点を絞ってください。事実／決定事項／注意点を1つずつ記載したページが、最も読みやすく想起されやすい形式です。