🔨 supersite-build: 外科手術的ビルダー
supersite-build は /supersite-plan で確立されたアーキテクチャ計画を実行します。supersite-plan.md を読み取り、アトミックコンポーネントを構築し、デザイントークンとコピーを配線し、ビルドエンジンに対して実装を検証します。
実行パイプライン
┌─────────────────────────────────────────────────────────────┐
│ 1. 仕様契約の読み取りと検証 │
│ supersite-plan.md からトークン、ルート、マニフェストを解析 │
├─────────────────────────────────────────────────────────────┤
│ 2. スキャフォールディング、型定義と設定 │
│ src/types/site.ts、src/config/site.ts とベースCSSを作成 │
├─────────────────────────────────────────────────────────────┤
│ 3. UIプリミティブの構築 │
│ Container、SectionHeader、Button、Badge、Card │
├─────────────────────────────────────────────────────────────┤
│ 4. セクションブロックの構築 │
│ Navbar、Hero、Contrast、Features、Proof、Pricing、Footer │
├─────────────────────────────────────────────────────────────┤
│ 5. ルートの組み立てとビルドの検証 │
│ ページの配線、アクセシビリティのチェック、npm run buildの実行 │
└─────────────────────────────────────────────────────────────┘
ステップ1: supersite-plan.md の読み取りと検証
- ワークスペースルートに
supersite-plan.mdがあるか確認します。- 存在しない場合、処理を中断しユーザーに以下のように通知します:
"プロジェクトルートに
supersite-plan.mdが見つかりません。/supersite-planを実行して計画を共同で設計するか、/supersite <prompt>を実行して直接生成してください。"
- 存在しない場合、処理を中断しユーザーに以下のように通知します:
- 計画から以下のアーキテクチャパラメータを解析します:
- 美的ジャンルとカラーパレット(Hex/OKLCH、60-30-10分布)。
- タイポグラフィと角丸の選択。
- ルートとコンポーネントのマニフェスト。
- セクションのコピー、見出し、インタラクティブ要素。
ステップ2: スキャフォールディング、型定義と設定
- 依存関係の確認:
- 標準ユーティリティ(
lucide-react、clsx、tailwind-merge)が存在することを確認します。不足している場合はインストールします:npm install lucide-react clsx tailwind-merge
- 標準ユーティリティ(
- TypeScript契約の生成(
src/types/site.ts):NavItem、FeatureItem、PricingPlan、Testimonial、FAQItemの型を定義します。
- 集中設定の生成(
src/config/site.ts):- ナビゲーションリンク、ブランドメタデータ、構造化されたセクションコンテンツを1箇所に保存します。
- ベースCSSの更新(
src/app/globals.css):- カラー変数、選択スタイル、
prefers-reduced-motionアクセシビリティブロックを注入します:@layer base { ::selection { background-color: var(--accent); color: var(--accent-foreground); } } @media (prefers-reduced-motion: reduce) { *, ::before, ::after { animation-duration: 0.01ms !important; animation-iteration-count: 1 !important; transition-duration: 0.01ms !important; scroll-behavior: auto !important; } }
- カラー変数、選択スタイル、
ステップ3: UIプリミティブの構築(src/components/ui/)
モジュール式のプリミティブを生成します:
container.tsx: レスポンシブパディング付きの最大幅コンテナ(max-w-6xlまたはmax-w-7xl)。section-header.tsx: 標準化されたバッジ、タイトル、説明ブロック。button.tsx: バリアント駆動のボタン(primary、secondary、outline、ghost)。明示的な:focus-visibleスタイルを含む。badge.tsx: 細いヘアラインボーダーのピル形状およびステータスチップ。card.tsx: 計画のサーフェスカラー、ボーダー、角丸トークンを適用するサーフェスラッパー。
ステップ4: セクションブロックの構築(src/components/site/)
計画で指定された各セクションを構築します:
navbar.tsx: デスクトップナビゲーションリンク、アクションCTA、モバイルハンバーガードロワーを備えたレスポンシブヘッダー。hero.tsx: フックピル、H1タイトル、リードパラグラフ、CTAクラスター、インタラクティブなプロダクトプレビュー(例:ターミナルまたはUIフレーム)。problem-contrast.tsx: 現状の課題とモダンなソリューションを対比する非対称なビジュアルコントラスト。feature-grid.tsx: 非対称のbentoグリッドまたはモジュール式機能セル。繰り返しの3カードコピーはありません。product-showcase.tsx: インタラクティブコンポーネント(タブ付きコードエクスプローラー、ライブインタラクティブプレビュー、設定プレイグラウンド)。social-proof.tsx: 検証可能なメトリクスの呼びかけと、特定のエンジニアリング職種を含む顧客の推薦文。pricing-matrix.tsx: 月額/年額請求トグル("use client"使用)、ティアカード、機能チェックリスト、チェックアウトCTA。faq-accordion.tsx: スムーズなCSSグリッドの高さトランジションを使用した、展開可能な技術Q&A。footer.tsx: 複数列のナビゲーションリンク、法的アンカー、システムステータスドット、著作権表示。
ステップ5: ルートの組み立てとビルドの検証
src/app/page.tsxの組み立て:- セクションコンポーネントをインポートし、クリーンで宣言的なJSXでナラティブレイアウトを構成します。
- 追加ルートの組み立て:
- 計画でマルチページルート(
/features、/pricing、/security)が指定されている場合、対応するpage.tsxファイルを構築します。
- 計画でマルチページルート(
- プレフライトアンチスロップ監査の実行:
- 禁止スタイルのチェック:パープルのグラデーションブロブ、根拠のないカード、汎用的なプレースホルダーコピーがないことを確認。
- タッチターゲットのチェック:インタラクティブなヒットエリアが 44×44px 以上であることを確認。
- emダッシュのチェック:すべてのUIコピー、見出し、マイクロコピー、ボタンラベルに emダッシュ(
—または--)がゼロであることを確認。
- コンパイルとビルドゲート:
- ワークスペースのビルドコマンドを実行します:
npm run build - TypeScriptエラーやインポート漏れがある場合、即座に修正し、クリーンにコード0でビルドが通るまで再実行します。
- ワークスペースのビルドコマンドを実行します:
- ユーザーへの報告:
- すべての会話応答および進捗報告において、ゼロemダッシュルール(
—または--を決して使用しない)を徹底します。代わりにピリオド、コロン、カンマ、括弧を使用します。 - 構築したファイルのクリーンな要約をクリック可能なリンクとともに提供します:
[supersite-plan.md](file:///path/to/supersite-plan.md)[page.tsx](file:///path/to/src/app/page.tsx)src/components/site/内の個別コンポーネントリンク
- コンパイル成功を確認します。
- すべての会話応答および進捗報告において、ゼロemダッシュルール(