Communitygithub.com

supersite-plan

AIコーディングエージェント向けの共同ウェブサイト設計ツール。フロンティア質問とカスタム指示で構造化インタビューを実施し、サイトのナラティブと美学を設計、完全なsupersite-plan.md仕様を出力します。

supersite-plan とは?

supersite-planは、AIエージェント(Claude Code、Cursor、Codexなど)のために設計された、コードを書く前にウェブサイト全体を計画するスキルです。このスキルは、構造化されたフロンティアインタビューを通じてクライアントの期待を明確にし、デザインシステムの確立、ナラティブシーケンスの草案作成、そして完全なプロジェクト契約書である`supersite-plan.md`の生成を行います。ユーザーは、サイトのスコープ、美的ジャンル、コア機能、既存コードベースとの関係について選択肢から選ぶか、カスタム指示を提供できます。最終的に生成される計画ファイルには、デザイントークン、ルート階層、セクションごとの設計図、コンポーネント一覧、検証基準が含まれており、続けて`/supersite-build`コマンドを実行することで、その計画に基づいた実際のコード生成を開始できます。このスキルは、AIが生成するボイラープレート感を排除するために「ゼロemダッシュルール」を強制し、人間らしい、高品質な出力を保証します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/developer-mohanaditya/supersite/tree/HEAD/skills/supersite-plan

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

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

ドキュメント

📐 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: プロジェクト契約書の統合

ユーザーが回答または指示を提供したら:

  1. ../supersite/references/genres/から対応するジャンルのブループリントをロードします。
  2. ../supersite/references/anti-slop.mdからアンチスロップルールを適用します。
  3. ../supersite/references/copy-craft.mdを使用して、本物で高ステータスの見出しとコピーを作成します。
  4. ../supersite/references/component-system.mdに基づいて、構成可能なコンポーネント分割を定義します。
  5. ゼロ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

Individual skills in this repo

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

関連スキル