/cc-blueprint:build — Figma 시안에서 화면 코드까지 (데이터레이어 없이)

/cc-blueprint:build --frames "{섹션}[,{섹션}...]" --app {path} [--feature {name}] [--surface {surface}]

1. 레지스트리 대조 — --frames 의 각 섹션이 화면 레지스트리에 등재돼 있는가
   (미등재 프레임은 정본이 아니다 — rules/figma-workflow.md §1). 미등재 → 그 섹션 SKIPPED
   + "/cc-blueprint:design 으로 등재 후 재실행" 안내.
2. (권장) skills/design-self-check 를 입력 프레임에 적용 — L0 프레임은 구현 입력으로 받지
   않는다(시안 결함을 코드로 복제하는 것을 막는다). L0 발견 시 그 섹션 SKIPPED-BLOCKED
   (blockedBy 시안 재작업). 단 L0 가 3번(토큰 단일 출처)의 **리터럴 색뿐**인 프레임은 받는다 —
   코드는 토큰으로 칠하고 리터럴 덧대기는 Step 5 의 대조가 막으므로 그 결함이 코드로 복제되지
   않는다. 그 프레임의 다른 밝기 대조만 5번 · Step 5 에서 판정 불가로 남아 디자이너에게 간다.
3. 브랜드 테마 + 컴포넌트 스타일 → 앱 적용
   - 브랜드 manifest의 source/revision, 외부 alias, 상속 override, mode와 타입/단위를 해석한다.
     같은 snapshot의 JSON/Dart/CSS를 쓰고 전체 테마뿐 아니라 component/variant/size/state/slot/instance
     override도 실제 resolver에 매핑한다. 토큰 상수 생성은 런타임 적용 완료가 아니다.
   - 현재 API가 없는 속성은 adapter/API 확장 gap으로 기록하고 구현 범위 안에서 해결한다.
     아래 frame-modes 출력만으로 전체 테마를 읽었다고 판단하지 않는다.
   프레임 모드 → 앱 인자 — references/recipes/frame-modes.figma.js 를 섹션의 화면 프레임
   전부에 돌린다(페이지마다 한 번). 반환 app 의 brand · surfaceStyle · density 가 앱 루트
   CoUIApp 의 인자다(cc-flutter:figma-to-coui 「Figma → CoUI 번역 명세」 F5).
   - app 이 null(blocking — 고정한 값이 프레임마다 다르다 · 이름을 읽지 못했다) → 그 섹션
     SKIPPED-BLOCKED (blockedBy 시안 결함 · 디자이너 확인). 앱이 한 벌인 값을 화면마다 고르지 않는다.
   - warnings(색 모드를 고정하지 않은 프레임) → 진행하되 보고에 싣는다 — 그 프레임은 다크
     확인에서 따라오지 않는다.
   - 브랜드 → 앱 테마 모듈의 CoreBrand(id 또는 displayName 이 brand 와 같은 것). 없으면
     SKIPPED-BLOCKED (blockedBy 브랜드 정의 — demo-brand-theme 또는 제품의 테마 모듈).
     시안의 hex 로 시드를 짐작하지 않는다.
   - 레버 DDR(rules/figma-direction.md §D2)의 브랜드 속성도 옮긴다 — 서체 역할은
     ThemeData(typography: CoreTypography.coui.withFamily(…)), 라이브러리가 모드로 싣지 않은
     형태 · 재질 · 테마 밀도는 그 값의 CoUIApp 인자.
   - 앱 루트의 CoUIApp 이 이 값과 다르면 화면 모듈에서 고치지 않고 보고한다 — 앱 전체의
     값이라 어느 쪽이 맞는지는 디자이너 · 앱 소유자가 정한다.
4. 제품 컴포넌트 판정 — 섹션이 라이브러리 밖 컴포넌트(제품이 이름 붙인 것)를 쓰면, 시안 파일의
   컴포넌트 ↔ CoUI 비교 시트를 references/recipes/compare-sheet.figma.js 로 읽는다(시트마다 한 번).
   컴포넌트마다 판정 · CoUI 대응 · 조립 부품을 찾아 cc-flutter:figma-to-coui F8 의 행동으로 옮긴다.
   - issues 가 비어 있지 않으면 그 표를 쓰지 않는다 — 해당 컴포넌트는 판정 없음으로 다루고 보고한다.
   - 판정 없음(시트에 없다 · 시트가 없다) → 판정을 쓰지 않는다. 디자이너에게 요청하고 임시 경로로 진행 — 차단 아님.
   - 판정이 요구한 CoUI API 가 앱의 CoUI 릴리스에 아직 없으면(F9 의 버전 표시) 들어오기 전 경로 + 만료 조건.
5. 대조 입력 · 서체 · CoUI 판 — Step 5 의 Figma 대조를 지금 준비한다(cc-pixel-loop:visual-verify §2 · §7).
   references/recipes/compare-frames.figma.js 를 섹션마다 돌려 반환을 frames-<섹션>.json 에 저장하고,
   figma_compare.py plan · fonts · coui 를 돌린다(실행 폴더 .claude/docs/visual-verify/<run_id>/).
   - coui = 앱이 해석한 CoUI 릴리스(.dart_tool/package_config.json · pubspec.lock) 와 라이브러리 사이에서
     달라진 컴포넌트. **버전 판단은 이 값으로 한다** — 4번의 「앱의 CoUI 릴리스」, F9 의 버전 표시,
     「아직 없는 CoUI API」 모두. 스킬 저장소의 기준(coui_skills_basis)은 앱의 판이 아니다.
     drift 의 컴포넌트에서 나는 차이는 Step 5 에서 `version` 으로 판정될 자리다 — 화면 코드로 맞추지 않는다.
   - fonts 실패(시안의 서체가 앱 · 의존 패키지에 선언되지 않았다 · 테스트가 로드하지 않는다) → 진행하고,
     Step 4 에서 서체를 번들 · 로드한다. 그 전의 대조는 판정 불가다(다른 서체로 떨어진 렌더는 비교할 수 없다).
   - plan 의 원천이 unthemable(시안 색이 변수에 묶이지 않음 — design-self-check 3번 토큰 단일 출처 L0) →
     진행 + 보고. 그 밝기의 대조는 판정 불가로 남아 디자이너에게 간다. 앱 코드로 다크를 짐작해 맞추지 않는다.
   - 이름이 「플랫폼-상태」 가 아닌 프레임은 비교 목록에 들지 않고 요약을 판정 불가로 만든다 — 옛 파일이면 레시피의 NAMES,
     섹션 안의 화면이 아닌 프레임(메모 류)이면 plan 의 --ignore-frame '<id>=<이유>', 아니면 디자이너에게 이름을 요청.

feature/{location}/{feature_name}/
├── domain/
│   ├── entity/            # 화면이 소비하는 Entity (시안에서 추출한 필드)
│   └── repository/        # ⭐ 계약 인터페이스만 — 구현체 없음
├── presentation/
│   ├── bloc/              # BlocSignal — UseCase 대신 repository 계약을 직접 주입받지 않고
│   │                      #   도메인 UseCase 를 거친다 (cc-flutter:package-layers 준수)
│   ├── page/              # Page 는 BLoC 을 this.bloc 선택 주입으로 받는다 (widgetbook mock 가림 방지)
│   └── widget/
├── mock/                  # ⭐ mock repository 구현 + 시나리오 데이터 (Default/Loading/Empty/Error)
│   └── {feature}_mock_repository.dart
└── {feature}_widgetbook.dart 등 use_case  # feature 소유 (widgetbook-conventions)

□ 데이터레이어 0 — data/ 디렉토리·Repository 구현·API client·DB 코드 부재 (grep 검사)
□ 계약 + mock — domain/repository 인터페이스 존재 · mock/ 이 DI 1곳에서만 바인딩
□ use_case 등재 — 섹션마다 1건, 상태 Knob 동작 (Page 자체 BLoC 생성 없음)
□ 골든 스냅샷 — 상태 4종 × 대표 뷰포트 존재, flutter test 통과
□ Figma 대조 — 등록된 상태 프레임마다 라이트 · 다크로 cc-pixel-loop:visual-verify 의 summary 가 pass
  (프레임 크기 · 배율 · textScaler 1.0 · 서체 확인 후). 판정 불가 · 실패는 통과가 아니다 —
  밝기 제외는 이유와 함께만(plan --exclude-theme), 면제는 version · known 만(근거를 스크립트가 다시 확인)
□ 시각 다듬기 — cc-flutter:figma-to-coui 「시각 다듬기 체크리스트」 P1–P8(숫자 자리 · 아이콘 세트 · 한국어
  줄바꿈 · 모션 별칭 · 차트 색 · 다크 · 글꼴 번들 · 큰 컨트롤). 대조가 pass 여도 남는 자리다

## 🧩 구현 결과 — {feature}
| 섹션 | 모듈 경로 | use_case | 골든 | Figma 대조 | 체크리스트 |
|------|-----------|----------|------|------------|------------|
| 상품 목록 | feature/application/store/... | ✅ | 4/4 | pass 8/8 (면제 1) | PASS |
### 앱 인자: 브랜드 {Brand} · surfaceStyle {…} · density {…} (frame-modes) · 경고 {n} · 앱 루트와 차이 {없음|목록}
### 제품 컴포넌트: 시트 판정 {n} · 판정 없음 {n}(디자이너 요청 {링크}) · 아직 없는 CoUI API {n}(임시 경로 · 만료 조건) (compare-sheet)
### Figma 대조: {summary.md 첫 줄} · 앱의 CoUI {패키지 버전 · 커밋} · 라이브러리와 달라진 컴포넌트 {n} · 면제 version {n} · known {n} · 판정 불가 {사유} · 리터럴 예외 {n}
{summary.md 의 표 — PR 본문에 그대로}
### mock 시나리오: {n}종 · bricks 흡수 지점: DI {파일}:{줄}
### 다음 단계: /cc-blueprint:sync (Figma↔Widgetbook 대조) · 데이터레이어: cc-bricks / cc-serverpod