Remember

メモリエントリを保存して、後で思い出せるようにします。この機能を使って、作業中に発見した重要なコンテキスト、決定事項、アーキテクチャの知見、またはパターンを永続化します。

パラメータ

フラグ	JSONフィールド	必須	説明
--agent / -a	agentId	はい	エージェントID / セッション名
--content / -c	content	はい	保存するコンテンツ（または標準入力から入力）
--content-file	—	いいえ	ファイルパスからコンテンツを読み込む
--category / -C	category	はい	下記のカテゴリ × スコープマトリクスを参照
--scope / -s	scope	はい	スコープ: agent または project
--project / -p	projectPath	いいえ	プロジェクトパス（project スコープの場合は必須）

有効な category × scope マトリクス

カテゴリ	scope=agent	scope=project	説明
fact	✅	—	個人的なベストプラクティス / 「常に X を実施する」。
pattern	✅	✅	再利用可能なワークフローまたはコードパターン。
gotcha	✅ (F4 修正)	✅	避けるべき事項。エージェントスコープ = 個人用、プロジェクトスコープ = チーム全体。
preference	✅	—	AgentPreferences を更新（詳細度、分割サイズなど）。
decision	—	✅	アーキテクチャ / デザイン決定（プロジェクトのみ）。
relationship	—	✅	コードベース内のコンポーネント間のエッジ（プロジェクトのみ）。
user_preference	—	✅	プロジェクトスコープのユーザー設定（プロジェクトのみ）。

エイリアス / よくある間違い:

• workflow はパブリックカテゴリではありません — pattern を使用してください（内部的に workflow に自動マップされます）。
• 「この方法は前回失敗した」という場合 → category=gotcha scope=agent を使用（プロジェクトメモリを汚さないため）。

例 — CLIフラグ（推奨）

# プロジェクト全体のパターンを保存
bash execute.sh --agent dev-1 --content "User prefers PDF delivery in Slack thread" --category user_preference --scope project --project /projects/app

# 標準入力からコンテンツを入力（特殊文字を含むテキスト用）
echo "Jest mock resets are required between tests — don't forget" | bash execute.sh --agent dev-1 --category gotcha --scope project --project /projects/app

# ファイルからコンテンツを読み込む
bash execute.sh --agent dev-1 --content-file /tmp/finding.txt --category decision --scope project --project /projects/app

例 — レガシーJSON（後方互換性あり）

bash execute.sh '{"agentId":"dev-1","content":"User prefers PDF delivery","category":"user_preference","scope":"project","projectPath":"/projects/app"}'

出力

メモリエントリが保存されたことを確認するJSON形式の出力。