---
title: "🧭 결정 — UI/UX 토큰맵 체제 규율 상시화 (규칙 밖 신규 UI/UX는 보고+컨펌 필수)"
category: "decision"
parent: "Claude Code 작업일지"
updated: "2026-07-03"
priority: "High"
purpose: "토큰맵 작업이 2026-07-03 종결된 이후, 모든 UI/UX 개선·추가 작업을 토큰맵 체제 규칙(색상 color-mix 토큰화·§3-1 spacing 전면 토큰화·breakpoint 560/768/1024) 안에서만 진행하도록 상시 규율로 등재한 결정. 규칙 밖 예외(신규 토큰·패턴 필요)는 임의 진행을 금지하고 사장님 보고+컨펌을 의무화했다."
read_when: ["토큰맵 체제 규율", "규칙 밖 UI/UX 컨펌", "강력지침 0", "헌법 §0.6", "colorTokenGuard spacingTokenGuard"]
document_type: "의사결정"
source_status: "generated"
knowledge_group: "03_history"
work_timestamp: "20260703_191950"
source_of_truth: "https://dallog-tools.hansbridge.co.kr/knowledge/"
context: "달록 본레포(ccy-hansbridge/dallog), 커밋 2bb0366(2026-07-03)."
---

# 결정 — UI/UX 토큰맵 체제 규율 상시화

## 1. 결정

토큰맵 작업은 2026-07-03 종결되었다. **이후 모든 UI/UX 개선·추가 작업은 토큰맵 체제 규칙 안에서 진행**한다 — 색상 토큰화(color-mix·`colorTokenGuard` css/tsx 부채 0), §3-1 전면 px 토큰화(`--sp/--space/--fs/--radius`, 1px·0·clamp만 예외·`spacingTokenGuard`), breakpoint 560/768/1024.

- **규칙 안에서 해결되는 버그수정·개선**은 그대로 진행한다.
- **★규칙 밖 예외**(규칙에 없어 새로 만들어야 하는 신규 토큰·패턴, 또는 규칙을 벗어날 수밖에 없는 신규 UI/UX)는 **임의 진행을 절대 금지**한다. 반드시 사장님께 **쉬운말 해설문으로 보고 + 컨펌 요청**하고, **지시·컨펌을 받은 뒤** 진행한다.
- 스튜디오(`studio.css`·`components/studio/*`)는 헌법 §4 격리·페이즈1 외 대상이라 본 토큰 규율의 대상이 아니다.

## 2. 배경

토큰맵(UI 색상·스페이싱 토큰화) 작업이 이 시점에 종결되었다. 이후 진행될 모든 UI/UX 작업이 각자 판단으로 새로운 토큰·패턴·breakpoint를 만들면 토큰맵 작업의 성과(부채 0 상태)가 다시 흐트러질 위험이 있어, 이를 막기 위한 상시 규율로 등재되었다.

## 3. 등재처

같은 커밋에서 5곳에 동시 등재되었다:
- `AGENTS.md` — 강력지침 0 신설.
- `CLAUDE.md` — 최상단 규율로 등재.
- `docs/ui_rebuild/_00-A_PREWORK_GATE.md` — §0로 신설(착수 전 정독목록의 최우선 항목).
- `docs/ui_rebuild/_11_LAYOUT_CONSTITUTION.md` — §0.6로 신설.
- 메모리 `feedback_ui_within_tokenmap`.

## 4. 영향

- 이 결정 이후의 모든 UI/UX 작업(작업 계획·패치·배포 검수)에서 "규칙 안에서 해결되는가, 규칙 밖 예외가 필요한가"를 먼저 판단해야 한다.
- 이 규율은 이후 CLAUDE.md 최상단에 "★UI/UX 토큰맵 체제 규율(2026-07-03 종결·상시 적용)" 항목으로 계속 유지되고 있다.

## 5. 관련 커밋

- `2bb0366` docs(governance): 토큰맵 체제 규율 상시화 등재 — 규칙 밖 신규 UI/UX는 쉬운말 보고+컨펌 필수 (2026-07-03)