| name | diversity-scoring |
| description | 팩 적용 샘플을 baseline과 시각 대조해 다양성 점수를 매기고 합격/반려를 판정하는 방법론 스킬. diversity-qa 에이전트가 사용한다. 5축 채점 루브릭, 정량 보조 지표(perceptual hash·색 히스토그램· 엣지 밀도), 두 종류의 실패 정의, 팩 간 유사도 매트릭스 작성법을 규정한다. |
Diversity Scoring — 다양성 채점 방법론
diversity-qa가 팩이 "실제로 baseline과 다른 결과를 내는가"를 판정할 때 따르는 방법.
핵심: 두 종류의 실패를 모두 잡는다
- 차별성 실패 — 팩 적용본이 baseline과 너무 비슷하다. 팩이 스타일을 충분히 밀어붙이지 못함.
- 정체성 실패 — 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 배지로 노출한다.
