diversity-scoring

name	diversity-scoring
description	팩 적용 샘플을 baseline과 시각 대조해 다양성 점수를 매기고 합격/반려를 판정하는 방법론 스킬. diversity-qa 에이전트가 사용한다. 5축 채점 루브릭, 정량 보조 지표(perceptual hash·색 히스토그램· 엣지 밀도), 두 종류의 실패 정의, 팩 간 유사도 매트릭스 작성법을 규정한다.

Diversity Scoring — 다양성 채점 방법론

diversity-qa가 팩이 "실제로 baseline과 다른 결과를 내는가"를 판정할 때 따르는 방법.

핵심: 두 종류의 실패를 모두 잡는다

1. 차별성 실패 — 팩 적용본이 baseline과 너무 비슷하다. 팩이 스타일을 충분히 밀어붙이지 못함.
2. 정체성 실패 — baseline과는 다르지만, 팩이 표방한 스타일(meta.yaml의 family·axes)과도 다르다. 엉뚱하게 다름.

합격하려면 baseline과 충분히 다르고 동시에 표방 스타일과 일치해야 한다.

5축 채점 루브릭

baseline.png와 팩 preview.png를 함께 읽고, 각 축을 0~4점으로 채점한다.

축	무엇을 보는가	0점	4점
color	팔레트·대비·강조 운용	baseline과 사실상 동일	표방 스타일대로 또렷이 다름
type	폰트 성격·위계·스케일	동일	또렷이 다름 + 표방 일치
layout	그리드·정렬·구성	동일	또렷이 다름 + 표방 일치
space	밀도·여백 리듬	동일	또렷이 다름 + 표방 일치
shape/motion	보더·모서리·그림자·질감(웹은 모션 단서)	동일	또렷이 다름 + 표방 일치

판정: 총점(0~20). pass = 총점 13 이상 그리고 0점 축 없음. 그 외 reject. 차별성·정체성 어느 쪽이든 0점 축이 있으면 총점과 무관하게 반려.

정량 보조 지표

정성 판정을 보강하되 대체하지 않는다. scripts/에 헬퍼가 있으면 사용하고, 없으면 정성 판정만으로 진행하며 scorecard에 quantitative: unavailable을 표시한다.

• perceptual hash 거리 — baseline과 너무 가까우면 차별성 의심.
• 색 히스토그램 차이 — 팔레트 분포 변화 정량화.
• 엣지/잉크 밀도 — 레이아웃 밀도 차이의 대리 지표. 극단값(거의 동일/완전 무관)일 때 정성 재검토의 플래그로만 쓴다.

반려는 축을 정조준한다

"별로다"가 아니라 재집필 가능한 형태로 쓴다:

reject — color 3 / type 3 / layout 0 / space 2 / shape 1. 레이아웃 축 실패: 그리드·정렬이 baseline과 동일. prompt.md의 "레이아웃" 섹션에 비대칭 그리드를 절대값으로 명시 필요. shape 축 약함: 보더·그림자 지시가 모호.

사유에는 어느 prompt.md 섹션을 어떻게 고쳐야 하는지를 담아 담당 curator가 바로 작업하게 한다.

점진적 검증

전체 완성 후 1회가 아니라, 각 팩(또는 5팩 배치) 렌더 직후 즉시 검증한다 — curator가 빨리 재집필하도록.

팩 간 유사도 매트릭스

개별 팩이 baseline과 다른 것에 더해, 채택 팩끼리도 서로 충분히 달라야 카탈로그의 다양성이 성립한다. 전체 검증 종료 시 트랙별로 팩 간 5축 유사도 매트릭스를 작성해 _workspace/04_qa_diversity-matrix.md에 저장한다. 두 팩이 5축 중 4축 이상 같으면 쌍둥이로 표시하고 pack-architect에 통합·재정의를 권고한다.

산출물

• _workspace/04_qa_scorecard.json — 슬러그별 {axis_scores, total, verdict, reasons[]}.
• _workspace/04_qa_diversity-matrix.md — 팩 간 유사도 매트릭스 + 쌍둥이 권고.

에스컬레이션

같은 팩이 2회 반려 후에도 미달이면 pass로 강제하지 않는다. escalate로 표시해 사람 판단에 맡긴다 — catalog-publisher가 사이트에 draft 배지로 노출한다.