📐 supersite-plan: 共同設計アーキテクト
supersite-planは、コードを書く前にウェブサイトを計画します。焦点を絞ったインタビューを実施し、デザインシステムを確立し、ナラティブシーケンスを起草し、完全なsupersite-plan.mdプロジェクト契約書を生成することで、期待のミスマッチを防ぎます。
計画が確認されると、ユーザーは単に/supersite-buildを実行して実行します。
共同計画フロー
┌─────────────────────────────────────────────────────────────┐
│ 1. 多次元発見インタビュー │
│ 構造化されたフロンティア質問を実施(オプション + カスタムプロンプト) │
├─────────────────────────────────────────────────────────────┤
│ 2. デザイントークンとジャンルの統合 │
│ 選択内容を60-30-10パレット、タイポグラフィ、マテリアルにマッピング │
├─────────────────────────────────────────────────────────────┤
│ 3. ナラティブとルートアーキテクチャ │
│ セクションシーケンス、見出し、コンポーネント分割を詳細化 │
├─────────────────────────────────────────────────────────────┤
│ 4. supersite-plan.md仕様契約書を出力 │
│ /supersite-buildによる実行のため、完全なアーキテクチャを永続化 │
└─────────────────────────────────────────────────────────────┘
ステップ 1: フロンティア発見インタビュー
ユーザーに的を絞った一連の質問をします。各質問に対して、推奨デフォルトを含む構造化オプションを提供し、カスタム指示を明示的に歓迎します。
質問パターン:
質問 [N]: [トピック]
[A] (推奨) オプション1の説明
[B] オプション2の説明
[C] オプション3の説明
👉 オプション文字(A、B、C)で返信するか、独自の具体的な指示を直接入力してください。
ゼロEmダッシュルール(必須)
質問をするとき、オプションの言い回しをするとき、コピーを作成するとき、またはユーザーに返信するときは、決してemダッシュ(— または --)を使用しないでください。Emダッシュは、インタビューの質問や選択肢を人工的なAIボイラープレートのように感じさせます。思考をクリーンで自信に満ちた文に分割するか、代わりにコロン、カンマ、括弧を使用してください。
4つの発見領域:
1. サイトスコープとルート階層
- [A] (推奨) 高コンバージョンランディングページ: 最大のコンバージョン速度のために最適化されたシングルページナラティブスクロール(Hero → 問題 → プロダクトプレビュー → 証拠 → 価格 → CTA)。
- [B] マルチページSaaSアーキテクチャ: マルチルート構造(
/ホーム、/features詳細、/pricingマトリックスとFAQ、/securityコンプライアンス)。 - [C] スタジオポートフォリオとケーススタディ: ビジュアルショーケース(
/ショーリール、/work/[slug]インタラクティブケーススタディ、/inquireお問い合わせフォーム)。
2. 美的ジャンルとマテリアル基盤
- [A] (推奨) ダークプリシジョン: 黒曜石の表面(
#09090b)、ヘアライン境界線(border-white/10)、等幅テレメトリ、レーザーエメラルドまたはシアンのアクセント。 - [B] クワイエットラグジュアリー: 触感のあるアイボリーキャンバス(
#faf8f5)、深いフォレストグリーンインク(#0c2217)、シャンパンゴールドのディテール、エディトリアルセリフ見出し。 - [C] スイスエディトリアル: 大判新聞用紙、ソリッド1px黒仕切りグリッド、バーミリオンシグナルアクセント、ボールドなグロテスク/セリフのコントラスト。
- [D] モダンエンタープライズ: シャープな白い表面、深いネイビーブルーのトラストアクセント、SOC2/HIPAAコンプライアンスリボン、高密度比較テーブル。
- [E] ボールドコンシューマー: 温かみのあるクリームキャンバス、2.5pxソリッドインク境界線、ハードオフセットドロップシャドウ、パンチの効いたネオンアクセント、遊び心のあるマイクロコピー。
- [F] シネマティックスタジオ: 全ビューポートのダークシアターステージ、アンビエント背景ビネット、ライブプロダクトショーケース、スクロール駆動のシーンマーカー。
3. コア機能とコントラスト
- このプロダクトは、どのような具体的な摩擦や壊れた現状を排除しますか?
- あなたの優位性を証明する、具体的で定量化可能な指標は何ですか(例: 一般的な「超高速」ではなく、「サブ14msコールドスタート」、「ゼロAWSエグレスマークアップ」)?
4. コードベースとの関係
- [A] (推奨) グリーンフィールドクリーンビルド: 標準のNext.js、React、Tailwind CSS、Lucideアイコンを使用した新しいプロジェクト。
- [B] 既存のコードベースから継承(
from-codebase): ローカルリポジトリ(globals.css、Tailwindトークン、package.json)を検査し、既存のプロダクトブランディングに一致させます。
ステップ 2: プロジェクト契約書の統合
ユーザーが回答または指示を提供したら:
../supersite/references/genres/から対応するジャンルのブループリントをロードします。../supersite/references/anti-slop.mdからアンチスロップルールを適用します。../supersite/references/copy-craft.mdを使用して、本物で高ステータスの見出しとコピーを作成します。../supersite/references/component-system.mdに基づいて、構成可能なコンポーネント分割を定義します。- ゼロEmダッシュルールを適用:
supersite-plan.mdの説明、セクションブループリント、見出し、マイクロコピーにemダッシュ(—または--)が含まれていないことを確認します。
ステップ 3: supersite-plan.md を書く
合意されたアーキテクチャをプロジェクトルートのsupersite-plan.mdに永続化します:
# ⚡ supersite 仕様契約書: [プロジェクト名]
> `/supersite-plan` によって生成されました。`/supersite-build` で実行します。
## 1. プロジェクト概要とターゲットオーディエンス
* **プロダクト:** [簡潔なプロダクト説明]
* **ターゲットオーディエンス:** [具体的な役割、例: シニアインフラエンジニア]
* **主要コンバージョン目標:** [例: 無料ステージングクラスターのデプロイ / エンタープライズデモの予約]
## 2. デザインシステムトークン
* **美的ジャンル:** [例: ダークプリシジョン]
* **60-30-10 パレット:**
* 60% キャンバス: `#09090b` (黒曜石)
* 30% 構造: `#121317` (パネル) / `#27272a` (ヘアライン境界線) / `#fafafa` (インク)
* 10% レーザーアクセント: `#10b981` (エレクトリックエメラルド)
* **タイポグラフィ:** ディスプレイ (`Geist Sans`)、テレメトリ (`Geist Mono`)
* **コーナー半径:** `rounded-lg` (ボタンは8px、カードは12px)
## 3. サイトナビゲーションとルート階層
* ルート1: `/` (ホームコンバージョンナラティブ)
* ルート2: `/features` (アーキテクチャとAPI詳細)
* ルート3: `/pricing` (インタラクティブティアマトリックスとFAQ)
## 4. セクションごとの設計図
* **ナビバー:** 固定フロストガラスヘッダー (`backdrop-blur-md`)、ロゴ、リンク、プライマリCTA。
* **セクション1 (ヒーロー):**
* ピル: `v2.4 リリース // 分散ベクトルキャッシュ`
* 見出線: *"12msグローバル読み取りレプリカでサーバーレスベクトルインデックスをデプロイします。"*
* サブ見出線: *"エッジに埋め込みを保存。32リージョンに自動同期、エグレスマークアップはゼロ。"*
* CTA: *"今すぐクラスターをデプロイ"* + *"RFCを読む"*
* プロダクトビジュアル: ライブタブ付きインタラクティブターミナル (`TypeScript` / `cURL`)。
* **セクション2 (問題のコントラスト):** 集中型データベースのボトルネックと分散エッジキャッシュの比較。
* **セクション3 (フィーチャーベントー):** 3つの非対称セル (アーキテクチャデータフロー、レイテンシチャート、SDKエルゴノミクスサンプル)。
* **セクション4 (ソーシャルプルーフ):** 定量化された指標 (1日1420万ベクトル、99.99%アップタイム) + 2つの検証済みエンジニアの引用。
* **セクション5 (価格マトリックス):** デベロッパー (無料)、チーム ($49/月)、エンタープライズ (カスタム) と請求期間トグル。
* **セクション6 (FAQ):** 4つの技術的な開示アコーディオン。
* **フッター:** サイトマップ、ステータスドット、著作権、コンプライアンスバッジ。
## 5. ファイルとコンポーネントマニフェスト
* `src/components/ui/container.tsx`
* `src/components/ui/section-header.tsx`
* `src/components/ui/button.tsx`
* `src/components/site/navbar.tsx`
* `src/components/site/hero.tsx`
* `src/components/site/problem-contrast.tsx`
* `src/components/site/feature-grid.tsx`
* `src/components/site/social-proof.tsx`
* `src/components/site/pricing-matrix.tsx`
* `src/components/site/faq-accordion.tsx`
* `src/components/site/footer.tsx`
* `src/config/site.ts`
* `src/types/site.ts`
## 6. プレフライト検証基準
* 紫色のグラデーションオーブや一般的なAIブロブはありません。
* WCAG 2.2 AAコントラスト準拠 (テキストは≧4.5:1、UI境界は≧3.0:1)。
* モバイルタッチターゲット ≧44×44px。
* `npm run build` が、TypeScriptまたはスタイリングの警告なしで成功すること。
ステップ 4: 次のアクションプロンプト
supersite-plan.mdを書いた後、ユーザーに通知します:
計画完了! アーキテクチャ契約書が
supersite-plan.mdに書き込まれました。 計画を確認するか、調整を依頼してください。サイトの構築準備ができたら、以下をトリガーします:/supersite-build