Communitygithub.com

wuongg/wait_skills

랜딩 페이지 디자인 파이프라인에서 `landing-page-composition-architect` (기획자)와 `cinematic-landing-page` (빌더) 간의 핸드오프 계약을 정의합니다. Blueprint JSON 스키마, 레이아웃 패밀리→시각적 아키타입 매핑, 빌더가 지켜야 할 불변 규칙, 양측이 거부해야 할 실패 모드를 포함합니다. Composition Blueprint가 핸드오프되거나, 빌더가 잠금 상태가 아닌 Blueprint 없이 페이지를 코딩하려 할 때 참조하세요.

wait_skills란 무엇인가요?

이 스킬은 AI 랜딩 페이지 자동 생성 파이프라인에서 '기획자(Planner)' 역할의 `landing-page-composition-architect`와 '빌더(Builder)' 역할의 `cinematic-landing-page` 간의 명확한 역할 분리와 핸드오프를 위한 통합 계약(Integration Contract)을 정의합니다. 기획자는 페이지의 구조(WHAT & ORDER)를 결정하고 JSON 형태의 잠금된 Composition Blueprint를 생성합니다. 빌더는 이 Blueprint를 입력받아 레이아웃 패밀리→시각적 아키타입 매핑 테이블(§3)을 통해 Build Spec을 도출한 후, 실제 코드를 작성하며 표면(Surface)과 움직임(Motion)을 결정합니다. 이 스킬은 양측이 지켜야 할 8가지 번역 규칙(T1-T8), 검증 게이트(§6), 개정 프로토콜(§7), 거부해야 할 실패 모드(§8)를 명확히 제시하여, 빌더가 기획자의 의도를 벗어나거나 잠금 해제된 Blueprint로 코딩하는 오류를 방지하고, AI가 일관된 품질의 랜딩 페이지를 생성할 수 있도록 돕습니다. 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

두 개의 스킬, 하나의 파이프라인:

사용자 요약
   │
   ▼
[ 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 heroA (고정 뷰포트 히어로)B무드 = 프리미엄인 경우 프레임 캔버스 변형
split heroA (패턴: split)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 조용한 행—요청 시 마키(marquee)를 제외한 모션 없음
metric bandD 큰-숫자 행—pace ≠ slow-burn인 경우에만 카운트-업 애니메이션
quote panelD 또는 A 단일 장면—하나의 인용문 > 캐러셀
accordion listD 아코디언—I3에 대해 금지됨 (kill list 참조)
CTA bandD 가운데 정렬 CTAAPrimary CTA가 여기에 있음
sticky footer CTAD 고정 푸터—pace = fast인 경우에만
soft footerD 최소 푸터—페이지 끝 조용한 종료

페이지 당 아키타입 제한.

  • 페이지당 최대 2개의 시그니처 아키타입 (cinematic-landing-page 규칙에서 상속).
  • 히어로 섹션이 지배적인 아키타입을 선택합니다. 다른 섹션은 기획자의 handoff_note가 명시적으로 시네마틱 처리를 요청하지 않는 한 D-스타일 실행을 기본값으로 합니다.

인텐트 기반 아키타입 기본값 (기획자가 힌트를 주지 않았을 때):

인텐트지배적인 아키타입두 번째 아키타입 (선택 사항)
I1 런칭AE
I2 전환A (split)— (조용히 유지)
I3 브랜드 에디토리얼F 또는 BE
I4 포트폴리오F 또는 CB
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개의 시그니처 인터랙션
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 → 에디토리얼 블록 중심; 여전히 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를 무시하는 것.
  • primary CTA를 조용히 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로 표시하겠습니다. 페이지는 여전히 빌드되지만, 리듬 규칙이 깨집니다 — 확인하시겠습니까?"


통합 계약 종료.

Individual skills in this repo

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

관련 스킬