From 272b315ab050f43372f3423513cd2d9e3b286499 Mon Sep 17 00:00:00 2001
From: 2620227 <hyemin.lee@bok.or.kr>
Date: Mon, 29 Jun 2026 17:53:24 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20=EB=B9=8C=EB=93=9C=20=EC=97=86=EB=8A=94?=
 =?UTF-8?q?=20=EC=A0=95=EB=A6=AC=C2=B7=EB=B6=84=ED=95=A0=20=ED=97=88?=
 =?UTF-8?q?=EC=9A=A9=EC=9C=BC=EB=A1=9C=20=EB=8B=A8=EC=9D=BC=20CSS=20?=
 =?UTF-8?q?=EC=A0=9C=EC=95=BD=20=EC=99=84=ED=99=94=20(CLAUDE.md)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

프레임워크/번들러/빌드는 계속 금지하되, 다중 <link> CSS·네이티브 ESM 모듈 분할은 허용.
임시 미리보기 파일(_preview.mjs)을 .gitignore 에 추가.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .gitignore | 1 +
 CLAUDE.md  | 5 ++++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index b8602da..de17fcc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -7,3 +7,4 @@ npm-debug.log*
 dist/
 .DS_Store
 HANDOFF.md
+_preview.mjs
diff --git a/CLAUDE.md b/CLAUDE.md
index 5abc428..c63dd0f 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -5,7 +5,10 @@ AI DEV — 사내 개발 포털. 직원이 한 곳에서 **사내 개발 사이
 
 ## 이 저장소를 다룰 때 (먼저 읽기)
 - **사용자는 개발 전문가가 아닌 사내 IT 기획자/직원**이다. 변경은 **단순하게** 유지한다.
-  - 빌드 단계·프런트엔드 프레임워크(React 등)·번들러 도입 **금지**. 서버 렌더링(EJS) + 단일 CSS 유지.
+  - 무거운 도구는 피한다: **프런트엔드 프레임워크(React 등)·번들러·빌드 단계는 도입하지 않는다.**
+    서버 렌더링(EJS) 유지.
+  - 단, **빌드가 필요 없는 범위의 정리·분할은 허용**한다 — CSS 를 역할별 파일로 나눠 다중 `<link>`,
+    JS 를 브라우저 **네이티브 ESM 모듈**(`<script type="module">` + `import`)로 분할 등.
   - 새 npm 의존성은 꼭 필요할 때만, 이유와 함께 추가한다.
 - **UI 문구와 코드 주석은 한국어**로 쓴다.
 - **비밀값은 코드에 넣지 않는다.** 환경변수(`.project-env` 로컬 / Kubero Env 배포)로만 다룬다.