정적 광고 및 그래픽 디자인 에이전트 (static-ad-design-agent)
입력: 브랜드 키트 (MASTER_CONTEXT.md, 웹사이트 URL, 팔레트, 폰트, 로고, 또는 제품 스크린샷) + 오퍼/앵글
출력: 완성된 인스타그램 캐러셀, 정적 이미지 광고(피드, 포트레이트, 스토리, 랜드스케이프), 배너, 썸네일, 결정론적 시각 및 카피 QA (_qa/qa-report.json), 그리고 인터랙티브 시각 리뷰 보드 (review/index.html).
이 스킬은 mrpaidsocial-video-editor-agent의 정적 크리에이티브 제품군입니다. 동일한 문화를 따릅니다: 의도가 아닌 픽셀, 안전 영역, 클레임 준수 여부를 검증합니다.
파이프라인 개요
(0) 인테이크 및 브랜드 토큰 (MASTER_CONTEXT.md + 오퍼/앵글)
│
▼
(1) 앵글 및 아키타입 계획 ──→ ads-manifest.json (변형, 캐러셀, 카피, UTM)
│
▼
(2) 컴포지션 빌드 ───────→ ad-canvas-starter.html 기반 HTML/CSS 또는 Pillow/SVG 아트보드
│
▼
(3) PNG로 래스터라이즈 ────→ 1080x1350 (4:5), 1080x1080 (1:1), 1080x1920 (9:16), 1200x628, 1920x1080
│
▼
(4) 결정론적 QA 루프 ───→ python3 scripts/qa_static_ads.py (픽셀, 안전 영역, 금지 클레임)
│
▼
(5) 인터랙티브 리뷰 보드 → python3 scripts/build_ad_review_board.py → review/index.html
스테이지 0 — 인테이크 및 브랜드 토큰
- 현재 작업 공간 루트에서
MASTER_CONTEXT.md를 확인합니다 (또는MASTER_CONTEXT.template.md에서 복사). - 다음 항목을 추출합니다:
- 브랜드 토큰:
--bg-ink,--bg-paper,--accent-primary,--accent-secondary,--accent-alert, 제목/본문 폰트, 로고, 실제 제품 스크린샷. - 가드레일:
banned_phrases및 표준 어휘 규칙.
- 브랜드 토큰:
- 전달 팩을 확인하거나 기본값으로 설정합니다:
- 캐러셀 팩:
1080×1350(4:5세로 피드 최대 공간) 슬라이드 5-7개. - 정적 광고 3종:
1080×1350(4:5피드),1080×1080(1:1정사각형),1080×1920(9:16스토리/릴 배치). - 배너 / 썸네일:
1200×628(링크/디스플레이 광고) 또는1920×1080(비디오 썸네일).
- 캐러셀 팩:
- 캠페인 작업 폴더를 생성합니다:
outputs/<campaign-slug>/ ├── ads-manifest.json ├── artboards/ ├── renders/ ├── _qa/ └── review/
스테이지 1 — 앵글 및 아키타입 계획 (ads-manifest.json)
카드를 배치하기 전에 references/archetypes-and-safe-zones.md를 읽으십시오. 10가지 검증된 정적 및 캐러셀 아키타입 중에서 선택하십시오:
- 오답 스탬프 신화 파괴자 (스크린샷/클레임에 선명한
WRONG또는MYTH스탬프 → 진실 카드) - 우리 vs. 그들 분할 비교 (2열 대조표: 기존 방식 vs. 브랜드 방식)
- 주석이 달린 제품 UI 증명 (실제 제품 스크린샷 또는 3개의 확대된 콜아웃 알약이 있는 카드)
- 비용/시간 누적 스택 (숨겨진 비용/시간의 누적 영수증 vs. 1개의 깔끔한 솔루션)
- 3단계 메커니즘 다이어그램 (입력 → 엔진 → 결과, 번호가 매겨진 배지 포함)
- 통계 히어로 + 인용 출처 (거대한 지표 콜아웃 + 하단의 축어적 인용 스트립)
- 체크리스트 게이트 카드 ("이 4가지 항목을 확인하기 전에는 지원/시작하지 마십시오")
- 이전/이후 상태 카드 (압도/산란 상태 → 구조화된 로드맵 상태)
- 5-7 슬라이드 내러티브 캐러셀 (슬라이드 1 후크 → 슬라이드 2 자극/데이터 → 슬라이드 3-5 실행 가능한 가치 + 제품 증명 → 슬라이드 6 요약 체크리스트 → 슬라이드 7 CTA)
- 고대비 썸네일 / 배너 (3-5단어 펀치 문구 + 초점 대상/UI + 대비 배지)
scripts/qa_static_ads.py에서 확인하는 스키마에 따라 outputs/<campaign-slug>/ads-manifest.json을 작성하십시오:
{
"campaign_slug": "sa-bursary-deadlines-q4",
"brand_name": "Gradwyn",
"offer_angle": "40개의 PDF에 요구 사항이 묻혀 있어서 남아공 공학 및 컴퓨터 과학 장학금 마감일을 놓치지 마십시오.",
"cta_url": "https://gradwyn.com/?utm_source=meta&utm_medium=paid_social&utm_campaign=sa_bursaries",
"banned_phrases": [
"guaranteed admission",
"guaranteed scholarship",
"chance of getting in",
"admission probability"
],
"brand_palette": ["#0c1a17", "#f6f1e8", "#1a6b5c", "#c4892a", "#c45c4a"],
"creatives": [
{
"id": "carousel-01",
"type": "carousel",
"archetype": "5-slide-narrative-carousel",
"format": "4:5",
"width": 1080,
"height": 1350,
"primary_text": "대부분의 학생은 성적 때문이 아니라 마감일이 지난 지 2주 후에 장학금을 발견하기 때문에 장학금을 놓칩니다.",
"headline": "학생 프로필에 맞는 장학금 확인",
"cta_label": "자세히 알아보기",
"slides": [
{
"slide_index": 1,
"file": "renders/carousel-01-slide-01.png",
"eyebrow": "2027 INTAKE · SOUTH AFRICA & GLOBAL",
"headline": "야망 있는 학생들이 매년 자금 지원을 놓치는 3가지 이유",
"subhead": "그리고 4분 안에 마감일이 추적된 로드맵을 구축하는 방법 →",
"footer_note": "체크리스트를 보려면 스와이프하세요 (1/5)"
}
]
},
{
"id": "static-feed-01",
"type": "static_ad",
"archetype": "us-vs-them-split",
"format": "4:5",
"width": 1080,
"height": 1350,
"file": "renders/static-feed-01.png",
"eyebrow": "UNIVERSITY & SCHOLARSHIP GUIDANCE",
"headline": "40개의 열린 브라우저 탭에서 추측하지 마십시오.",
"subhead": "투명한 적합도 점수와 단계별 로드맵으로 3개의 대학 매치를 받으십시오.",
"primary_text": "Gradwyn은 AI를 사용하여 명확한 이유와 공식 출처로 학생을 대학 및 장학금에 매칭합니다.",
"cta_label": "3개의 매치 받기"
}
]
}
스테이지 2 & 3 — 아트보드 구축 및 PNG로 래스터라이즈
- resources/ad-canvas-starter.html에서 시작하거나 scripts/qa_static_ads.py 내장 렌더러(
--render-from-manifest)를 사용합니다. 이 렌더러는 헤드리스 브라우저 렌더링을 사용할 수 없을 때 Pillow + TrueType 폰트(NotoSerif/NotoSans)를 사용하여ads-manifest.json에서 직접 선명한 출판 등급의1080×1350,1080×1080,1080×1920,1200×628,1920×1080PNG 아트보드를 렌더링할 수 있습니다. - references/archetypes-and-safe-zones.md에 정의된 플랫폼 안전 영역을 준수하십시오:
9:16(1080×1920) 스토리/릴 광고: 모든 텍스트와 로고를y: 250px .. 1520px및x: 72px .. 1008px내에 유지하십시오.4:5(1080×1350) 피드 / 캐러셀: 모든 텍스트를72px외부 패딩(936×1206안전 상자) 내에 유지하고 슬라이드 표시기 배지를 Instagram이1/5카운터를 오버레이하는 오른쪽 상단140×100px모서리에서 멀리하십시오.1:1(1080×1080) 정사각형:64px외부 패딩.
스테이지 4 — 결정론적 시각 및 카피 QA
캠페인 폴더에서 QA 엔진을 실행하십시오:
python3 scripts/qa_static_ads.py --manifest outputs/<campaign-slug>/ads-manifest.json --render-missing
qa_static_ads.py가 모든 에셋에서 확인하는 사항:
- 파일 및 픽셀 무결성: 참조된 모든 PNG가 존재하고, 손상되지 않았으며, 정확히 선언된 픽셀 너비와 높이(
1080×1350,1080×1080,1080×1920,1200×628,1920×1080)와 일치하는지 확인합니다. - 시각적 변형 및 가장자리 여백 확인: 이미지가 비어 있거나 평평하지 않은지 확인하고 안전 영역 가장자리에서 우발적인 텍스트 잘림이 있는지 확인합니다.
- 카피 밀도 및 계층 구조: 즉각적인 모바일 스캔을 위해 캔버스 내 헤드라인 단어/문자 제한(
<= 12 단어)을 적용하고, 기본 텍스트 완성도, CTA 존재 여부를 확인합니다. - 가드레일 및 금지 클레임 게이트: 모든 헤드라인, 부제목, 슬라이드 본문, 기본 캡션을
MASTER_CONTEXT.md의banned_phrases와 대조하여 스캔합니다. 위반 사항이 있으면 정확한 라인 보고서와 함께 QA가 실패합니다. - 시각적 검사:
qa_static_ads.py통과 후 렌더링된 PNG를 시각적으로 검사하여 계층 구조, 대비, 정렬을 확인하십시오.
스테이지 5 — 인터랙티브 시각 리뷰 보드
사람 검토 캔버스를 생성하십시오:
python3 scripts/build_ad_review_board.py --manifest outputs/<campaign-slug>/ads-manifest.json
이 명령은 outputs/<campaign-slug>/review/index.html을 작성하며, 다음을 제공합니다:
- 모든 인스타그램 캐러셀 슬라이드 스트립의 가로 스와이프/스크롤 미리보기.
- 정적 이미지 광고, 스토리 광고, 배너, 썸네일의 전체 그리드.
- 인터랙티브 안전 영역 오버레이 토글 (Meta/IG/TikTok UI 데드 존을 그래픽 위에 직접 표시).
- 에셋별 QA 배지 (
_qa/qa-report.json의 통과 / 경고 / 실패). - 기본 텍스트, 헤드라인, UTM 태그가 있는 CTA URL에 대한 원클릭 복사.
- 승인 / 수정 플래그 토글 및 JSON 수정 노트 내보내기.