Figma × Widgetbook 정렬 — 레퍼런스#

SKILL.md 의 참조 자료입니다. 레지스트리 컬럼 스키마와 검증 항목 전체를 담습니다.

레지스트리 컬럼#

화면 하나 = 한 행. 파일은 리포에 두고(CSV 또는 그에 준하는 텍스트 포맷), 디자인 파일에는 목차 페이지로 미러링합니다.

자동/사람 구분이 이 표의 생존 조건#

dart_class · usecase_name · platforms · states 를 사람이 적기 시작하면 표가 죽습니다. 클래스 이름 하나만 바뀌어도 표가 거짓말을 시작하고, 거짓말하는 표는 아무도 안 봅니다.

시드 단계에서는 자동 컬럼이 비어 있는 게 정상입니다. 코드 스캔이 채웁니다.

key 는 왜 불변인가#

figma_node 는 섹션을 지웠다 다시 만들면 바뀝니다. dart_class 는 리네임되면 바뀝니다. figma_page 는 도메인 재편으로 옮겨집니다. 모든 컬럼이 변할 수 있으므로, 행을 추적할 불변 축이 하나 필요합니다. 그게 key 입니다. 도메인이 바뀌어도 key 는 두고 domain 만 고칩니다.

검증 항목#

L0 — 결합 (PR 차단)#

결합이 끊긴 것만 여기 둡니다. 이 계층이 붉으면 표를 신뢰할 수 없다는 뜻입니다.

L1 — 축 집합 (경고)#

1:1 이 원리적으로 불가능한 축이므로 집합 포함 관계만 봅니다.

차단으로 올리지 마세요. 도입 초기에 이 검사는 거의 모든 화면에서 걸립니다. 차단하면 팀이 검사를 끕니다. 경고로 두면 같은 정보가 부채 리포트로 남습니다.

L2 — 위생 (주 1회 배치)#

프레임 이름 파싱#

L1 이 성립하려면 프레임 이름이 기계로 읽혀야 합니다.

{플랫폼} · {상태}

• 구분자는 · (공백 + 가운뎃점 + 공백)
• 플랫폼 어휘: Mobile · Tablet · Web
• 상태 어휘: Default · Loading · Empty · Error
• 어휘 밖의 값은 경고로 리포트하고 집합에서 제외 — 조용히 버리면 오탐이 된다

Section: 도서 목록
  Frame: Web · Default      → platforms{Web},    states{Default}
  Frame: Web · Empty        → platforms{Web},    states{Empty}
  Frame: Mobile · Default   → platforms{Mobile}, states{Default}

파싱 결과: platforms = {Web, Mobile}, states = {Default, Empty}. 코드 쪽 states = {Default, Loading, Empty, Error} 이므로 Loading·Error 가 "디자인 미지정" 으로 리포트됩니다.

스캐너가 읽어야 할 것#

좌측(자동) 컬럼 생성기는 @UseCase 어노테이션에서 다음을 뽑습니다.

states 는 본문 파싱이라 취약합니다. dropdown knob 의 options 를 상수로 선언해 두면 파싱이 안정됩니다.

const _stateOptions = ['로딩', '데이터', '빈', '에러'];

도입 시 흔한 실패#