Communitygithub.com

wuongg/wait_skills

ランディングページ構成アーキテクト(計画担当)と映画的ランディングページ(構築担当)間の引き継ぎ契約。Blueprint JSONスキーマ、レイアウトファミリー→ビジュアルアーキタイプのマッピング、構築担当が守るべき不変条件、双方が拒否すべき障害モードを定義します。

wait_skills とは?

このスキルは、AIエージェントワークフローにおいて「計画担当」と「構築担当」という2つの専門スキル間の明確な引き継ぎ契約を定めたものです。計画担当(landing-page-composition-architect)はユーザーの概要からComposition Blueprint(JSON形式)を生成し、構築担当(cinematic-landing-page)はそのBlueprintに基づいて実際のコードを書きます。このスキルは、Blueprintの構造(セクション順序・数・レイアウトファミリーなど)と構築担当の裁量(映画的なアーキタイプ・モーション・カラームード・技術スタックなど)の境界を厳密に定義しています。また、レイアウトファミリーからビジュアルアーキタイプへの変換テーブル、モーション予算ルール、検証ゲート、リビジョンプロトコル、双方が拒否すべき障害モードを網羅しており、Claude CodeやCursor、CodexなどのAIエージェント環境で、計画と構築のフェーズを分離した高品質なランディングページ生成パイプラインを実現します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wuongg/wait_skills/tree/HEAD/.cursor/skills/landing-page-skills-integration

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

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

ドキュメント

ランディングページスキル — 統合契約 v1

2つのスキル、1つのパイプライン:

ユーザー概要
   │
   ▼
[ ランディングページ構成アーキテクト ]   ← WHAT(何を)とORDER(順序)を決定
   │  出力: Composition Blueprint(ロック済み)
   ▼
[ INTEGRATION.md  ← このファイル ]      ← Blueprintをビルド仕様に変換
   │  出力: ビルド仕様(アーキタイプ + モーション + スタック)
   ▼
[ 映画的ランディングページ ]             ← HOW IT LOOKS & MOVES(見た目と動き)を決定、コードを記述
   │
   ▼
出荷されたページ

黄金律。 計画担当は構造を所有する。構築担当は表面を所有する。 どちらも線を越えてはならない。このファイルが両者の誠実さを保つ。


1. 引き継ぎ成果物 — Composition Blueprint(JSON)

計画担当の最終成果物は、たとえユーザーにテーブルとして提示された場合でも、このJSONとしてレンダリング可能でなければなりません。構築担当はこのJSONをそのまま読み取ります。

{
  "blueprint_version": "1.0",
  "page": {
    "intent": "I1 | I2 | I3 | I4 | I5 | I6",
    "intent_name": "Launch | Conversion | Brand | Portfolio | Product Story | Campaign",
    "awareness": "cold | warm | hot",
    "traffic": "ads | organic | social | referral | direct",
    "narrative_spine": "Hook -> Value -> Proof -> CTA",
    "pace": "fast | balanced | slow-burn",
    "density": "minimal | balanced | rich",
    "primary_emotion": "string (one word)",
    "total_sections": 5
  },
  "sections": [
    {
      "index": 1,
      "slot": "S1",
      "name": "Hero",
      "jtbd": "grab attention + set tone",
      "why_here": "first impression",
      "layout_family": "full-bleed hero",
      "content_required": ["headline", "subcopy", "hero_media"],
      "visual_weight": "very high",
      "cta_role": "soft"
    }
  ],
  "rhythm_rules": [
    "No two 'very high' weight sections adjacent.",
    "After any full-bleed hero or mood gallery, next must be centered statement or editorial block.",
    "Primary CTA appears exactly once."
  ],
  "kill_list": [
    "No FAQ",
    "No 6-card feature grid",
    "No metric band"
  ],
  "handoff_note": "One paragraph: emotion to preserve, which slots want cinematic treatment, which stay quiet.",
  "locked": true
}

不変条件。

  • sections.length ∈ [4, 9];標準的なインテントでは5~8。
  • すべての slot ∈ {S1..S16}、ページ内で一意。
  • layout_family ∈ 閉じたリスト(§3参照)。
  • locked: true は約束:構築担当はセクションの並び替え、追加、削除、名前変更を行ってはならない。

2. 構築担当が決定できること(およびできないこと)

構築担当が決定できること

  • 映画的アーキタイプ(cinematic-landing-page の A/B/C/D/E/F)。
  • モーションシグネチャ、イージングカーブ、スクロール動作。
  • カラームード、タイポグラフィ、スペーシングスケール。
  • メディア処理(グレイン、ブラー、フレーミング、切り抜き)。
  • 技術スタック(V1 vanilla 対 V2 React+Vite+Tailwind)。
  • マイクロコピーの洗練(意図を維持する限り)。

構築担当が決定できないこと

  • セクション数。
  • セクションの順序。
  • どのスロットがどの位置にマッピングされるか。
  • セクションが存在するかどうか。
  • スロットの目的の名前変更(ユーザー向けの名前は変更可;JTBDは変更不可)。
  • Blueprintにないセクションの追加(サプライズCTAバナー、サプライズニュースレターブロックは禁止)。
  • プライマリCTAの削除または複製。

Blueprintが間違っていると構築担当が感じた場合、黙って変更するのではなく停止して再計画を要求しなければなりません。


3. レイアウトファミリー → ビジュアルアーキタイプマッピング

計画担当はレイアウトファミリーで語る。構築担当は映画的アーキタイプ(A~F)で語る。これが変換表です。

レイアウトファミリー(計画担当)プライマリアーキタイプ(構築担当)フォールバック備考
full-bleed heroA(固定ビューポートヒーロー)Bムードがプレミアムの場合はフレームキャンバスバリアント
split heroA(パターン:分割)D左コピー / 右メディア
centered statementDセクション または A(中央揃え)—低モーション、高可読性
benefit railDカード行—3~4アイテム、アイコン+タイトル+行より重いカードなし
card gridDグリッド—最大6タイル;I3ではホバーモーションを無効化
staggered stackD非対称セクションB画像/テキストの交互行
editorial blockDエディトリアルF(表示タイプの場合)長文形式;カードUIを避ける
mood galleryB(スティッキースクロール) または E(スイッチャー)—ペースで選択:slow-burn→B、balanced→E
logo stripD静かな行—リクエストされた場合を除き、マーキーを超えるモーションなし
metric bandDビッグナンバー行—ペースがslow-burnでない場合のみカウントアップアニメーション
quote panelD または Aシングルシーン—カルーセルよりも単一プルクォート
accordion listDアコーディオン—I3では禁止(キルリスト参照)
CTA bandD中央揃えCTAAプライマリCTAはここに配置
sticky footer CTADスティッキーフッター—ペースがfastの場合のみ
soft footerDミニマルフッター—ページ終わりの静かな出口

ページあたりのアーキタイプキャップ。

  • ページあたり最大 2つのシグネチャアーキタイプ(cinematic-landing-page ルールから継承)。
  • ヒーローセクションが支配的アーキタイプを選択する。計画担当の handoff_note で明示的に映画的処理が要求されていない限り、他のセクションはデフォルトでDスタイルの実行になる。

インテントベースのアーキタイプデフォルト(計画担当がヒントを出さなかった場合):

インテント支配的アーキタイプ第2アーキタイプ(オプション)
I1 LaunchAE
I2 ConversionA(分割)—(静かに保つ)
I3 Brand EditorialF または BE
I4 PortfolioF または CB
I5 Product StoryA + B(スクロールストーリー)—
I6 Campaign / TeaserA または F—

4. ビルド仕様 — コード記述前に構築担当が出力する成果物

コードを1行も書く前に、構築担当はBlueprintから派生したビルド仕様を生成しなければなりません。これがパイプラインにおける2番目の契約です。

{
  "build_spec_version": "1.0",
  "blueprint_ref": "locked",
  "stack": "V1 vanilla | V2 react-vite-tailwind",
  "dominant_archetype": "A | B | C | D | E | F",
  "second_archetype": "A | B | C | D | E | F | null",
  "mood": "Dark Cinematic | Warm Editorial | Neo-Tech | Light Minimal | Light Editorial | Soft Glass",
  "sections": [
    {
      "index": 1,
      "slot": "S1",
      "layout_family": "full-bleed hero",
      "archetype": "A",
      "pattern": "framed-canvas",
      "motion": ["hero_fade_in_800ms", "subcopy_delay_200ms"],
      "media": {"type": "image | video | none", "asset_ref": "…"},
      "notes": "このスロットにこのアーキタイプが選ばれた理由"
    }
  ],
  "acceptance_criteria": [
    "First viewport = S1 composition only.",
    "Primary CTA in S15 exactly once.",
    "No adjacent 'very high' weight sections.",
    "Motion count on page <= 2 signatures."
  ]
}

構築担当はコードを書く前に、ビルド仕様をBlueprintに対して検証します(§6参照)。失敗した場合は閉じる。


5. 変換ルール(計画担当 → 構築担当)

順序に従って適用されます。

T1. セクション順序は絶対。 Blueprint内の sections[i].index がページ上の位置。 構築担当は決して並び替えない。

T2. スロット → アーキタイプの適格性。 §3の表を使用する。プライマリアーキタイプがすでにヒーロー用に選択された支配的アーキタイプと競合するレイアウトファミリーが現れた場合は、フォールバックを使用する。

T3. 重み → モーション予算。

ビジュアルウェイトモーション予算
very high最大2つのシグネチャインタラクション
high1つのシグネチャインタラクション
mediumマイクロインタラクションのみ(ホバー、小さなフェード)
lowフェードのみ
very low静的

T4. CTAロール → 表面処理。

CTAロール処理
primary完全なボタン + フォーム/アンカー、高コントラスト
hardボタン、高コントラスト、フォームなし
soft矢印付きテキストリンク
noneCTA要素はレンダリングしない

T5. 感情 → ムードマッピング(助言)。

primary_emotion(計画担当)提案されるムード(構築担当)
reverence, calm, luxuryDark Cinematic / Soft Glass
clarity, trust, precisionLight Minimal / Neo-Tech
warmth, human, storyWarm Editorial / Light Editorial
energy, urgency, hypeNeo-Tech / Dark Cinematic

T6. ペース → スクロール長。

ペース合計スクロール(デスクトップ)
fast≤ 2.5 ビューポート
balanced3~5 ビューポート
slow-burn5~8 ビューポート

T7. 密度 → コンポーネント選択。

  • minimal → タイプのみのセクション、広い余白を優先。
  • balanced → タイプとメディアの混合。
  • rich → エディトリアルブロック重視;それでもキルリストは尊重する。

T8. キルリストは絶対。 kill_list 内のものはすべて、たとえ「かっこよく見える」場合でも、ビルド仕様とコードで禁止されます。


6. 検証ゲート(コードを書く前に実行)

構築担当はこのチェックリストをビルド仕様に対して実行します。すべて合格しなければなりません。

  • すべてのBlueprintセクションが build_spec.sections に1行だけ存在する。
  • index の値は連続しており、1から始まる。
  • セクションが追加、削除、並び替え、またはマージされていない。
  • 各行の layout_family がBlueprintと一致する。
  • 支配的アーキタイプがヒーロー(index: 1)によって使用されている。
  • ページ上のシグネチャアーキタイプの合計 ≤ 2。
  • セクション全体での「シグネチャインタラクション」の合計 ≤ 2。
  • プライマリCTAの数 = 1(または、インテントがI3でソフトフッタークローズの場合のみ0)。
  • kill_list の項目が仕様に存在しない。
  • アウェアネスゲートが尊重されている:cold ⇒ S1の直後にS2が存在する。
  • 禁止された隣接関係がない(S6+S9、S11+S13など)。

失敗 → revision_request(§7参照)を計画担当に返す。失敗したゲートを回避してコードを書いてはならない。


7. リビジョンプロトコル

構築担当が差し戻す必要がある場合、自由なテキストではなく構造化されたリクエストを出力します:

{
  "revision_request": {
    "reason": "layout_conflict | asset_missing | motion_budget_exceeded | kill_list_impossible | adjacency_violation",
    "affected_sections": [3, 4],
    "explanation": "1つの短い段落",
    "suggested_fix": "S6とS9の順序を入れ替える | S13を削除する | S1の重みをhighにダウングレードする"
  }
}

計画担当はパッチノートではなく、新しいロック済みBlueprintで応答します。 Blueprintは blueprint_version をバンプすることで全体が再発行されます。


8. 双方が拒否しなければならない障害モード

計画担当は以下を拒否しなければなりません:

  • ロックされていないBlueprintを出力する。
  • 4未満または9を超えるセクションを出力する。
  • ユーザーが提供できない content_required を持つスロットを含める。
  • スロットIDを再利用する。
  • S1または(通常は)S15をスキップする。
  • §3の閉じたリスト外のレイアウトファミリーを選択する。

構築担当は以下を拒否しなければなりません:

  • ロックされたBlueprintなしでコードを書く。
  • §6に合格したビルド仕様なしでコードを書く。
  • 「ページが空っぽに感じられたから」という理由でセクションを追加する。
  • 「冗長に感じられたから」という理由でセクションを削除する。
  • 2つ以上のシグネチャアーキタイプを使用する。
  • キルリストを無視する。
  • primary CTAを黙って soft にダウングレードする。

ユーザーが直接違反を要求した場合、一度だけトレードオフを説明して応答し、ユーザーが明示的に確認した場合のみ従い、影響を受ける行のビルド仕様に "user_override": true として記録する。


9. 最小限のエンドツーエンド例

Blueprint(計画担当出力、要約)

  • インテント: I2 Conversion、cold、ads、balanced pace、balanced density。
  • セクション: S1 → S2 → S4 → S5 → S6 → S12 → S13 → S15
  • キルリスト: S8なし、S9なし、S14なし、S11なし。
  • プライマリ感情: clarity。

ビルド仕様(構築担当出力、要約)

  • スタック: V2(React + Vite + Tailwind + framer-motion)。
  • 支配的アーキタイプ: A(分割ヒーロー)。第2アーキタイプ: なし。
  • ムード: Light Minimal。
  • 使用モーション予算: 2 / 2(ヒーロー分割リビール + メトリックカウントアップ)。
  • S1 = A分割ヒーロー。S2 = D中央揃えステートメント。S4 = Dエディトリアルブロック。 S5 = D千鳥スタック。S6 = Dカードグリッド(4タイル)。S12 = Dメトリックバンド。 S13 = Dクォートパネル(単一プルクォート)。S15 = Dフォーム付きCTAバンド。
  • 受理条件: プライマリCTAは1回(S15);S6/S9の隣接なし;合計スクロール ≈ 4ビューポート。

検証

§6のすべてのチェックが合格。構築担当はコード作成に進む。


10. ユーザーに伝えること(スクリプトスニペット)

計画担当からの引き継ぎ時:

"Blueprint đã khóa. Chuyển sang skill build (cinematic-landing-page)? Skill đó sẽ chọn archetype visual + motion + code, không đổi thứ tự section."

構築担当がBlueprintを拒否する場合:

"Blueprint này có xung đột ở section {n} — {lý do}. Mình gửi lại planner để phát hành bản mới, thay vì tự sửa."

ユーザーがオーバーライドを強要する場合:

"Nếu ép làm vậy, mình sẽ đánh dấu user_override: true ở section đó. Trang vẫn build được, nhưng rhythm rule bị phá — bạn xác nhận?"


統合契約の終了。

Individual skills in this repo

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

関連スキル