クライアントサイトの構築
メインセッションがこのパイプラインを実行し、サブエージェントに委譲します。(サブエージェントは他のサブエージェントを開始できないため、これがスキルであってオーケストレーターエージェントではない理由です。)
[0 インテークゲート] 概要 + DESIGN.md + 参考資料
↓
[1 計画] サイトマップ、ページセクション、コピー → plan.md, src/data/*
↓
[ユーザーゲート 1] 計画とコピーを承認
↓
[2 ビルド] ページとビジュアルシステム
↓
[3 SEO] SEOエージェント → seo-report.md
↓
[4 検証] npm run verify (ハードゲート)
↓
[5 レビュー] サイトレビューアエージェント → review-report.md
↓
[6 修正ループ] P0/P1 → 修正 → 検証 → 再レビュー(最大2ラウンド)
↓
[ユーザーゲート 2] サイトを承認
↓
[7 ローンチ準備] ローンチチェックリスト + 引き継ぎ書
↓
[8 教訓] docs/lessons.md に追記
成果物
すべて .claude/pipeline/ に配置します:
pipeline-state.md ステージ、修正ラウンド、最終更新日時
plan.md サイトマップ、ページごとのセクション、ページごとのメインアクション
review-report.md site-reviewer からの出力
seo-report.md seo からの出力
screenshots/ npm run verify からの出力
各ステージの開始時に pipeline-state.md を読み、そこに記された場所から再開します。各ステージの終了時にそれを更新します。これにより、ビルドを複数のセッションにまたがって行うことができます。
ステージ 0: インテークゲート
各項目を確認します。不足しているものがあれば、止まってユーザーがそれを埋めるのを手伝ってから、他のことを始めます。
| 項目 | 準備完了条件 |
|---|---|
.agents/product-marketing.md | ビジネスファクトセクションが完了し、メインアクションが命名され、対象顧客とボイスが埋まっていること。ユーザーから提供された情報をもとに、product-marketing スキルを使用してドラフトを作成します。 |
src/data/business.json | 名前、電話、住所、営業時間、マップリンクが概要と一致していること。概要からコピーします。 |
DESIGN.md | すべてのセクションが埋まっていること。ユーザーが参考資料しか持っていない場合は、references/ からドラフトを作成し、確認を求めます。 |
references/ | 少なくとも2つのスクリーンショットまたはURLがあり、それぞれから何を参考にするかのメモがあること。 |
| クライアントアセット | ロゴと写真、または当面は代用で問題ないという明示的なメモがあること。 |
| 編集 | クライアント自身がサイトを編集するか?(ステージ7に影響します。) |
次に、DESIGN.md から src/styles/tokens.css を記入します。
ステージ 1: 計画
plan.mdを書きます:ページ(ほとんどのクライアントにはホーム、メインオファーごとのページまたはメニュー/サービス、アバウト、コンタクトが必要です)、ページごとの1つのメインアクション、各ページのセクションを順に並べます。概要とsite-essentialsを使用します。copywritingスキルでコピーを書き、次にそれに対してcopy-editingを実行します。概要の顧客の言葉とクライアント自身の言葉から始め、それらのフレーズの一部をほぼそのまま使用します。CLAUDE.md のハウスルール9(一般的なAIフレージングは不使用)に従います。src/data/(home.json, services, FAQs)に配置し、コンポーネント内には配置しません。- 不明な点は
[NEED: ...]とマークします。不足を捏造した事実で埋めることは決してしません。
ユーザーゲート 1
停止します。ユーザーに以下を表示します:サイトマップ、各ページのセクションとメインアクション、全文コピー、すべての [NEED: ...] 項目。承認または変更を待ちます。コピーはビルド後よりも今変更する方がコストが低くなります。
ステージ 2: ビルド
design-taste-frontend スキル(Taste Skill)を使用して、このAstroプロジェクト内でビルドします。開始する前に、以下を伝えます:
- 種類は
place(人が訪れる場所)またはservice(人が雇われるサービス)であり、技術的な種類は決してありません。 - DESIGN.md と
references/がパレット、タイポグラフィ、雰囲気を設定します。Taste Skill 自身の扱うパレットとフォントは上書きされます。 - ビジネスファクトは
src/data/business.jsonから取得されます。Taste Skill の代用連絡先ルールは適用されません。 - モーションは CLAUDE.md のハウスルールに従います。
ページごとにビルドし、最初にホームを構築します。ホームの後、npm run verify を実行し、3つのスクリーンショットを確認して、次のページを構築する前に見つけた問題を修正します。Taste Skill のフィニッシュゲートは、停止時に自動的に実行されます。その結果は入力として扱いますが、競合が発生した場合は CLAUDE.md が優先されます。
ステージ 3: SEO
SEOエージェントは head タグ、JSON-LD、robots を編集するため、検証とレビューの前に実行されます。これにより、レビューは完成したサイトを評価できます。
seo: "このサイトのSEOを監査および実装します。ローカルビジネスのステップを含みます。概要: .agents/product-marketing.md。レポートを .claude/pipeline/seo-report.md に書き出してください。"
ステージ 4: 検証(ハードゲート)
npm run verify
すべての check-site のFAILとスクリーンショットの問題(横スクロール、コンソールエラー)は、レビューの前に修正しなければなりません。[NEED: ...] による失敗は、ユーザーに既に尋ねている事実についてのみ許可されます。それらをリストアップします。check-site が汎用的すぎるとフラグを立てたコピーは、クライアントが実際にその単語を使用している場合を除き、書き直します。
ステージ 5: レビュー
レビューアは読み取り専用であり、レポートを最終メッセージとして返します。そのメッセージを一字一句そのまま .claude/pipeline/review-report.md に保存します。
site-reviewer: "構築されたサイトをレビューしてください。計画: .claude/pipeline/plan.md。概要: .agents/product-marketing.md。デザイン: DESIGN.md。スクリーンショット: .claude/pipeline/screenshots/。既に行われたSEO変更: .claude/pipeline/seo-report.md。完全なレポートを最終メッセージとして返してください。"
ステージ 6: 修正ループ
| site-reviewer の評決 | アクション |
|---|---|
| 準備完了 | ゲート2へ進む |
| フォローアップが必要、P2のみ | ゲート2へ進み、P2をリストアップする |
| フォローアップが必要(P1)またはブロック(P0) | ラウンド < 2: 修正し、ステージ4(検証)を再実行し、変更されたページに対して site-reviewer を再実行してレポートを保存する。ラウンド = 2: 停止してユーザーに表示する。 |
壊れているもの(単に概要から外れているだけでなく)については、bug-fixer エージェントを使用します。pipeline-state.md のラウンドを毎回インクリメントします。
ユーザーゲート 2
停止します。ユーザーに以下を表示します:390px と 1440px でのホームのスクリーンショット、評決、残りのP2、必要なSEO決定、残りの [NEED: ...] 項目、および差し替えが必要なプレースホルダー写真。承認を待ちます。
ステージ 7: ローンチ準備
npm run check:launchを実行し、すべてのFAILを修正します。次にdocs/launch-checklist.mdを記入し、各項目を「完了」「該当なし」「誰かの対応待ち(誰かを明記)」のいずれかにマークします。- クライアント向けに
docs/handoff.mdを記入します。 - クライアントがサイトを編集する場合は、
docs/client-editing.mdに従います。 - サイトが実際のドメインで公開された後は、ユーザーに
claude-seoを実行するよう促します:/seo local <url>および/seo audit <url>。
ステージ 8: 教訓
レポートと修正ラウンドをスキャンし、2回以上問題が発生した、または実際に時間を要したものを特定します。docs/lessons.md に日付入りの行を1行ずつ追記します。将来すべてのサイトで活用できるよう、どの教訓を site-starter にコピーバックする価値があるかをユーザーに伝えます。