ランディングページスキル — 統合契約 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 hero | A(固定ビューポートヒーロー) | B | ムードがプレミアムの場合はフレームキャンバスバリアント |
split hero | A(パターン:分割) | D | 左コピー / 右メディア |
centered statement | Dセクション または A(中央揃え) | — | 低モーション、高可読性 |
benefit rail | Dカード行 | — | 3~4アイテム、アイコン+タイトル+行より重いカードなし |
card grid | Dグリッド | — | 最大6タイル;I3ではホバーモーションを無効化 |
staggered stack | D非対称セクション | B | 画像/テキストの交互行 |
editorial block | Dエディトリアル | F(表示タイプの場合) | 長文形式;カードUIを避ける |
mood gallery | B(スティッキースクロール) または E(スイッチャー) | — | ペースで選択:slow-burn→B、balanced→E |
logo strip | D静かな行 | — | リクエストされた場合を除き、マーキーを超えるモーションなし |
metric band | Dビッグナンバー行 | — | ペースがslow-burnでない場合のみカウントアップアニメーション |
quote panel | D または Aシングルシーン | — | カルーセルよりも単一プルクォート |
accordion list | Dアコーディオン | — | I3では禁止(キルリスト参照) |
CTA band | D中央揃えCTA | A | プライマリCTAはここに配置 |
sticky footer CTA | Dスティッキーフッター | — | ペースがfastの場合のみ |
soft footer | Dミニマルフッター | — | ページ終わりの静かな出口 |
ページあたりのアーキタイプキャップ。
- ページあたり最大 2つのシグネチャアーキタイプ(
cinematic-landing-pageルールから継承)。 - ヒーローセクションが支配的アーキタイプを選択する。計画担当の
handoff_noteで明示的に映画的処理が要求されていない限り、他のセクションはデフォルトでDスタイルの実行になる。
インテントベースのアーキタイプデフォルト(計画担当がヒントを出さなかった場合):
| インテント | 支配的アーキタイプ | 第2アーキタイプ(オプション) |
|---|---|---|
| I1 Launch | A | E |
| I2 Conversion | A(分割) | —(静かに保つ) |
| I3 Brand Editorial | F または B | E |
| I4 Portfolio | F または C | B |
| I5 Product Story | A + B(スクロールストーリー) | — |
| I6 Campaign / Teaser | A または 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つのシグネチャインタラクション |
| high | 1つのシグネチャインタラクション |
| medium | マイクロインタラクションのみ(ホバー、小さなフェード) |
| low | フェードのみ |
| very low | 静的 |
T4. CTAロール → 表面処理。
| CTAロール | 処理 |
|---|---|
| primary | 完全なボタン + フォーム/アンカー、高コントラスト |
| hard | ボタン、高コントラスト、フォームなし |
| soft | 矢印付きテキストリンク |
| none | CTA要素はレンダリングしない |
T5. 感情 → ムードマッピング(助言)。
| primary_emotion(計画担当) | 提案されるムード(構築担当) |
|---|---|
| reverence, calm, luxury | Dark Cinematic / Soft Glass |
| clarity, trust, precision | Light Minimal / Neo-Tech |
| warmth, human, story | Warm Editorial / Light Editorial |
| energy, urgency, hype | Neo-Tech / Dark Cinematic |
T6. ペース → スクロール長。
| ペース | 合計スクロール(デスクトップ) |
|---|---|
| fast | ≤ 2.5 ビューポート |
| balanced | 3~5 ビューポート |
| slow-burn | 5~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つ以上のシグネチャアーキタイプを使用する。
- キルリストを無視する。
primaryCTAを黙って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?"
統合契約の終了。