랜딩 페이지 스킬 — 통합 계약 v1
두 개의 스킬, 하나의 파이프라인:
사용자 요약
│
▼
[ landing-page-composition-architect ] ← WHAT & ORDER 결정
│ 출력: Composition Blueprint (잠금 상태)
▼
[ INTEGRATION.md ← 이 파일 ] ← Blueprint → Build Spec 변환
│ 출력: Build Spec (아키타입 + 모션 + 스택)
▼
[ cinematic-landing-page ] ← HOW IT LOOKS & MOVES 결정, 코드 작성
│
▼
배포된 페이지
황금률. 기획자는 구조를 소유합니다. 빌더는 표면을 소유합니다. 어느 쪽도 선을 넘을 수 없습니다. 이 파일은 양측이 정직을 유지하도록 돕습니다.
1. 핸드오프 아티팩트 — Composition Blueprint (JSON)
기획자의 최종 아티팩트는 반드시 이 JSON으로 렌더링 가능해야 하며, 사용자에게 표로 제시되었더라도 마찬가지입니다. 빌더는 이 JSON을 그대로 읽습니다.
{
"blueprint_version": "1.0",
"page": {
"intent": "I1 | I2 | I3 | I4 | I5 | I6",
"intent_name": "런칭 | 전환 | 브랜드 | 포트폴리오 | 제품 스토리 | 캠페인",
"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 (한 단어)",
"total_sections": 5
},
"sections": [
{
"index": 1,
"slot": "S1",
"name": "Hero",
"jtbd": "주의를 끌고 분위기를 설정",
"why_here": "첫인상",
"layout_family": "full-bleed hero",
"content_required": ["headline", "subcopy", "hero_media"],
"visual_weight": "very high",
"cta_role": "soft"
}
],
"rhythm_rules": [
"'very high' 가중치 섹션 두 개가 인접할 수 없음.",
"full-bleed hero 또는 mood gallery 후에는 반드시 centered statement 또는 editorial block이 와야 함.",
"Primary CTA는 정확히 한 번만 등장."
],
"kill_list": [
"FAQ 없음",
"6-카드 기능 그리드 없음",
"메트릭 밴드 없음"
],
"handoff_note": "한 단락: 보존할 감정, 시네마틱 처리가 필요한 슬롯, 조용히 유지할 슬롯.",
"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 vs V2 React+Vite+Tailwind).
- 마이크로카피 다듬기 (인텐트를 유지하는 한).
빌더가 결정할 수 없음
- 섹션 수.
- 섹션 순서.
- 어떤 슬롯이 어떤 위치에 매핑되는지.
- 섹션이 존재하는지 여부.
- 슬롯의 목적 이름 바꾸기 (사용자에게 보이는 이름은 변경 가능, JTBD는 변경 불가).
- Blueprint에 없는 섹션 추가 (갑작스러운 CTA 배너, 갑작스러운 뉴스레터 블록 없음).
- Primary CTA 제거 또는 중복.
빌더가 Blueprint가 잘못되었다고 느끼면, 조용히 변경하지 말고 중단하고 재계획을 요청해야 합니다.
3. 레이아웃 패밀리 → 시각적 아키타입 매핑
기획자는 레이아웃 패밀리로 말합니다. 빌더는 시네마틱 아키타입(A–F)으로 말합니다. 다음은 변환 테이블입니다.
| 레이아웃 패밀리 (기획자) | 기본 아키타입 (빌더) | 대체 | 참고 |
|---|---|---|---|
full-bleed hero | A (고정 뷰포트 히어로) | B | 무드 = 프리미엄인 경우 프레임 캔버스 변형 |
split hero | A (패턴: split) | 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 조용한 행 | — | 요청 시 마키(marquee)를 제외한 모션 없음 |
metric band | D 큰-숫자 행 | — | pace ≠ slow-burn인 경우에만 카운트-업 애니메이션 |
quote panel | D 또는 A 단일 장면 | — | 하나의 인용문 > 캐러셀 |
accordion list | D 아코디언 | — | I3에 대해 금지됨 (kill list 참조) |
CTA band | D 가운데 정렬 CTA | A | Primary CTA가 여기에 있음 |
sticky footer CTA | D 고정 푸터 | — | pace = fast인 경우에만 |
soft footer | D 최소 푸터 | — | 페이지 끝 조용한 종료 |
페이지 당 아키타입 제한.
- 페이지당 최대 2개의 시그니처 아키타입 (
cinematic-landing-page규칙에서 상속). - 히어로 섹션이 지배적인 아키타입을 선택합니다. 다른 섹션은 기획자의
handoff_note가 명시적으로 시네마틱 처리를 요청하지 않는 한 D-스타일 실행을 기본값으로 합니다.
인텐트 기반 아키타입 기본값 (기획자가 힌트를 주지 않았을 때):
| 인텐트 | 지배적인 아키타입 | 두 번째 아키타입 (선택 사항) |
|---|---|---|
| I1 런칭 | A | E |
| I2 전환 | A (split) | — (조용히 유지) |
| I3 브랜드 에디토리얼 | F 또는 B | E |
| I4 포트폴리오 | F 또는 C | B |
| I5 제품 스토리 | A + B (스크롤 스토리) | — |
| I6 캠페인 / 티저 | A 또는 F | — |
4. BUILD SPEC — 빌더가 코딩 전에 내보내는 아티팩트
한 줄의 코드를 작성하기 전에, 빌더는 반드시 Blueprint에서 파생된 Build Spec을 생성해야 합니다. 이것이 파이프라인의 두 번째 계약입니다.
{
"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": [
"첫 번째 뷰포트 = S1 구성만.",
"S15에 Primary CTA가 정확히 한 번.",
"'very high' 가중치 섹션 인접 없음.",
"페이지 모션 개수 <= 2개의 시그니처."
]
}
빌더는 코딩 전에 Build Spec을 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 → 에디토리얼 블록 중심; 여전히 kill list 준수.
T8. Kill list는 절대적입니다. kill_list에 있는 모든 것은 Build Spec과 코드에서 금지되며, "멋져 보인다"고 해도 예외가 아닙니다.
6. 검증 게이트 (코드 작성 전에 실행)
빌더는 Build Spec에 대해 이 체크리스트를 실행합니다. 모두 통과해야 합니다.
- 모든 Blueprint 섹션에
build_spec.sections에 정확히 하나의 행이 있습니다. -
index값은 1부터 시작하여 연속적입니다. - 추가, 제거, 재정렬 또는 병합된 섹션이 없습니다.
- 행당
layout_family가 Blueprint와 일치합니다. - 지배적인 아키타입이 히어로(
index: 1)에 사용됩니다. - 페이지의 총 시그니처 아키타입 ≤ 2.
- 섹션 전체의 "시그니처 인터랙션" 합계 ≤ 2.
- Primary CTA 개수 = 1 (또는 인텐트가 I3이고 soft-footer 종료인 경우 0).
-
kill_list의 항목이 사양에 없습니다. - 인지도 게이트 준수: cold ⇒ S2가 S1 바로 뒤에 존재합니다.
- 금지된 인접 조합 없음 (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": "짧은 단락 하나",
"suggested_fix": "S6과 S9 순서를 바꿈 | S13을 삭제함 | S1 가중치를 high로 낮춤"
}
}
기획자는 패치 노트가 아닌 새로운 잠금 Blueprint로 응답합니다. Blueprint는 blueprint_version 범프로 버전 관리되어 전체적으로 재발행됩니다.
8. 양측이 거부해야 할 실패 모드
기획자는 다음을 거부해야 합니다:
- 잠금 해제된 Blueprint를 내보내는 것.
- 4개 미만 또는 9개 초과의 섹션을 내보내는 것.
- 사용자가 제공할 수 없는
content_required가 있는 슬롯을 포함시키는 것. - 슬롯 ID를 재사용하는 것.
- S1 또는 (일반적으로) S15를 건너뛰는 것.
- §3의 폐쇄 목록 외부의 레이아웃 패밀리를 선택하는 것.
빌더는 다음을 거부해야 합니다:
- 잠금 상태가 아닌 Blueprint로 코딩하는 것.
- §6을 통과하지 못한 Build Spec 없이 코딩하는 것.
- "페이지가 텅 빈 느낌이라서" 섹션을 추가하는 것.
- "중복된다고 느껴져서" 섹션을 삭제하는 것.
- 2개 이상의 시그니처 아키타입을 사용하는 것.
- kill list를 무시하는 것.
primaryCTA를 조용히soft로 다운그레이드하는 것.
사용자가 직접 위반을 요청하면, 트레이드오프를 한 번 응답한 후 명시적으로 확인하는 경우에만 준수하고 — 영향을 받는 행에 "user_override": true로 Build Spec에 기록합니다.
9. 최소 종단간 예제
Blueprint (기획자 출력, 요약)
- 인텐트: I2 전환, cold, ads, balanced 페이스, balanced 밀도.
- 섹션:
S1 → S2 → S4 → S5 → S6 → S12 → S13 → S15 - Kill list: S8 없음, S9 없음, S14 없음, S11 없음.
- 기본 감정: clarity.
Build Spec (빌더 출력, 요약)
- 스택: V2 (React + Vite + Tailwind + framer-motion).
- 지배적인 아키타입: A (split hero). 두 번째 아키타입: 없음.
- 분위기: Light Minimal.
- 사용된 모션 예산: 2 / 2 (히어로 split reveal + 메트릭 count-up).
- S1 = A split hero. S2 = D centered statement. S4 = D editorial block. S5 = D staggered stack. S6 = D card grid (4 타일). S12 = D metric band. S13 = D quote panel (단일 pull-quote). S15 = D CTA band with form.
- 승인 기준: primary CTA 한 번 (S15); S6/S9 인접 없음; 총 스크롤 ≈ 4 뷰포트.
검증
모든 §6 검사가 통과되었습니다. 빌더가 코딩을 진행합니다.
10. 사용자에게 말할 내용 (스크립트 스니펫)
기획자로부터 핸드오프할 때:
"Blueprint가 잠겼습니다. 빌드 스킬(
cinematic-landing-page)로 전환할까요? 해당 스킬이 시각적 아키타입 + 모션 + 코드를 선택하며, 섹션 순서는 변경하지 않습니다."
빌더가 Blueprint를 거부할 때:
"이 Blueprint는 섹션 {n}에서 충돌이 있습니다 — {이유}. 자체적으로 수정하는 대신 기획자에게 새 버전을 요청하도록 하겠습니다."
사용자가 재정의를 강요할 때:
"강제로 진행하시려면, 해당 섹션에
user_override: true로 표시하겠습니다. 페이지는 여전히 빌드되지만, 리듬 규칙이 깨집니다 — 확인하시겠습니까?"
통합 계약 종료.