---
title: "🧭 260629 — UI 프레임 재건: 다중검수 시스템 + 방법론 교훈집"
category: "reference"
parent: "Claude Code 작업보고"
document_type: "참조"
source_status: "generated"
knowledge_group: "02_specs"
priority: "Medium"
purpose: "0~3단계 내내 작동한 다중검수 시스템(CC 자가검수 + Codex 코드정합 + GPT·Cai 외부검수 + 사장님 육안)의 구조와, 작업 중 박제된 재사용 가능한 방법론 교훈(독성 주석·camelCase 누락·캡처규약·worktree 보호·측정단위 등). 시즌오프 후에도 UI/기능 개선 시 반복 참조할 자산."
read_when: ["다중검수 시스템","Codex 협업","GPT Cai 검수","검수 4분류","독성 CSS 주석","camelCase 누락","캡처규약","worktree 보호","측정 단위 교훈"]
updated: "2026-06-29"
work_timestamp: "20260629_113000"
context: "달록본레포CC (D:\\dallog\\dallog_git) — UI 프레임 재건 대작업(0~3단계). 진본 SOT: 본레포 docs/ui_rebuild/. KB는 작업보고 버전."
source_of_truth: "https://dallog-tools.hansbridge.co.kr/knowledge/"
---
> 0~3단계 누적. 상위 SOT = 본레포 `docs/ui_rebuild/_15_PHASE3_ROLLOUT_REVIEW_PROTOCOL.md`(검수 규약 레퍼런스)·`_99`(전 항목). 본 문서는 다중검수 시스템 + 방법론 교훈의 KB 참조본(시즌 무관 재사용 자산).

## 0. 결론 요약
- UI 재건의 신뢰성은 **단일 작업자 판단이 아니라 다중 독립 검수의 교차**에서 나왔다. CC가 틀려도 Codex/GPT/Cai/사장님 중 누군가 잡도록 설계.
- 검수 의견은 **작업의 입력값**으로 취급하고 **4분류**([즉시반영]/[검토후반영]/[보류]/[반려])로 처리, 미반영은 사유 기록.
- 방법론 교훈은 일회성이 아니라 **재발방지 가드·규약·메모리로 박제**됨(테스트·캡처규약·게이트 문서).

## 1. 다중검수 시스템 구조
| 검수자 | 역할 | 강점 |
|---|---|---|
| **CC(자가검수)** | 1차 자기집계·layer2 생산 | 로컬 전체 컨텍스트 |
| **Codex(Cdx)** | 코드정합 실측·사후/재검수 | 라이너가 못 보는 코드 직접검증(diff↔자기보고·정규식 사각) |
| **GPT** | 외부 논리·문서 정합 | 종료조건·숫자정합 엄격 |
| **Cai** | 외부 멀티모달(스크린샷 PDF) | 시각·서술 정직성 |
| **사장님** | 최종 육안 | 실사용 관점·결정권 |
- **예민할수록 2회+ 검수-반영-재검수.** 검수는 작업 입력값. 완료보고에 "Codex 검토 반영 결과" 섹션 필수.
- **증거 무게중심**: 보이는 작업=스크린샷 주력 / 안 보이는 리팩터=diff·소스·기계카운트 주력·스샷은 시각불변 보조.
- **증거팩(컴바인팩)**: 스샷 전수(360·768·1024·1440·1920 × 다크/라이트 × before/after) + diff + self_report + layer2. 발행시각 네이밍·핸드오프 워딩 금지.

## 2. 박제된 방법론 교훈 (재사용)
- **독성 CSS 주석**: 주석 내 `*/`·`-*/` 글롭이 주석을 조기종료 → 뒤 규칙 폐기 → 침묵 레이아웃 붕괴. **"목업 그대로 이식"으로 못 고침**(범인=주석). → 영구 가드 `cssCommentSanity.test.ts`(전수 스캔 0건 = 유일했음).
- **camelCase 방향속성 누락**: 검증 정규식이 `margin:`/`padding:` 축약형만 잡고 `marginBottom` 등 누락 → "잔존 0" 오보고. Codex 적발. → 정규식에 camelCase 포함 + 가드 `spacingTokenGuard.test.ts`.
- **캡처규약**: canvas 차트는 fullPage 캡처 시 세로눌림 아티팩트(라이브는 정상). → 데이터 로딩+1~2초 대기·canvas fullPage 금지·큰 뷰포트+viewport 캡처·모바일 폭변화 redraw.
- **worktree/미커밋 보호**: 스샷 before/after 전 `git stash -u`(checkout이 미커밋 src 되돌림). `core.autocrlf=true`로 줄끝차이 `M` = "손실" 단정 금지. `git add -A` 금지(경로 지정).
- **측정 단위 = 페이지 → 컴포넌트 트리 합산**(얇은 wrapper 페이지의 inline 0에 속지 말 것).
- **포렌식 교훈**: 파일 추출 필터는 substring 말고 정확매칭(ConsentHistory.tsx 오염 사례).

## 3. 작업 거버넌스 원칙 (헌법 §0 계열)
- **반축소(§0.5)**: 통일이 기본, 원본 보존·예외는 좁은 적극 입증만(입증책임=예외 두려는 쪽).
- **AI 효율논리 차단(§0.4)**: 사람 기준 효율("일회성·부담큼·나중에")을 작업축소 근거로 못 씀. "보고는 하되 핑계로 작업을 닫지 마라."
- **자가 예외판단 엄금**: 규칙 자가축소 금지, 사장님 명시 승인 예외만 유효.
- **과대·과소경보 둘 다 금지**: 증명 후 단정.

## 4. 다음
- 본 시스템·교훈은 시즌오프 후 UI/기능/UX 신설 시 그대로 재사용. `_15`가 그 레퍼런스 원본(루트 보존).