ブリーフ管理
ブリーフは、ローカルSEOエンゲージメントのための永続的な作業状態です。ロケーションごとに1つのブリーフを作成します。マルチロケーションワークのためのブランド集約。スケジュールされたタスクの出力は、時間の経過とともにブリーフを拡張し、各ビジネスのすべてのスキャン、監査、レポート、発見結果の累積的な履歴を構築します。
構造
briefs/
{brand}/
_brand.brief.md ← 設定 + 全ロケーションの集約
reports/ ← ブランドレベルの集約レポート
{location}/
location.brief.md ← 常に最新、常に軽量
reports/ ← 週次、月次、QBRレポート
scans/ ← 地理グリッドスキャン、引用監査、ページ監査
drafts/ ← GBP投稿、レビュー応答（承認待ち）
alerts/ ← 監視アラート
初回実行検出
これは最も重要なセクションです。 ユーザーが特定のビジネスに言及し、ブリーフが存在しない場合、まだリクエストを処理せず、最初にセットアップを実行してから、ユーザーが依頼した内容に戻ります。
検出
特定のビジネスの作業を行う前に、既存のブリーフを確認します：
- Claude Code：
briefs/{brand-slug}/{location-slug}/location.brief.mdを探す - Claude Project：プロジェクト知識ベースでこのビジネスのブリーフファイルを確認
- 見つかった場合：ブリーフからの再開へ
- 見つからなかった場合：初回実行セットアップへ
初回実行セットアップ
ユーザーに次のように伝えます：
「[ビジネス名]のブリーフがまだありません。今後のために追跡できるよう、いくつか詳細を確認させてください。約2分で終わります。」
次に、以下の質問を一度に1つずつ、すべてを一度に尋ねずに順番に聞きます：
Q1：「何のプライマリキーワードでランクインしたいですか？（例：『配管工 バッファロー』）」
Q2：「ウェブサイトのURLは？」
Q3：「サービスエリアの範囲は？（例：5マイル、20マイル）」
Q4：「これはクライアントのために管理していますか、それとも自分のビジネスですか？」
- クライアントの場合：「クライアントのレポート送信先メールアドレスは？」
- 自分のビジネスの場合：スキップ
Q5：「Slackチャンネルにアラートやレポートを送信しますか？」（任意。同意しない場合はスキップ）
これで終わりです。本当に曖昧な場合以外は、これ以上は尋ねないでください。
質問後
-
ブリーフフォルダ構造を作成：
briefs/{brand-slug}/{location-slug}/location.brief.mdbriefs/{brand-slug}/{location-slug}/reports/briefs/{brand-slug}/{location-slug}/scans/briefs/{brand-slug}/{location-slug}/drafts/briefs/{brand-slug}/{location-slug}/alerts/briefs/{brand-slug}/_brand.brief.md
-
回答と会話内の既存のコンテキストからIdentityセクションを入力
-
Q4/Q5の回答から
_brand.brief.mdの承認ブロックを設定 -
許可を求めずに自動的に初期監査を実行：
- LocalSEOData
local_audit - LocalSEOData
business_profile+profile_health - LocalSEOData
geogrid_scan（7x7、プライマリキーワード、指定された半径） - LocalSEOData
citation_audit - LocalSEOData
review_velocity+google_reviews - LocalSEOData
competitor_gap
- LocalSEOData
-
監査結果からFindingsを入力
-
最も優先度の高い1つの修正をNext Actionに設定
-
スケジュールタスクのセットアップを提案：
「ブリーフを作成し、初期監査を完了しました。[X件の重大、Y件の重要]な問題が見つかりました。[トップの発見を一文で]。
自動監視を設定しますか？毎週のランキングスキャン、レビューモニタリング、GBP変更検出、月次レポートを自動で実行するように設定できます。」
同意した場合：
tasks/README.mdのタスク一覧から、監査結果に基づいて推奨し、/scheduleで設定 同意しなかった場合：元のリクエストを続行 -
その後、ユーザーが元々依頼した内容に戻る：
「それでは、[元のリクエスト]を行います...」
Claude Project / ブラウザユーザー向け
ファイルシステムアクセスがない場合：同じ会話フローと監査を実行し、セットアップの最後にブリーフを整形されたテキストとして出力します：
「こちらがブリーフです。プロジェクト知識ベースに追加してください。次回から利用できるようになります：」 [ブリーフ内容]
ブリーフを作成するタイミング（初回実行以外）
初回実行以外では、セッション中に以下の場合にブリーフを作成します：
- ブリーフがないビジネスに対してツール呼び出しが行われようとしている場合
- ユーザーが明示的に作成を依頼した場合
以下の場合はブリーフを作成しません：
- 特定のビジネスを伴わない一般的なローカルSEOの質問
- ツールやスキルの説明
- ライブデータを伴わない単一質問の回答
ブリーフの場所
Claude Code / Cowork：
briefs/{brand-slug}/{location-slug}/location.brief.md
Claude Project： 作成後、ブリーフファイルをプロジェクト知識ベースにアップロードします。ユーザーがまだ行っていない場合はそのように伝えます。
ブリーフの更新（手動セッション）
各セッションの終了時：
- セッションログ。 1行：日付 + 作業内容
- 実行したツール。 各ツール呼び出し：日付、ツール、エンドポイント、1行の発見
- 新たな発見。 新たな問題を重要度別に分類：重大 / 重要 / 監視
- 成果物。 完了したものをマーク、新たな保留を追加
- 次のアクション。 最も重要な次のステップで上書き
スケジュールタスク出力の受信
スケジュールタスクが出力ファイルを書き込んだ場合：
- 出力ファイルを読み取る
- セッションログに1行追加：
[日付] | {タスク種類} → {1行の発見} → 詳細は {出力パス} - 新たな重大な発見がある場合：Findingsセクションを更新
- タスクが現在よりも優先度の高い問題を明らかにした場合：Next Actionを更新
_brand.brief.mdのLocationsテーブル内の該当ロケーション行を更新
ブリーフは軽量に保ちます。詳細は出力ファイルに保存されます。ブリーフはインデックスです。
ブリーフからの再開
ユーザーがビジネスに戻ってきた場合：
- ブリーフを読み取る
- 各サブフォルダの最新出力ファイルを読み取り、現在の状態を把握
- 2～3文で要約：これまでに行ったこと、主な発見、現在の状態
- Next Actionを提示
- 質問：「ここから再開しますか、それとも特定のことを行いますか？」
scans/ に結果が保存されているツールは、ユーザーが依頼した場合、またはデータが30日以上古い場合を除き、再実行しないでください。
累積的な価値
スケジュールタスクが数ヶ月にわたってブリーフに書き込みを続けた後、履歴はクエリ可能になります：
- 「3月にランキングが下がった原因は？」→その期間の
scans/を確認 - 「今年のレビュートレンドは？」→
reports/のレビューモニターを確認 - 「この競合はいつ現れた？」→競合モニターを確認
出力ファイルは決して削除しないでください。 フォルダが大きくなりすぎた場合はアーカイブしてください。履歴が価値です。
学びのフライホイール
手動セッションでもスケジュールセッションでも、毎回以下の点に注意を払います：
- ツールがスキルファイルと矛盾するデータを返す
- 3つ以上のロケーションで、まだ文書化されていないパターンが現れる
- GBP、アルゴリズム、AIプラットフォームの動作が文書化された期待値と異なる
- ツールのエンドポイントが予期しない動作をする
これらを観察した場合、明示的に提示します：
「このセッション中に[X]に気づきました。このパターンはスキルファイルにありません。レビューのために
meta/lessons.mdに追加しますか？」
確認を待ちます。その後、レッスンを書き込みます。
マルチロケーションブランド
各ロケーションのセッション後：
_brand.brief.mdのLocationsテーブル内の該当ロケーション行を更新- 3つ以上のロケーションでパターンが現れた場合のみ、ブランドレベルのNotesに追加
スラッグ形式
小文字、ハイフン、わかりやすく：
- ブランド：
keystone-insurance、mikes-plumbing - ロケーション：
buffalo、downtown-chicago、pittsburgh-pa