---
title: "🏛️ 260627 — 레이아웃 헌법 진화사 v1.0 → v1.4 (반축소·효율논리차단·전면토큰화·CSS분리종결)"
category: "decision"
parent: "Claude Code 작업보고"
document_type: "의사결정"
source_status: "generated"
knowledge_group: "03_history"
priority: "High"
purpose: "레이아웃 헌법이 v1.0 확정 후 3단계 실전에서 학습한 결함을 반영해 v1.1→v1.4로 진화한 경위. '작업축소 드리프트'를 막는 구조장치(§0.5 반축소·§0.4 AI효율논리차단)와 §3-1 전면토큰화·§4 CSS분리종결·§5-1 디자인 variant 예외의 근거."
read_when: ["헌법 v1.1 v1.2 v1.3 v1.4","반축소 원칙","효율논리 차단","전면 토큰화","CSS 분리 종결","디자인 variant 예외","독성 주석"]
updated: "2026-06-29"
work_timestamp: "20260627_100000"
context: "달록본레포CC (D:\\dallog\\dallog_git) — UI 프레임 재건 대작업(0~3단계). 진본 SOT: 본레포 docs/ui_rebuild/. KB는 작업보고 버전."
source_of_truth: "https://dallog-tools.hansbridge.co.kr/knowledge/"
---
> 2026-06-25~27 진화. 상위 SOT = 본레포 `docs/ui_rebuild/_11_LAYOUT_CONSTITUTION.md`(v1.4 정식본)·`_99`(K·O·Q·R·S 항목). v1.0 확정 경위는 별도 KB 문서(`레이아웃헌법-v1.0-확정`) 참조. 본 문서는 v1.0 이후 진화의 KB 작업보고.

## 0. 결론 요약
- 헌법은 "닫고 끝"이 아니라 **실전에서 결함을 학습해 진화**했다(v1.0→v1.4). 매 개정 = CC 초안 → Codex 검수 → 사장님 승인의 정상 절차.
- **v1.1 §0.5 반축소** = 작업자가 "통일 대신 원본 보존"으로 드리프트하는 escape hatch를 헌법이 구조적으로 차단.
- **v1.2 §5-1** = 사장님 승인 디자인 variant 예외(시각표현 구조만 한정, 로직·데이터·간격은 공통).
- **v1.3 §0.4 AI 효율논리 차단** = "일회성·부담큼·나중에" 같은 사람 기준 효율논리를 작업축소 근거로 못 쓰게 한 최상위 메타 원칙 + §3-1 전면 토큰화(raw 예외 제로).
- **v1.4 §4 CSS 분리 종결** = index.css 단일 프레임 기본, 기능집중 부산물 silo(strength.css) 금지·흡수.

## 1. v1.1 — 반축소 구조장치 (§0.5)
- **계기**: 헌법·무축소 원칙이 있어도 CC가 3-3 SocialProfile의 통일 가능한 분기를 'JS 유지 예외'로 축소하려다 사장님이 두 번 잡음. 헌법이 그 틈을 허용한 구조 문제.
- **내용**: ① §0.5 "재빌딩 우선·반축소" 최상위 원칙 — 헌법 목적 = 공통 프레임 재빌딩(원본 보존 아님), 예외/보류는 "좁은 적극 입증"만(입증책임 = 예외 두려는 쪽), **"원본이 그래서/작업량/회귀우려/토큰시간/나중에"는 예외사유 아님.** ② §5 샤프닝 — JS 유지 예외 = 진짜 다른 인터랙션(오버레이)만, 같은 콘텐츠 다른 배치는 공통 DOM+CSS 통일.

## 2. v1.2 — 디자인 variant 예외 (§5-1)
- **계기**: 3-4 Settings 계정 카드 = 데스크탑 테이블행 / 모바일 아바타카드 = "의도된 별도 시각 표현".
- **결정**: 디자인 variant는 **유지하되 예외 범위는 "시각 표현 구조"에만 한정.** 데이터·액션 로직·카피·토큰·간격·inline은 **공통 프레임 기준**으로(중복 제거·양쪽 variant에 같은 데이터 슬롯). → "찰흙때우기식 중복 로직·raw 스타일·inline 구조값 방치 금지."

## 3. v1.3 — AI 효율논리 차단(§0.4) + §3-1 전면 토큰화
- **계기**: 3-42에서 CC가 잔존 raw를 "불가피/미결"로 분리 보고. 사장님이 **운영현실**(데스크탑 편향 검수·실사용자 모바일 우위 → raw 한 톨도 모바일 자동전파를 깨는 검수구멍)을 근거로 **전면 토큰화(raw 예외 제로)** 결정. raw = 정당이 아닌 **"격리된 부채"**.
- **§0.4 AI 효율논리 차단(최상위 메타)**: 사람 기준 효율 논리("일회성·이득적음·부담큼·v2이월")를 작업 축소 근거로 삼는 것 금지. AI엔 토큰 암기비용 0·판단비용 단점 아님. **운영 고정명령(사장님 직접): "보고는 하되 그걸 핑계로 작업을 닫지 마라"**(트레이드오프 보고는 장려, 작업종결 핑계 전용만 금지).
- **§3-1 전면 토큰화**: v1.2 "비토큰 raw 유지" 폐기. (a)고빈도 비토큰값 = 토큰 스케일 승격(값 보존·스냅 금지) (b)음수 = calc(토큰) 래핑 (c)1px 마이크로 = 화이트리스트+인텐트마커. 승격절차 = 전부 후보·CC 임의 토큰화/raw확정 금지·사장님이 SoT.
- **전수 레지스트리 성과**: 위치기반 재분류로 진짜 비토큰 raw = 267 → **436**(혼합선언 `var()+raw px` 속 숨은 169 적발 = §0.4 정직 전수의 성과).

## 4. v1.4 — CSS 분리 종결 (§4)
- **계기**: 사장님 "strength.css = 탄탄한 프레임 위가 아닌 불안한 주춧대 위 덕지덕지 산물" 진단.
- **§4 종결**: index.css 단일 프레임이 기본 / 분리는 host-guarded 격리 도구(studio.css)만 / **기능집중 부산물 silo 금지.** 판별 = "앱과 격리된 별개 시스템인가?" YES만 분리.
- **실행**: strength.css(226줄·셀렉터 151) → index.css 흡수(누락 0·간격 raw 토큰화·import 4 제거·파일 삭제).

## 5. 코드-헌법 괴리 정직 보정 (정착된 문화)
헌법이 "코드보다 깨끗한 척"하지 않도록, 라이너 검수자가 못 보는 코드 실측을 Cdx가 수행해 괴리를 헌법에 정직 표기한 사례가 누적:
- **769 잔존 6곳**(v1.0) → 3-4에서 768 통일로 완전 해소.
- **isDesktop 7파일**(헌법 §5는 4곳) → 미목록 3파일 잔여작업 등록.
- **half-step 토큰 누락**(`--space-1h`·`--space-2h` 코드 89회 가동인데 표에 없음) → 9단계로 정합.
- 모두 **코드 중심 검수**(Cai가 실제 CSS 읽다 발견)의 성과.

## 6. 다음
- 헌법 v1.4 = 0~3단계 동안 도달한 정식 상태. 4단계 스튜디오 재개 시 "개별 룰"이 아닌 "패턴(primitive) 편집"으로 재설계 예정(제품 필수 아님·우선순위 낮음).