mnemonics

Mnemonics：Historian によるメモリ管理

重要：@historian を使用する必要があります

メモリツールは @historian サブエージェント経由でのみ利用できます。これらのツールを直接呼び出すことはできません。

• memory_remember - メモリを作成または更新します
• memory_recall - メモリを検索して取得します
• memory_forget - メモリを削除します
• memory_list_types - 利用可能なメモリタイプを一覧表示します
• memory_sync - 検索インデックスを再構築します

必ず historian に委任してください：

@historian remember that we decided on PostgreSQL for the database
@historian what did we decide about authentication?

メモリタイプ

タイプ	用途	例
architectural-decision	システムアーキテクチャの選択	"スケーリングのために PostgreSQL と読み取りレプリカを使用する"
design-decision	UI/UX の決定	"ダッシュボードにはカードレイアウトを採用し、デスクトップでは3列にする"
learning	教訓や発見	"Bun のネイティブ TS サポートにより、ビルド工程が不要になる"
user-preference	ユーザーの好み	"ユーザーはダークモードを好み、スペースではなくタブを使う"
project-preference	チームの規約	"Conventional Commits を使用し、PR レビューを必須とする"
issue	既知の問題	"レート制限はまだ実装されていないため、#42 で追跡中"
context	一般的なコンテキスト（デフォルト）	"プロジェクトは2026年2月に開始し、MVP の目標は第2四半期"
recurring-pattern	再利用可能なパターン	"エラー処理：try/catch で囲み、{error} を返す"
conventions-pattern	コーディング規約	"名前付きエクスポートを使用し、デフォルトエクスポートは避ける"

注： プロジェクトでは設定を通じてカスタムメモリタイプを定義できる場合があります。現在のプロジェクトで利用できるすべてのタイプを確認するには、必ず @historian list all memory types available を使用してください。

Historian に委任するタイミング

記録（作成／更新）：

• 重要なアーキテクチャまたはデザイン上の決定を行った後
• ユーザーが作業方法に関する好みを伝えたとき
• コードベースやツールについて重要なことを発見したとき
• セッションをまたいで保持すべき教訓を得たとき

想起（検索／取得）：

• 新しいセッションを開始するとき → 関連するコンテキストを想起します
• ユーザーが「X について何を決めましたか？」と尋ねたとき
• すでに決定済みかどうかを確認する必要があるとき
• 既知の問題やパターンを探すとき

忘却（削除）：

• ユーザーが古くなった、または誤ったメモリの削除を希望するとき
• 重複した項目や関連性のない項目を整理するとき

同期（再インデックス）：

• .mnemonics/ 内のメモリファイルを手動で編集した後
• 検索結果が古くなっているように見えるとき

プロンプトの例

記録

@historian remember that we decided on JWT auth with 15-min expiry
@historian save this learning: Bun handles TypeScript natively without compilation
@historian note that the user prefers minimal UI animations
@historian store this as an architectural-decision: we're using event sourcing for the audit log

想起

@historian what did we decide about authentication?
@historian recall any known issues with the API
@historian what are my preferences for this project?
@historian show all architectural decisions
@historian find memories about database choices

管理

@historian list all memory types available
@historian forget the memory about the old API design
@historian sync the index to include recent memory files

仕組み

1. メモリは保存されます。YAML frontmatter を含む Markdown ファイルとして .mnemonics/{type}/{title}.md に保存されます
2. インデックス作成は自動です。qmd によって実行されます（BM25 とベクトル検索のハイブリッド）
3. Historian が処理します。分類、重複排除、セマンティック検索を行います
4. ファイルは Git との親和性があります。チームで共有するためにコミットできます

ベストプラクティス

1. タイトルは具体的にします。「important decision」ではなく「qmd-cli-for-writes」を使用します
2. 分類は historian に任せます。重複を避けるため、まず検索を行います
3. 決定する前に想起します。すでに決定済みかどうかを確認します
4. メモリファイルをコミットします。これらはプロジェクトのナレッジの一部です