CLAUDE.md

@@ -2,6 +2,31 @@
 
 해양 오염 사고 대응 방제 운영 지원 시스템. 유류/HNS 확산 예측, 역추적 분석, 구조 시나리오, 항공 방제, 자산 관리, SCAT 조사, 기상/해상 정보를 통합 제공한다.
 
+## 🚨 절대 지침 (Absolute Rules)
+
+### 1. 신규 기능 설계/구현 전 develop 최신화 필수
+
+신규 기능 설계나 구현을 시작하기 전, **반드시** 다음 절차를 사용자에게 권유하고 확인을 받을 것:
+
+1. `git fetch origin` 으로 원격 `develop` 최신 상태 확인
+2. `origin/develop`이 로컬 `develop`보다 앞서 있으면 → 로컬 `develop`을 최신화 (`git pull --ff-only` 또는 `git checkout -B develop origin/develop`)
+3. 최신화된 `develop`에서 신규 브랜치 생성 (`git checkout -b <type>/<name>`)
+4. 해당 브랜치에서 설계·구현 진행
+
+> **이유**: 구 버전 develop 기반으로 작업 시 머지 충돌·중복 구현·사라진 코드 복원 등 위험. 최신 base에서 시작해야 MR 리뷰·릴리즈 흐름이 안전.
+
+### 2. 프론트엔드 구성 시 디자인 시스템 준수 필수
+
+모든 프론트엔드 UI 구현은 **반드시** [docs/DESIGN-SYSTEM.md](docs/DESIGN-SYSTEM.md) 규칙을 준수할 것:
+
+- 시맨틱 토큰(`--bg-base`, `--fg-default`, `--color-accent` 등) 사용 — 축약형/하드코딩 금지
+- 폰트: `PretendardGOV` 단일 폰트 (4웨이트). `var(--font-korean)`, `var(--font-mono)` 경유
+- 다크/라이트 테마 전환 지원 (`data-theme` 속성 기반)
+- Tailwind 컬러 키는 CSS 변수 참조 (`bg.base`, `fg.DEFAULT`, `color.accent`)
+- 폰트 크기 토큰: `text-caption/body-2/body-1/title-4...` — 인라인 `fontSize` 금지
+
+> **이유**: 디자인 일관성·테마 전환·접근성(대비) 확보. 토큰 외 값은 리팩토링 비용을 증가시킴.
+
 - **타입**: react-ts 모노레포 (frontend + backend)
 - **Frontend**: React 19 + Vite 7 + TypeScript 5.9 + Tailwind CSS 3
 - **Backend**: Express 4 + PostgreSQL (pg) + TypeScript

docs/RELEASE-NOTES.md

@@ -4,6 +4,9 @@
 
 ## [Unreleased]
 
+### 문서
+- CLAUDE.md 절대 지침 추가 (develop 최신화, 디자인 시스템 준수)
+
 ## [2026-04-16]
 
 ### 추가