memory-management

memory-management スキルの概要

memory-management スキルで実際にできること

memory-management スキルは、毎回同じ事実を探し直さなくても済むように、Claude がセッションをまたいでプロジェクト文脈を再利用可能な形で保持するための仕組みです。このリポジトリでは主に SEO / GEO ワークフロー向けに設計されており、CLAUDE.md のホットキャッシュ、memory/ 配下の構造化されたプロジェクトメモリ、古い詳細を退避するアーカイブ、という 3 層のメモリモデルを採用しています。

memory-management を導入すべき人

この memory-management skill は、文脈がすぐ流れやすい継続案件・複数セッション前提の作業に向いています。たとえば、キーワード追跡、競合監視、監査、キャンペーン進行管理、用語集の維持、定期レポートなどです。特に memory-management for Context Engineering を実践したいチームには有効で、単発の回答生成よりも「必要な事実を時間をまたいで正しく取り出せる状態を保つ」ことが主課題になっているケースに合います。

このスキルの本当の役割

多くのユーザーが求めているのは、だいたい次の 4 つです。

• 重要なプロジェクト判断を後で参照できるよう残す
• すべてを再アップロードせずに「ここまでで何が分かっている？」と聞けるようにする
• いま重要な優先事項は見える位置に残しつつ、重い詳細は退避する
• 順位チェックや監査のような定期イベント後に、一貫したルールでメモリを更新する

このスキルの価値は、「これ覚えておいて」という曖昧な依頼を、実際に運用できるファイル構造と更新ルーチンに落とし込める点にあります。

普通のプロンプトと何が違うのか

汎用プロンプトでも Claude に記憶を促すことはできますが、このスキルには運用ルールが含まれています。

• 明確な HOT / WARM / COLD 構造
• CLAUDE.md と memory/glossary.md のテンプレート
• 何を前面に残し、何を下げるかの promotion / demotion ルール
• 監査、レポート、順位確認の後に走らせるイベントベースの更新トリガー

そのため、1 ファイルにメモを雑多に積み上げるより、ずっと保守しやすい出力になります。

向いているケース / 向いていないケース

向いているケース:

• 定期更新が発生するアクティブな SEO プロジェクト
• 長期運用のキャンペーン業務
• すでに CLAUDE.md がワークフローに入っているリポジトリ
• チャット履歴ではなく、文書化されたメモリ運用を持ちたい人

向いていないケース:

• 単発タスク
• 繰り返し参照する文脈がほとんどない小規模案件
• ファイルを保守しなくてもデータベースのように自動永続化されると期待している人
• そもそも誰もメモリ用ファイルを確認・更新しない、ファイル非依存の運用

memory-management スキルの使い方

導入前提と互換性

このリポジトリでは、Claude Code ≥1.0、skills.sh marketplace、ClawHub marketplace、Vercel Labs skills ecosystem との互換性が示されています。システムパッケージは不要です。MCP のネットワークアクセスは、外部 SEO ツールと連携したい場合のみ任意で必要になります。コアとなる memory-management install と基本ワークフロー自体はファイルベースです。

環境が marketplace 型のスキル導入に対応している場合、よくある導入パターンは次のとおりです。

npx skills add aaron-he-zhu/seo-geo-claude-skills --skill memory-management

別のスキルローダーを使っている場合は、リポジトリ内の cross-cutting/memory-management を指定してください。

memory-management を使う前に最初に読むべきファイル

素早く導入したいなら、リポジトリ全体を順番に読む必要はありません。まずは以下から確認するのが近道です。

1. cross-cutting/memory-management/SKILL.md
2. cross-cutting/memory-management/references/hot-cache-template.md
3. cross-cutting/memory-management/references/update-triggers-integration.md
4. cross-cutting/memory-management/references/promotion-demotion-rules.md
5. cross-cutting/memory-management/references/examples.md
6. cross-cutting/memory-management/references/glossary-template.md

この順番なら、運用モデル、ファイル構造、更新トリガー、具体例までを、余計な手探りなしで把握できます。

このスキルに渡すべき入力

memory-management usage の質は、最初に渡す文脈情報にかなり左右されます。最低限、次は揃えておくべきです。

• プロジェクト名
• プロジェクトの種類とスコープ
• 現在の主要ターゲットキーワードや優先事項
• 主な競合
• 進行中のキャンペーンや監査
• リポジトリ内のどこにメモリを保存したいか
• 何を “hot” に残し、何をアーカイブに回すか

これらがないと、Claude は構造自体は作れても、内容が汎用的になりやすく、実運用での役立ち度が下がります。

メモリ構造を初期化する

最初の実行では、Claude に次の初期化を依頼するのが実用的です。

• CLAUDE.md をホットキャッシュとして作成
• memory/glossary.md を作成
• 必要に応じて audits、research、monitoring、archives のサブフォルダを作成

最初のプロンプト例:

Initialize the memory-management skill for this SEO project. Create CLAUDE.md as a hot cache, create memory/glossary.md, and propose a minimal memory/ folder structure for rankings, competitors, audits, and reports. Use only sections we will realistically maintain.

最後の一文は重要です。テンプレート自体は優秀ですが、メモリツリーを最初から作り込みすぎると、すぐに保守負債になります。

曖昧な目的を強い起動プロンプトに変える

弱いプロンプト:

Remember this project.

強いプロンプト:

Use the memory-management skill for this project. Save the following into a hot/warm/cold structure:

• Project: Acme SEO
• Hero keywords: technical seo audit, free backlink checker, content optimization guide
• Priority this month: recover rankings after migration
• Top competitors: example1.com, example2.com
• Recent event: technical audit completed on 2025-01-10
• Keep active priorities in CLAUDE.md
• Archive full audit details under memory/audits/technical/
  Then show me what was stored where.

この形が有効な理由:

• スキルの利用意図を明示している
• いま使うべき事実と、詳細アーティファクトを分離している
• 要約だけでなく「どこに置くか」を指定している
• 出力内容をあとから監査しやすい

継続案件向けのおすすめ運用フロー

日常運用で使いやすい memory-management guide は、次のような流れです。

1. CLAUDE.md と基本の memory/ フォルダ群を初期化する。
2. 主要キーワード、競合、優先事項、主要指標を入れる。
3. 大きなイベントのたびに、ホットキャッシュと日付付きアーティファクトの両方を更新する。
4. 定期的に、古くなった項目を CLAUDE.md から降格させる。
5. Claude にはまずホットキャッシュから要約させ、必要になったときだけ深い記録を取りに行かせる。

この運用なら、すぐ取り出したい文脈は軽いまま保ちつつ、詳細も別レイヤーで失わずに済みます。

どんなときにスキルを発火させるべきか

このリポジトリには、次のようなトリガー文言が含まれています。

• “remember project context”
• “save SEO data”
• “track campaign progress”
• “what did we decide last time”
• “what do we know so far”
• “remember this for next time”

実際には、単なる使い捨ての推論ではなく、再利用できるプロジェクト状態が会話の中で生まれたタイミングで memory-management を起動するのが適切です。

ランダムなメモ追加ではなく、更新トリガーで運用する

このスキルの強みの一つが、references/update-triggers-integration.md にあるイベント駆動の更新ロジックです。基本パターンは以下です。

• 順位チェック後に、キーワード表を更新し、日付付きの順位履歴を保存する
• 競合分析後に、ホットキャッシュを更新し、完全版レポートを保存する
• 監査後に、最重要のアクション項目を CLAUDE.md に抽出し、完全な監査内容は別保存する
• 月次レポート後に、メトリクスを更新し、古い作業内容をアーカイブする

ここが、長く使えるメモリ運用と、ただのメモ置き場との差です。

何を CLAUDE.md に置くべきかを判断する方法

CLAUDE.md には、頻繁に必要になる項目だけを置いてください。

• 最重要キーワード
• 主要競合
• 現在進行中の最適化優先事項
• 直近の主要メトリクス
• 現在のキャンペーン状況

観測したことを何でも入れてはいけません。このリポジトリの promotion / demotion ルールが有用なのは、「今すぐ取り出せるべき情報」と「要求されたときだけ memory/ から読めばよい情報」を強制的に切り分けられるからです。

出力品質を上げる実践的なプロンプトパターン

構造や閾値を明示するプロンプトを使うと、結果が安定します。

• “Promote only keywords mentioned 3+ times recently.”
• “Demote anything stable and inactive for 60+ days.”
• “Extract only the top 5 action items from this audit into hot cache.”
• “Save the full report, but keep the summary under 150 words in CLAUDE.md.”

これらはリポジトリ内のルールと相性がよく、自由度の高すぎる “store this” より、きれいなメモリ構造を作りやすくなります。

よくある導入ミス: 自動記憶のように扱ってしまう

memory-management usage がうまくいかない最大の要因は、暗黙的に永続化されると期待してしまうことです。このスキルは魔法の記憶ではなく、あくまでワークフローです。つまり、次の運用は必要です。

• ファイルを初期化する
• 意味のあるイベントの後に更新を依頼する
• ホットキャッシュが膨らみすぎていないか確認する
• 命名規則とフォルダ規約を揃える

メモリ層を誰も手入れしなければ、取り出し精度は確実に落ちていきます。

memory-management スキル FAQ

memory-management は SEO プロジェクト専用ですか？

いいえ。ただし、この実装は明らかに SEO / GEO 業務向けに最適化されています。例、テンプレート、更新トリガーはいずれもキーワード、競合、監査、レポートを中心に組まれています。他の長期的な知識運用にも応用はできますが、そのままで最も相性がよいのは SEO オペレーションです。

チャット履歴だけを使うより良いですか？

はい。特に、作業が多数のセッションや複数の担当者にまたがる場合は有利です。チャット履歴は検索しづらく、見失いやすく、プロジェクト状態を保持するには構造が弱いからです。memory-management skill は重要な文脈をファイルに外出しし、Claude が体系的に見直し・更新できる状態にします。

memory-management は初心者向きですか？

比較的、はい。hot-cache-template.md や glossary-template.md の存在によって、初期セットアップの負担はかなり下がります。初心者にとって一番難しいのは、何をホットキャッシュに残し、何をアーカイブに回すべきかの判断です。最初から広げすぎず、小さく始めれば十分扱えます。

memory-management を使わないほうがよいのはいつですか？

次のような場合は見送って構いません。

• 作業が単発
• プロジェクトに繰り返し参照する文脈がほとんどない
• リポジトリ内のファイルを更新したくない
• memory/ フォルダを継続的に保守する可能性が低い

そのようなケースでは、通常のプロンプトや単一のサマリーファイルで十分なことがあります。

memory-management に外部ツールは必要ですか？

いいえ。基本動作はファイルベースです。外部の SEO ツールや MCP アクセスは任意で、順位データや監査結果など、更新用の最新情報を取り込むときに役立つ程度です。

大きなプロジェクト要約ファイル 1 つを書くのと何が違いますか？

要約ファイル 1 つだけだと、時間とともに古くなり、肥大化しやすくなります。memory-management for Context Engineering が優れているのは、次の 3 層を分けて扱うからです。

• CLAUDE.md にあるアクティブな文脈
• memory/ にある構造化された参照情報
• 別領域にある履歴アーカイブ

この分離によって、取り出しやすさと保守性の両方が上がります。

memory-management スキルを改善する方法

思っているより小さいホットキャッシュから始める

最もよくある失敗は、CLAUDE.md に詰め込みすぎることです。何でも「重要」にすると、結局どれもすぐ取り出せなくなります。ホットキャッシュには、現在の判断、現在のターゲット、現在の状態だけを絞って残してください。詳細は memory/ 配下の日付付きファイルへ逃がすのが基本です。

入力ソースをもっと強くする

より良い memory-management の結果は、より良い元データから生まれます。たとえば次のような曖昧な依頼ではなく、

Save our audit findings.

次のように依頼します。

Save this technical audit. Put the full report in memory/audits/technical/2025-01-10-core-web-vitals.md. Extract the top 3 issues, expected impact, and owner into CLAUDE.md. Add any new recurring terms to memory/glossary.md.

この形なら、何を保存するか、どこに保存するか、ホット層に何を残すかまで Claude に明示できます。

命名規則と日付付きアーティファクトを統一する

ファイル名のパターンを安定させると、後からの取り出し精度が上がります。たとえば次のような形式です。

• memory/audits/technical/YYYY-MM-DD-name.md
• memory/research/competitors/YYYY-MM-DD-analysis.md
• memory/monitoring/rank-history/YYYY-MM-DD-ranks.csv

これは重要です。後続のプロンプトで、その都度ばらばらのファイル名を探し回るのではなく、パターンを指定して参照できるようになるからです。

promotion / demotion ルールを明示的に適用する

勘だけに頼らないでください。このリポジトリのルールは実務的です。

• 頻繁に参照されるもの、変化の速いものは昇格させる
• 安定していて動きのないもの、完了済みのものは降格させる
• 定期スケジュールでホットキャッシュを見直す

Claude にこれらのルール適用まで依頼すると、メモリシステムを長く使いやすい状態に保てます。

更新のたびに配置サマリーを出させる

保存後は毎回、次のように確認すると効果的です。

Show exactly what you updated in CLAUDE.md, what you stored in memory/, and what you decided not to keep hot.

これで分類ミスを早い段階で見つけやすくなり、スキルを軸に組み立てている memory-management guide への信頼性も上がります。

最初の出力のあとに必ず調整する

最初の 1 回目は、広すぎるか浅すぎるかのどちらかになりがちです。次のような追加入力で調整してください。

• “Reduce hot cache to only this quarter’s priorities.”
• “Move completed campaign details out of CLAUDE.md.”
• “Add missing competitor shorthand to memory/glossary.md.”
• “Create a monthly archive routine from the existing files.”

良いメモリシステムは、1 回で完璧に作るものではなく、数サイクルかけてチューニングしていくものです。

取得依頼と更新依頼をセットで行う

継続運用では、質問と保守を一緒に行うと効果的です。

What do we know so far about hero keywords, and update the hot cache if any targets are stale?

このパターンなら、メモリを使いながら同時に手入れできます。あとで別の掃除セッションを設けるまで放置して、内容がずれていくのを防げます。