Communitygithub.com

mos-design-site-planner

何も構築する前に小規模ビジネス向けウェブサイトを計画します。アクティブなMarketingOSブレイン、ギャップのみのインタビュー、およびラベル付けされたリサーチから、ソース付きのウェブサイトブリーフ、検索インテントマップ、各ページの仕様(URL、タイトル、H1、セクション、CTA、証拠)を含むサイトマップを作成します。承認された計画で停止し、ウェブサイトプロジェクトに保存します。

mos-design-site-planner とは?

このスキルは、実際の構築作業に入る前に、小規模ビジネス向けの包括的なウェブサイト計画を作成するためのものです。アクティブなMarketingOSブレインから既知の情報を抽出し、ギャップのみに焦点を当てたインタビューとラベル付けされたリサーチ(measured、observed、assumed)を組み合わせて、ソース付きのウェブサイトブリーフ、検索インテントマップ、各ページの詳細な仕様(URL、タイトル、H1、セクション、CTA、証拠)を含むサイトマップを生成します。このプロセスは、計画が承認された時点で停止し、実際のページ構築、最終的なコピーライティング、デザインシステム、または移行作業には進みません。Claude Code、CodexなどのAIエージェントに対応しており、状態ファイルを使用して中断から再開できるため、大規模なプロジェクトでも効率的です。また、既存のWebサイトのクロール、Search Consoleデータ、キーワードボリュームなど、利用可能なリサーチツールを自動検出し、それらを使用して意図のクラスタリングとページ決定を行います。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/the-vibe-marketing-lab/mos-design-skills/tree/HEAD/mos-design-site-planner

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

MarketingOS サイトプランナー

ビジネスブレインがすでに知っていることと、短いインタビューと実際のリサーチを組み合わせて、誰かが構築できるウェブサイト計画(ブリーフ、インテントマップ、ページごとの仕様)を作成します。計画が成果物です。このスキルは承認された計画で停止します。ページを構築したり、最終的なコピーを作成したり、リダイレクトを設定したり、ビジュアルデザインを選択したりすることはありません。

MarketingOS のコンテキストと前提条件

推奨シーケンス: mos-design-authentication → EmDashプロジェクトセットアップ → mos-design-site-planner → mos-atomic-design-system。いずれも厳格な前提条件ではありません。以前のステップが実行されていない場合は、一度その旨を伝えて続行します。

現在のセッションとそのレコードから、アクティブなビジネスブレインとウェブサイトプロジェクトを解決します。何かを尋ねる前に、ブレインの BRAIN.md またはエージェント指示、CONTEXT.md、business/(ブランド、ボイス、オーディエンス、オファー、戦略、証拠、競合他社)を読み取ります。mos CLI が利用可能な場合、mos context show --json は各コンテキストフィールドの背後にあるファイルを指定します。各ビジネスのコンテキストは分けて保持します。MarketingOS がない場合は、ユーザーが提供するファイルから作業し、その他すべてをギャップとして扱います。

バンドルされたスクリプトには Bun を使用します。Bun がない場合は、ユーザーを https://bun.com/docs/installation に誘導します。$SKILL をこの SKILL.md を含む実際のディレクトリに解決します。インストール場所はエージェントによって異なります。

起動方法: Claude Code では /mos-design-site-planner、Codex では $mos-design-site-planner。Claude Code では AskUserQuestion を使用して質問し、Codex では文字選択肢付きの番号付き質問として質問します。1 つの初期プロンプトがワークフロー全体を駆動します。すべての承認は同じ会話内に保持します。

証拠ラベル

すべてのリサーチ結果とすべてのインテントクレームには、1 つのラベルが付与されます。

  • measured: ツールまたはエクスポートからの数値(Search Console のクリック数、キーワードボリューム、クロール数)。数値と日付付きのソース ID を含めます。
  • observed: 日付はあるがカウントされていない直接観測(オートコンプリートの提案、検索結果ページ、People Also Ask、競合サイトマップ、AI 回答)。日付付きのソース ID を含めます。
  • assumed: 推論またはユーザーの発言。理由を記録します。

ソースのない結果は assumed と見なされるか、省略されます。ツールアクセス、キーワードボリューム、People Also Ask の質問、ビジネスファクトは、実際に実行で生成された場合にのみ報告されます。

ワークフロー

各ステップの後、<project>/site-plan/state.json に進捗を保存し、後のセッションで中断したところから再開できるようにします。ファイル形式、テンプレート、状態スキーマについては、references/output-format.md を参照してください。

1. 事前確認

ブレイン、ウェブサイトプロジェクト(その docs/project.md または同等のプロジェクトノート)、および既存のサイト URL(存在する場合)を解決します。site-plan/state.json が存在する場合は、そのステップを報告して再開します。このセッションで実際に動作するリサーチツール(Search Console のエクスポートまたは接続ツール、DataForSEO キー、クローラー(Scrapling またはプレーンな fetch)、ウェブ検索)を検出します。各ツールをテストします。環境内のキーがテスト呼び出しに失敗した場合は利用できません。検出手順については、references/research.md を参照してください。まだウェブサイトプロジェクトがない場合は、保存場所を一度尋ねます。ブレインの outputs/YYYY/MM-Mon/YYYY-MM-DD-site-plan/ がフォールバックです。

ブレイン、プロジェクト、保存場所、既存の URL(または「新規サイト」)、および利用可能なツールリストが state.json に記録されたら完了です。

2. 既知の情報

ブレインからカードを作成します。ビジネス、サービス、拠点とサービスエリア、オーディエンス、オファー、ボイス、証拠、主要アクション。各項目はソースファイルを指定し、confirmed(ブレインに明確に記載)、inferred(行間を読む)、または missing とマークされます。表示し、ユーザーに修正を許可します。カード形式については、references/interview.md を参照してください。

ユーザーがカードを確認または修正したら完了です。

3. ギャップのみのインタビュー

カードで inferred または missing とマークされた項目についてのみ、バッチ形式で質問します。各質問には推奨回答とその理由を含めます。質問バンクは、目標、マネーサービス、サービスエリア、新規サイトかリプレースか、機能性、証拠資産、競合他社、制約事項をカバーします。references/interview.md を参照してください。デザイン関連の参照は mos-atomic-design-system とデザインスキルに属するため、ここでは除外します。

すべてのブリーフフィールドが回答されるか、GAP として記録されたら完了です。

4. ブリーフの確定

ブリーフを 1 画面に表示します。ソース付きのファクト、ギャップ、リサーチ計画、および推定コストを含む有償コール。リサーチの時間や費用を使う前に、許可を求めます。

ユーザーがブリーフを承認したら完了です。decisions.md に記録します。

5. リサーチ

事前確認で動作が確認された各メソッドを実行します。既存サイトのクロールと URL インベントリ、Search Console のクエリとランディングページ、キーワードボリューム(キーがある場合は DataForSEO、それ以外はボリュームなしとラベル付けされたオートコンプリート)、検索結果ページと People Also Ask、競合サイトマップ、およびオプションの AI 回答チェック。不足しているオプションソースはリサーチギャップリストに追加され、作業は続行されます。メソッド、フォールバック、コスト報告については、references/research.md を参照してください。すべてのソースは research/sources.md に日付付きの行として記録されます。

各メソッドがラベル付きの結果またはギャップエントリを生成したら完了です。

6. ページの決定

クエリをインテントにクラスタリングし、ページルールを適用します。インテントごとに 1 ページ、マネーサービスごとに 1 つのサービスページ、明確なコンテンツがあるサービスエリアのみのロケーションページ、明示的なカニバリゼーションチェック、トラフィックまたはリンクのある既存 URL ごとの keep、merge、redirect、または retire の決定。ブレインの既存のオファーとポジショニングをフレームとして使用します。ルールとテストについては、references/page-rules.md を参照してください。

すべてのインテントが理由付きで 1 ページまたは none にマッピングされ、トラフィックまたはリンクのある既存 URL に移行アクションがある場合に完了します。

7. 各ページの仕様

各ページについて、URL、タイトルタグ、H1、目的、ターゲットインテントとその証拠、セクション概要、主要 CTA、ブレインからの実際の証拠(または GAP: マーカー)、内部リンク、スキーマタイプ。その後、site-plan.md と sitemap.csv を作成し、ドラフトモードでバリデーターを実行します。

bun $SKILL/scripts/check-site-plan.ts <project>/site-plan --draft

ドラフトチェックが成功したら完了です。

8. 承認ループ

サイトマップツリーを表示し、次にページ仕様を 3 つまたは 4 つのバッチで表示します。各ページについて、ユーザーが承認、編集、または削除します。編集を適用し、ドラフトチェックを再実行して変更を表示します。すべての決定を日付付きで decisions.md に記録します。ユーザーが計画全体を承認するまで繰り返します。

すべてのページの最新の決定と計画自体が approved になったら完了です。

9. 保存と引き継ぎ

最終ファイル(site-plan.md、decisions.md、sitemap.csv、research/)を作成し、state.json を approved に設定し、完全チェックを実行します。

bun $SKILL/scripts/check-site-plan.ts <project>/site-plan

プロジェクトノート(docs/project.md または同等のもの。作成前に確認)に日付付きエントリを追加します。計画された内容、保存場所、チェック結果、次のステップ(通常は mos-atomic-design-system)。ウェブサイトプロジェクトがすでに git リポジトリの場合は、計画ファイルを明示的なパスでステージングしてコミットします。シークレット、.env ファイル、または生のツール応答をステージングしたり、プッシュしたりしないでください。コミットルールについては、references/output-format.md を参照してください。

最後に、変更内容、チェック出力、未解決のギャップとブロッカー、および正確な次のアクションを報告します。チェックが合格したと報告するのは、このセッションで実際に実行され合格した場合のみです。

参照マップ

ファイルいつ読むか
references/interview.mdステップ 2 から 4: カード、質問バンク、バッチ処理、ブリーフ再生
references/research.mdステップ 1 と 5: ツール検出、各リサーチメソッド、フォールバック、コスト
references/page-rules.mdステップ 6: インテントクラスタリング、ロケーションページ、カニバリゼーション、移行マップ
references/output-format.mdステップ 7 から 9: バリデーターが強制する形式、状態、決定、コミット
assets/すべての出力ファイルの開始テンプレート
scripts/check-site-plan.ts--help; ステップ 7 から 9 で実行
scripts/test-check-site-plan.tsバリデーターが壊れた計画ごとに失敗することを証明

関連スキル

MarketingOS GEO パック(mos-geo-skills)からのオプションのフォローオンスキル。ここで名前が挙げられ、個別にインストールされます。mos-geo-topic-clusters はステップ 6 の前に大規模な Search Console または Ahrefs エクスポートをクラスタリングするため、mos-geo-brand-360 は AI 回答チェックのため、mos-geo-fan-out-map はサイトが公開された後のために使用します。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル