| name | craft-scoring |
| description | "세련됨"이라는 모호어를 렌더 산출물에서 실제로 판정 가능한 항목으로 분해해 채점하는 방법론 스킬. craft-qa 에이전트가 사용한다. 결정적 기계 검사(캔버스 규격·해시 신선도·대비·폰트 로드·그리드 스냅· 여백 토큰·차트 데이터잉크)를 먼저 돌리고, 기계가 못 잡는 광학 정렬·리듬만 시각 검수로 넘긴다. hard fail 항목은 점수와 무관하게 발행을 차단한다. |
Craft Scoring — 세련미의 정량화
"좀 더 세련되게"는 지시가 아니다. craft-qa는 그것을 아래 항목으로 바꿔 판정한다.
순서: 기계 먼저, 눈은 나중
결정적으로 판정 가능한 것에 모델 비용을 쓰지 않는다. A군(스크립트)이 하나라도 실패하면 B군(시각 검수)을 돌리지 않는다.
A군 — 결정적 검사 (스크립트, hard fail)
하나라도 걸리면 즉시 반려. 점수로 상쇄되지 않는다.
| 검사 | 기준 | 실패 예 (실제 관찰) |
|---|
| 캔버스 규격 | 한 팩의 전 페이지가 동일 픽셀 크기, 선언 종횡비 오차 ≤0.5% | ppt-motie 10장 중 5장만 2560×1440, 나머지는 2752×1616·2752×1640·2736×1616 |
| 캔버스 계약 일관성 | prompt.md·tokens.json의 캔버스 선언이 서로, 그리고 실제 렌더와 일치 | ppt-motie가 "16:9"와 "1285×910"(=1.412)을 동치로 병기 |
| 버전 신선도 | prompt.md·tokens.json·meta.yaml의 spec_version 3자 일치 | ppt-motie prompt v4 / meta v4 / tokens v3 |
| 렌더 신선도 | 렌더 매니페스트의 소스 해시 = 현재 prompt.md+tokens.json 해시 | ppt-motie 06-diagram이 명세(딥네이비 호 다이어그램)가 아닌 다른 슬라이드(한국지도) |
| 자기모순 지시 | 같은 대상·같은 속성에 상충 값 0건 | 표지 슬로건이 7686pt / 6080pt / 60~72pt 3중 선언 |
| 금지 자기위반 | "하지 말 것"이 본문 지시와 충돌 0건 | ppt-mcst 카드 본문 14pt 지정 + "24pt 이하 금지" 동시 기재 |
| 폰트 로드 | 선언 폰트 실제 로드 100%, tofu(口) 0건 | 캘리그래피가 일반 산세리프로 조용히 폴백 |
| 텍스트 잘림 | clipping·overflow 0건 | 카드 마지막 행이 컨테이너 밖으로 |
| 대비 | 아래 "대비와 원문 충실도" 절의 역할별 기준 | 밝은 하늘색 지도 위 흰 라벨(≈1.9:1)인데 선언 없음 |
| 차트 데이터 | 값·단위·순서 원본과 100% 일치, 막대 y축 0 시작 | 잘린 축으로 차이 과장 |
| 페이지 ID 정합 | pages/ 파일명·순서·kind가 meta.yaml·catalog.json과 일치 | 05-chart인데 실제로는 다이어그램 |
대비와 원문 충실도 — 역할로 가른다
여기서 규칙이 충돌한다. ppt-design-idioms는 접근성을 원본 이탈이 허용되는 예외 셋 중 하나로 두는데, 실제 레퍼런스 덱은 저대비를 디자인 장치로 의도적으로 쓴다 — 크래프톤의 고스트 목차(비활성 항목 #1A1A1A on 검정, 약 1.2:1)는 활성/비활성 대비 자체가 목차 문법이고, 삼성바이오·포스코·신한도 각각 의도적 저대비 지점이 있다.
"전부 교정한다"도 "전부 그대로 둔다"도 틀렸다. 텍스트의 역할로 가른다.
| 역할 | 기준 | 근거 |
|---|
| 의미 전달 텍스트 — 본문·데이터 라벨·축·표 수치·CTA·유일한 정보원 | 4.5:1 (큰 텍스트 3:1) hard fail | 못 읽으면 정보가 사라진다 |
| 의도적 de-emphasis — 비활성 목차 항목, 장식 배경 워터마크, 같은 정보가 다른 곳에 온전히 존재하는 중복 요소 | 하한 없음. 단 선언 필수 | 낮은 대비 자체가 전달하는 의미(비활성)가 있다 |
저대비를 유지하려면 팩이 선언해야 한다. transform_contract에 다음을 남기지 않은 저대비는 예외가 아니라 결함이다:
{ "element_id": "toc-inactive", "action": "preserve",
"role": "decorative-deemphasis",
"contrast": { "measured": "1.2:1", "below_aa": true },
"justification": "활성/비활성 대비가 목차 문법. 같은 정보가 활성 상태로 다른 페이지에 존재",
"accessibility_note": "이 팩 사용 시 해당 요소에 정보를 의존하지 말 것" }
craft-qa는 선언되지 않은 4.5:1 미만 텍스트를 hard fail로 처리하고, 선언된 것은 역할이 실제로 de-emphasis인지만 확인한다(본문을 de-emphasis로 위장하는 것을 막는다).
B군 — 시각 검수 (0~4점 × 6항, 24점)
기계가 못 잡는 것만. 렌더를 직접 보고 채점한다.
| 항목 | 무엇을 보는가 | 4점 | 0점 |
|---|
| C1 그리드 스냅 | 주요 요소 엣지가 선언 그리드에 붙는가 | 95% 이상이 2px 이내 | 3-up 카드가 제각각 높이 |
| C2 광학 정렬 | 수학적 중앙이 아니라 시각적 중앙 | 아이콘·글자 광학 보정됨 | 재생 삼각형이 원 안에서 가라앉음 |
| C3 한글 줄바꿈 | 단어·어절 중간 파단 0건, widow 없음 | 어절 단위로 끊김 | "메모리 반 / 도체", "디스 / 플레이" |
| C4 여백 리듬 | 반복 gap·padding이 토큰 배수인가 | 변동계수 ≤10% | 카드 padding이 24/31/44px 혼재 |
| C5 밀도 균형 | 의미 요소 점유율이 선언 space 축과 맞는가 | airy 3065% / balanced 5080% / dense 70~90% | 중앙 하단 25%가 데드 보이드 |
| C6 데이터잉크 | 차트에서 (의미 마크 + 직접 레이블) / 전체 요소 | ≥0.70, 격자선 ≤3 | 범례·격자·배경이 데이터보다 진함 |
C3은 한국어 팩의 최대 취약점이다. 영문 기준 줄바꿈 로직이 한글 어절을 무시하고 끊는다. word-break: keep-all과 어절 단위 검사를 기본으로 둔다.
합격 조건
A군 hard fail = 0
AND B군 총점 ≥ 19 / 24
AND 전 항목 ≥ 2
검사 입력
PNG만 보고 판정하지 않는다. 가능한 경우 구조 데이터를 함께 읽는다.
- 웹 트랙 — 렌더 시 DOM computed style을 덤프해 대비·폰트·여백을 실측
- PPT 트랙 — 네이티브
.pptx 생성 시 도형 좌표·폰트 목록을 XML에서 실측, 슬라이드 밖 객체 0건 확인
- 어느 쪽도 불가하면
structural_check: unavailable을 명시하고 A군 일부를 unverified로 둔다 — pass로 올리지 않는다
산출물
_workspace/{batch}/craft_qa/{slug}.json
{ "slug": "...", "hard_fails": [],
"checks_A": { "canvas_uniform": "pass", "version_sync": "pass",
"render_fresh": "pass", "contrast": "pass", "fonts": "pass" },
"scores_B": { "C1": 4, "C2": 3, "C3": 4, "C4": 3, "C5": 3, "C6": 4 }
하지 말 것
- A군을 눈으로 때우는 것. 종횡비·해시·대비는 재는 것이지 보는 것이 아니다.
- "전반적으로 깔끔함" 같은 총평. 항목별 점수와 실패 좌표를 써라.
- 시간·한도 부족을 통과 사유로 쓰는 것.
needs_review가 정직한 답이다.
