TheMattBerman/landing-page-factory

페이지 빌드

빌드 품질은 전략적 충실성보다 먼저가 아니라, 그 이후에 옵니다.

이 단계는 신뢰와 전환에 중요한 요소를 보존하면서 페이지를 조립합니다.

필수 입력

1. workspace/pages/[page-name]/strategy.json
2. workspace/brand/profile.md
3. workspace/brand/palette.json
4. workspace/pages/[page-name]/copy.md
5. workspace/pages/[page-name]/visuals/
6. references/anti-slop.md (이 스킬에 번들됨)

전략이 없으면 중단합니다.

workspace/pages/[page-name]/visuals/manifest.json이 존재하면, 이를 표준 머신-리더블 비주얼 소스로 사용합니다. 신뢰, 충실도, 폴백 이력에 영향을 미칠 때에는 제공자 메타데이터를 무시하지 마십시오.

보존 계층 구조

다음 순서로 적용합니다:

1. 신뢰에 중요한 카테고리 관습을 보존합니다.
2. 메커니즘 커뮤니케이션 요구사항을 보존합니다.
3. 브랜드 시각적 아이덴티티를 보존합니다.
4. 레이아웃 리듬과 상호작용 품질을 개선합니다.
5. 1~4를 왜곡하지 않는 범위에서만 안티-슬롭 취향 개선을 적용합니다.

안티-슬롭은 품질 필터이지, 재설계 라이선스가 아닙니다.

빌드 전 체크리스트

HTML을 생성하기 전에 다음을 확인합니다:

• 페이지 유형 확인됨
• 전환 메커니즘 확인됨
• 증명 인벤토리 로드됨
• 신뢰 신호 선택됨
• 비주얼 매니페스트가 빌드 가능한 이미지 경로로 해석됨
• 필수 카테고리 관습 보존됨
• CTA 대상 알려짐
• 레이아웃 선택이 한 줄로 정당화됨

어느 하나라도 거짓이면 중단하거나 등급을 낮춥니다.

라우팅 로직

물리적 제품 경로

전략 페이지 유형이 product-led일 때 사용합니다.

접힌 부분 위에는 다음이 포함되어야 합니다:

• 명확한 제품 또는 메커니즘 비주얼
• 오퍼 헤드라인
• CTA
• 신뢰 신호

SaaS / 앱 경로

접힌 부분 위에는 다음이 포함되어야 합니다:

• 필요 시 보존된 스크린샷 또는 UI 처리
• 결과 헤드라인
• 신뢰 신호
• CTA

리드 캡처 경로

접힌 부분 위에는 다음 중 하나가 포함되어야 합니다:

• 양식 + 마찰 감소 요소
• 또는 알려진 대상으로의 명확한 CTA

권위 / 서비스 경로

다음이 포함되어야 합니다:

• 접힌 부분 위에 권위 신호
• 초기 증명 섹션
• 신뢰와 적합성에 대한 이의 제기 처리

규제 대상 경로

다음이 포함되어야 합니다:

• 증명이 부분적일 때 확신 수준 낮춤
• 메타데이터의 규정 준수 검토 플래그

디자인 규칙

• 단일 HTML 파일
• 최소 768px 및 1024px 중단점에 대한 반응형
• 시맨틱 HTML
• 보이는 포커스 상태
• 모든 이미지에 대체 텍스트
• 요청되지 않은 이상 빌더 속성 없음
• 소스 신뢰 신호를 재정의하는 임포트된 취향 패턴 없음

안티-슬롭 사용법

references/anti-slop.md를 로드하고 보존 계층 구조 이후, 그 전이 아닌 시점에 적용합니다.

포스트빌드 QA 테이블

workspace/pages/[page-name]/qa.md에 작성하고 meta.json에 요약합니다:

확인 항목	통과?	비고
접힌 부분 위에 메커니즘 표시됨
접힌 부분 위에 기본 증명 표시됨
접힌 부분 위에 CTA 있음
접힌 부분 위에 신뢰 신호 있음
허위 증명 없음
금지된 슬롭 패턴 없음
모바일 축약 확인됨
대비 확인됨
대체 텍스트 있음
카테고리 관습 보존됨

메타데이터 계약

meta.json에는 다음이 포함되어야 합니다:

• brand
• page
• page_type
• mechanism_type
• template_route
• CTA_destination
• proof_items 및 출처 요약
• risk_reversal_present
• compliance_flags
• review_flags
• preserved_elements
• deviations_from_source
• images_used
• sections_present
• build_confidence

비주얼 매니페스트가 존재하는 경우, 다음도 포함합니다:

• hero_image
• image_provider_policy
• images_used는 단순 파일 이름이 아닌 구조화된 객체로
• 검토 또는 QA와 관련된 경우 제공자 및 폴백 컨텍스트

빌드 도우미

scripts/resolve-visual-assets.py --page-name [page-name]를 사용하여 visuals/manifest.json을 HTML 및 meta.json용 빌드 가능한 이미지 메타데이터로 변환합니다.

그런 다음 scripts/prepare-build-meta.py --page-name [page-name] --resolved-assets [file]을 사용하여 해당 해석된 에셋을 결정론적 선택 필드와 함께 meta.json에 병합합니다:

• hero_image
• mechanism_image
• lifestyle_image
• og_image
• image_slots.hero
• image_slots.mechanism
• image_slots.lifestyle
• image_slots.og

그런 다음 skills/page-build/scripts/html-image-context.py --meta workspace/pages/[page-name]/meta.json을 사용하여 다음과 같은 리터럴 HTML 준비 값을 내보냅니다:

• hero_img_src
• hero_img_alt
• mechanism_img_src
• mechanism_img_alt
• lifestyle_img_src
• lifestyle_img_alt
• og_image_path

최소 실행 가능 빌더:

• skills/page-build/scripts/build-page.py --page-name [page-name] 이 스크립트는 strategy.json, meta.json, html-image-context.json을 사용하고 실제 index.html 스캐폴드를 작성합니다.

스킬 로컬 스크립트를 Cowork 또는 스킬 폴더만 업로드하는 모든 에이전트 런타임의 기본 인터페이스로 사용하십시오. 레포-루트 /scripts 복사본은 로컬 개발 편의를 위한 것이며, 패키징 요구사항이 아닙니다.

평가 참조

채점 기준 및 통과 임계값은 skills/page-qa/references/eval-rubric.md를 참조하십시오. 안티-슬롭 패턴은 references/anti-slop.md(이 스킬에 번들됨)를 참조하십시오.

중단 / 계속 로직

다음의 경우 중단합니다:

• 리드 액션 페이지의 CTA 대상이 알려지지 않은 경우
• 페이지가 누락된 증명에 의존하는 경우
• 필요한 신뢰 신호를 지원할 수 없는 경우

다음의 경우 등급을 낮추고 계속합니다:

• 비주얼 에셋이 부분적이지만 중립 지원 레이아웃이 여전히 작동하는 경우
• 증명이 부족하지만 페이지가 더 부드러운 주장으로 재구성된 경우

출력

다음을 작성합니다:

• workspace/pages/[page-name]/index.html
• workspace/pages/[page-name]/meta.json
• workspace/pages/[page-name]/qa.md

QA 출력이 없는 빌드는 불완전합니다.