サイトプラン

PLAN.mdは、プロジェクトの最初のビルドが完了した時点で作成され、サイトの現在の状態を常に示すことを目的としています。これまでに起きたことすべての記録ではありません（それは「バージョン」タブと変更履歴の役割です）。サイトプラン画面は、そのMarkdownを実際の画面に変換します。ページは表、モジュールは一覧、未解決の質問はチェックリスト、事業情報・ブランド・決定事項は普通の文章で表示されます。

ビルドが1回も完了していない場合は、まだ読み込むものがありません。画面には「まだプランがありません」と表示され、プランは最初のビルドで作成されることを分かりやすく説明し、空の表を表示する代わりにプロジェクトのページへのリンクを表示します。

プランなしでファイルが届いたサイト（コネクタ経由で別のAIツールから公開された、インポートされた、またはアップロードされた場合）にもプランが作られます。画面はプロジェクトの概要、キットで選んだ項目、測定済みのページから新しいプランを作成します。「このプランはあなたのために作成されました」というバナーが表示され、「このプランを保存」を選ぶと、それがプロジェクトの正式なプランになり、すべてのセクションを編集できるようになります。「サイトプランの全文を読む」は、「プランと概要」タブのプラン文書に戻ります。

キット（「プランに追加」）から後で追加されたツールは、プランの本文がそれより前に書かれていても、「予定」として「モジュール」一覧に加わり、「キットで見る」リンクが付きます。

タイトルの下に、プランが最後に最新化された日時を示す行があります：「プラン更新 10月2日 15:04」。この時刻は、aiKitがサイトの実際のファイルを最後に測定した時点のものです。測定は変更のたびに行われます（チャットでの編集、ピン留め、キットへの追加、復元、プランの手動編集、別のAIツールからの公開など）。

一番上には、計画ができたあとに表示される項目があります。全体の完成率バーと、その下に3つのタイルがあります。「作成済みのページ」（計画したページ数に対して）、「作成済みのモジュール」（選んだモジュール数に対して）、「回答済みの質問」（計画内の未解決の質問に対して）です。各タイルはボタンになっていて、それが数えているセクションまでスクロールします。これらは計画の文章による自己申告ではありません。ページは、aiKitがサイトの実際のファイルの中で見つけた場合にのみ作成済みとしてカウントされます。モジュールは、検証済みのビルドレポートまたはファイル内で見つかったものだけが作成済みとしてカウントされます。質問は、計画内でその行にチェックが入っているか、お客様が「質問」ページで回答した場合に回答済みとしてカウントされます。

計画が遅れる原因は2つあり、画面にはそのどちらかが表示されます。変更後に計画の文章を書き換えるAIの処理が完了しなかった場合（理由とともに「最後の変更後に計画の文章が更新されませんでした」と表示）、またはサイトが、計画の測定時点より新しいバージョンになっている場合（「このプランが最後に更新されてから、サイトが変更されました」と表示）です。どちらの場合も「計画を更新」ボタンが表示されます。このページを開いたときに自動で実行されることはありません（ページを開いてもAIは使われません）。エンジンは各変更をバックグラウンドで計画に反映しており、このボタンは、その反映が遅れたときのためのものです。「計画を更新」を押すと、最新の変更が文章の計画に反映され、サイトが再度測定されます。それでもうまくいかない場合は、バナーに問題の内容が残ります。もう一度「計画を更新」を押すか、計画を手動で編集できます。

「ヘルス」カードは、aiKitが実際のファイルで確認したルールに基づいてサイトを100点満点で採点します。AIの意見による採点ではありません。チェック対象は、ページタイトルや検索用の説明文がない、または重複している、メインの見出しがない、または複数ある、存在しないページへのリンク、どこからもリンクされておらずメニューにも載っていないページ、スクリーンリーダー用の説明がない画像、非常に短いページ、送信先がないフォーム、そして依頼内容にあるのにサイト上にないモジュールです。各問題には、どのページの問題か、なぜ重要かが示され、「修正」ボタンがあります。「修正」を押すと、その問題の用意された指示が依頼として送られ、AIに渡されます。作業中はボタンに「修正を依頼しました」と表示され、変更が反映されると採点が再度測定されます。「高」「中」「低」の件数で一覧を重要度別に絞り込めます。「すべて表示」を押すと絞り込みが解除されます。

「サイトマップ」はサイトをツリーで表示します。上部にホーム、その下にメニューの順番どおりのページ、そしてそれらのページから辿れるページが続きます。どこからもリンクされていないページは別のグループに置かれます。計画に載っているがまだ作成されていないページは点線で描かれ、「計画中」と表示されます。計画に記載がないのに作成済みのページには「計画にない」と表示され、「計画に追加」ボタンで「ページ」セクションに追加できます。

（サイトマップまたはページ一覧で）任意のページを押すと、計画の横にそのページの詳細が開きます。アドレスバーは ?page=/about に変わるので、このリンクはチームの誰が開いても同じページを表示します。詳細には、Googleでの表示方法（タイトル、アドレス、説明文）、セクションとメインの見出し、文字数、画像と説明文がない枚数、フォームとそれを動かすキットのモジュール、お客様が承認したかどうか、そして最後の変更（いつ、誰が、何を依頼したか）が表示されます。

「履歴」には、aiKitが保存しているバージョン（最初のバージョンと直近10件）が新しい順に表示されます。各項目には番号、変更の種類（初回作成、チャット、ピン、キット、公開、復元、計画の編集）、日時、依頼内容、依頼者、変更されたページが表示されます（ページを押すと詳細が開きます）。最新のものには「現在のバージョン」と表示されます。それ以外の古いバージョンには「このバージョンに戻す」ボタンがあります。このボタンを押すと最初に確認が出て、サイトを元に戻す前に現在の状態が保存されるため、復元は取り消せます。最初の3件が表示され、残りは「すべて表示」で一覧できます。

「事業情報」セクションでは、「お客様ファイル」の電話番号、メールアドレス、住所、営業時間を、作成済みのページの本文と照合します（最初にホームとお問い合わせページを確認します）。各項目には「サイトに掲載あり」または「サイトに見つからない」と表示されます（確認したページ数も併記されます。サイトに古い情報が残っている可能性があるためです）。「お客様ファイルで編集」のリンクから、情報の正とする元は「お客様ファイル」であることを確認できます。

• ページ — 表形式です。項目は「ページ」「パス」「目的」「状態」（「作成済み」または「計画中」）です。ページが作成済みで、サイトが公開されると、実際のページへの「表示」リンクが表示されます。
• モジュールとツール — 計画に記載されたすべてのモジュールが、それぞれ「作成済み」または「計画中」のラベルと個別のメモとともに表示されます。
• 事業情報 — 営業時間、住所、サービス、価格など、事業に関する事実をすべて平易な文章で記載します。
• ブランド — 計画に記録されたカラーパレット、トーン、スタイルに関するメモです。
• 決定事項 — すでに決定され、次の編集で蒸し返すべきでない実際の判断です。
• 未解決の質問 — まだ本当に決まっていないことのチェックリストで、それぞれ「回答済み」または「未回答」と表示されます。

各セクションのカードには、同じ2つのボタンがあります。「編集」を押すと、そのセクションのMarkdownの生テキストがシンプルなテキストエリアで開き、PLAN.mdに直接保存されます。これはプロジェクト独自のPUTエンドポイントを通じた、実際の即時書き込みです。ただし、意図的にビルドやデプロイは行われず、計画のドキュメントの内容だけが変わります。他のメモを編集するのと同じです。

「変更をリクエスト」は意図的に別の機能です。小さなフォーム（「<section>のどこを変更しますか？」）が開き、送信すると、プロジェクトのフィードバックタブに実際のリクエストが追加されます。ラベルは「サイトプラン — <Section>: …」で、ピンや簡易編集のリクエストとまったく同じ扱いです。送信後は独自のステータス管理が行われ、「リクエストを表示」リンクも表示されます。プラン自体のテキストを自分で修正・書き直す場合は「編集」を使ってください。実際のサイトを（そしてその結果としてプランも）更新したい場合は「変更をリクエスト」を使ってください。

このプランは2つの層で構成されています。測定値（ページ、タイトル、セクション、リンク、フォーム、モジュール、状態）は、変更のたびに実際のファイルからコードで取得されるため、ずれることがありません。文章のプラン（目標、事業情報、ブランド、決定事項、未解決の質問）は、変更のたびに実行されるAIが、変更に関係した部分だけを書き換えて最新の状態に保ちます。AIは変更履歴や日付付きの記録を追加することはありません。変更の記録は「履歴」にあります。

このAIの処理が失敗した場合、文章のプランは中途半端に書き換えられず、元のまま残ります。失敗は記録され、画面には古いプランをそのまま表示する代わりに「プランを更新」（上記参照）が表示されます。

プランの横にあるレールに操作が並びます（スマートフォンでは、レールは進捗バーのすぐ下に全幅の「クライアント用リンクをコピー」ボタンになり、残りは「その他の操作 (3)」の中にまとめられます）。「クライアントと共有」は読み取り専用のリンク（aikit.ai/p/<project>/plan）をコピーします。スタッフ用ツールも編集ボタンも内部情報も含まれません。「ライブサイトを開く」はライブサイトへの直接リンクです。まだ公開されていない場合は、レールに「まだ公開されていません」と表示されます。「ファイル」では、実際のファイル数と、各ファイルのパスとサイズを展開して見られるリストが表示されます。「プランをダウンロード」は、現在の実際のPLAN.mdを本物の.mdファイルとしてダウンロードします。画面が読み込んでいるものとバイト単位で同一で、再生成された要約ではありません。

クライアントのページは「プラン」タブで開きます。これはスタッフが「プランと概要」タブで見るものと同じサイト計画書です（概要と目標、対象ユーザー、戦略、サイトマップ、各ツールとその事業への効果および状態、コンテンツ計画、スケジュール、決定事項、未解決の質問）。ただし、スタッフ専用の部分は含みません。ツール追加時に入力されたメモ、誰が何を追加したかという名前、aiKitのキットへのリンク、「プランを作成」ボタンはありません。2つ目のタブ「ページと承認」では、ページごとの表示を確認できます。

「ページと承認」では、クライアントが既にフィードバックを送るときに使っているのと同じアクセスコードでアクセスできます（別のログインは不要）。クライアントには、同じ進捗バー、自分のページのサイトマップ、「表示」リンク付きのページ一覧、モジュール、事業情報、ブランド、決定事項、未解決の質問、そして「プラン更新日」の行が表示されます。ヘルス、修正手順、履歴、誰が何を依頼したか、ファイル一覧、編集ボタンや「変更を依頼」ボタンは表示されません。

スタッフが自分用にマークした内容は、ページが送信される前にすべてのセクションでサーバー上から削除されます。対象は、「(internal)」「[internal]」「(staff only)」を含む行、「Internal:」または「Staff only:」で始まる行、見出しに InternalまたはStaff only とあるセクション、そして非表示のコメントです。これらの行は、ネットワークデータを含め、クライアントのブラウザには一切届きません。

作成されたページごとに「承認」ボタンがあります。クライアントは名前（と任意のメモ）を入力して承認します。承認は、そのページの正確な内容に紐づけられるため、後でページが変更されると「承認後に変更されました」と表示され、再度確認を求められます。承認できるのは、クライアントのアクセスコードを使っている人だけです。スタッフとしてログインした状態でクライアントのリンクを開くと、各ページの承認状況は見えますが、「承認」ボタンは表示されません。そのため、スタッフがクライアントに代わって承認することはできません。スタッフ用の「サイトプラン」では、承認済みのページには「クライアント承認済み」、変更されたページには「承認後に変更」と表示されます。

下部には「フィードバックを送る」ボタンがあります。サイトが公開済みの場合は、クライアント自身のアクセスコードを使って、フィードバックオーバーレイがオンの状態で実際のライブサイトが開きます。まだ公開されていない場合は、代わりに「最近の更新」ページが開きます。