문서 목차
이 페이지에서목차

Figma 시안 품질 판정 — wireframe-level / needs-polish / shippable

`design-self-check` 는 **규칙을 지켰는지**(L0/L1/L2)를, 이 문서는 **얼마나 마감됐는지**를 가른다. 둘은 다른 질문이라 게이트에 섞지 않는다.

제품 테마 우선: 이 문서의 기본 크기·형태·색·하우스 스타일은 출발점이다. 전체 테마와 component/variant/size/state/slot/instance override를 허용한다. cc-designer:coui-product-style의 references/brand-theme-workflow.md에 기록한 제품 계약으로 판단하며 기본값과 다르다는 이유로 실패 처리하지 않는다.

design-self-check 는 규칙을 지켰는지(L0/L1/L2)를, 이 문서는 얼마나 마감됐는지를 가른다. 둘은 다른 질문이라 게이트에 섞지 않는다. 규칙 통과가 완성을 뜻하지 않으므로 저작의 마지막에 cc-designer:critique-screen 을 돌린다.

§1. 판정#

마감 결정 4영역이 정해졌는지 센다. 기준은 해당 규칙의 확인 항목이고 여기에 다시 적지 않는다. D 는 전 화면의 프레임마다 노드 값으로 센다(D4 만 화면 단위, 크리틱은 §2 의 표본). 대상이 없는 D 는 비음으로 세지 않고 '해당 없음 — D1' 식으로 적는다.

영역정해졌다 =
D1 카드·행 안쪽 figma-composition-patterns.md §C1
D2 면·선§C9
D3 위계§C3
D4 브랜드 방향 선택한 브랜드의 강조 역할 색( primary 역할 — primary-container 틴트 포함, 무채색이면 명도·굵기)이 그 화면의 프레임 어디에든 그려진 선택·현재 위치 표시·주 CTA·핵심 수치 중 한 곳에서라도 비선택 요소와 구분 — 부품 기본 표현을 그대로 두는 선택·현재 위치 표시(§C4)는 그 표현이 강조 역할 색일 때만 대상이다
판정조건
wireframe-levelD 3개 이상 비음
needs-polishD 1–2개 비음, 또는 D 는 충족인데 P1 잔존
shippableD 전부 + 미해결 시각 지적 0 + self-check L0 0

화면 판정 = 그 화면 프레임 중 최저, 전체 = 화면 판정 중 최저(분포를 같이 쓴다). 올려 쓰지 않는다 — wireframe-level 이면 그대로 보고한다. 보고의 판정마다 비어 있는 D 와 남은 P1 이 이름으로 적혀 있어야 하고, 저작으로 고칠 수 있는데 남은 것과 정당화로 남은 것(§2)이 나뉘어 있어야 한다.

§2. 크리틱 — design.md Step 4 항목 2#

  • cc-designer:critique-screen(9렌즈 — 고유성·절제 포함, --quick 금지)을 표본 화면에만 돌린다. 결정 화면(figma-direction.md §D1 ④)은 유형과 상관없이 늘 표본이다 — 먼저 넣고, 상한의 나머지를 아래 유형 표본으로 채운다. 조립 유형(행·카드, 이미지 카드, 표, 달력, 칩 행 등)마다 Default 프레임에서 그 유형의 최외곽 노드 면적 합이 가장 큰 1화면(동률이면 추적표에서 앞선 화면), 최대 4화면(넘으면 면적이 작은 유형부터 다른 유형이 보이는 화면에 합치고 못 담은 유형은 보고에 적는다), 그 화면의 프레임 전부. 표본임을 보고에 쓴다(--frames 증분은 추가·변경한 화면에서 같은 방식으로). 표본 밖 화면의 P1 은 표본에서 P1 이 된 기준을 노드 값에 적용해 세고, 그 화면의 shippable 은 '잠정'으로 적는다.
  • 크리틱은 저작한 에이전트가 아닌 별도 컨텍스트(서브에이전트)가 돌린다. 자기 결과를 자기가 채점하면 판정이 자기 선택을 정당화하는 쪽으로 기운다 — 특히 고유성 렌즈("로고와 색을 지워도 이 서비스인가")는 저작 경위를 아는 쪽이 답할 수 없다. 그래서 크리틱에는 아래 입력만 넘기고 DDR 근거(왜 그렇게 그렸는지)는 넘기지 않는다. 정당화(아래 P1 처리)는 크리틱이 끝난 뒤 저작 쪽이 한다. 별도 리뷰어가 없는 환경에서는 작성자 ID를 그대로 유지한 별도 검토 패스로 수행하고 독립성 한계와 검토 방법을 명시한다. 새 ID를 만들어 독립 검토로 가장하지 않는다. 독립 리뷰와 동등하다고 보고하지 않는다.
  • 입력은 프롬프트에 인라인으로 넘기고 검토한 이미지와 결과는 증거 파일로 보존한다: 스크린샷(get_screenshot) · 브리프(= mood — 결정 정보 줄과 결정 화면 포함) · 선택한 컬렉션의 Light 해석값(= tokens) · self-check 판정표. 결정 정보는 무엇을 그려야 하는지의 기준이라 넘긴다 — 왜 그렇게 그렸는지(유도 경위 · DDR 근거)는 넘기지 않는다. 스펙에 문구 규칙이 없으면 voice 는 건너뛴다. 단 하우스 스타일 서비스(figma-direction.md §D2)는 cc-designer:coui-product-style 의 references/copy.md 를 voice 로, references/mood.md 5절 체크리스트를 mood 기준에 더해 넘긴다(저작 경위가 아니라 기준 문서다). 레버를 덮어쓴 서비스는 덮어쓴 값(밀도 compact 같은)을 mood 기준에 적어 넘긴다 — 크리틱이 덮어쓴 값을 결함으로 읽지 않게 하려는 것이고, 덮어쓴 이유는 넘기지 않는다. 색 판단은 선택한 브랜드와 등록된 override 계약이 기준이다 — 레퍼런스나 다른 브랜드 값으로 채점하지 않는다.
  • 지적은 노드 값으로 확인한 뒤(px·비율 주장은 육안 추정이라 흔들린다) P1/P2/P3(심각도는 critique-screen 의 정의)로 나누고 원인 태그(저작 선택 · 방향 부재 · 부품 한계 · 스펙 불일치)를 붙인다. 부품 한계 태그는 노드로 확인된 것만. 결정 화면에서 결정 정보가 빠졌거나 브리프와 다른 형태로 그려졌다는 지적은 어느 렌즈에서 나왔든 P1 이다 — 크리틱이 P2 · P3 로 매겼어도 올린다(critique-screen 「Prioritise」 와 같은 정의). 다듬기로 두면 그대로 출하되기 때문이다.
  • P1 과 비어 있는 D = 고치거나 정당화한다(정당화해도 잔존으로 센다) — ⓐ 부품 한계: consumption §6·§8 의 기록 + 만료 조건 ⓑ 스펙 문장 인용 ⓒ 노드 값으로 반박. '취향'은 정당화가 아니다. P2/P3도 화면·관찰·수정·재검토 증거를 남긴다. 미해결이면 needs-polish이며 품질 완료로 올리지 않는다. 범위 밖 개선 제안은 별도 목록으로 분리하되 발견된 결함을 제안으로 바꾸지 않는다.
  • 고유 요소 대조(하우스 스타일 서비스, figma-direction.md §D1 ⑤) — 크리틱이 끝난 뒤 저작 쪽이 한다: 고유성 렌즈가 댄 요소 셋과 저작 전에 약속한 셋을 맞춰 본다. 약속한 셋은 크리틱에 넘기지 않는다(저작 경위라 렌즈가 독립으로 답하지 못하게 된다). 약속했는데 렌즈가 대지 못한 요소는 보고의 「고유 요소」 줄에 '그려지지 않음'으로 적고 원인 태그는 '저작 선택'이다 — 고치는 자리는 그 요소를 맡기로 한 화면이다. 렌즈가 약속에 없던 요소를 댔으면 위반이 아니다.
  • 고유성 렌즈의 지적은 원인 태그를 '방향 부재'로 단다 — 고치는 자리는 화면이 아니라 방향과 레버(figma-direction.md §D1 · §D2)다. 지적이 변주안(§D3)에서 고른 구조 자체를 가리키면 버린 안을 다시 본다. 절제 렌즈가 지운 요소가 self-check 11번(슬롭 지문)과 겹치면 그 번호를 적고 다시 세지 않는다.
  • 브랜드 렌즈: 컬렉션 순도는 self-check 결과를 읽는다(다시 세지 않는다). 키워드 3개마다 화면의 결정(색·강조 자리·밀도·이미지 톤) 한 줄 — 못 대면 미반영 P2. 선택 브랜드의 색상군·채도가 브리프와 다르면 사유(brand-selection §5 팔레트 요청)를 쓰고, 색상군이 다르면 '방향 부재'(D4)를 P2(원인 태그: 방향 부재)로 올린다.
  • 재작업은 design-self-check 「재작업 예산」을 쓴다. 심미성을 숫자 점수로 꾸미지 않는다. 규칙으로 검출되지 않는 구성·밀도·고유성 문제도 실제 스크린샷의 관찰과 사용자 작업 영향을 근거로 기록하고 재검토한다.

§3. 구현 충실도는 별도 비교#

L0와 runtime smoke는 시각 충실도 증거가 아니다. Figma와 실제 구현을 같은 viewport, state, theme, locale, fixture/스크롤 위치로 캡처해 나란히 검토한다. 줄바꿈·폰트·아이콘· 정보 순서·주 행동 위치·빈 공간·넘침을 비교하고 차이를 수정한 새 캡처를 남긴다. 표본 밖 화면의 잠정 판정은 전체 품질 완료가 아니다. 전체 화면 Default와 주요 상태·지원 폭을 검토 목록으로 대조하고 미검토/미해결을 명시한다. product-autopilot은 별도 visual_review receipt를 요구한다. 기존 완료 증거는 소급 수정하지 않는다.

검색어를 입력하면 문서를 찾습니다.

↑ ↓ 이동 · Enter 열기Esc 닫기