diff --git a/.env.example b/.env.example
index d89ac14..6a751e1 100644
--- a/.env.example
+++ b/.env.example
@@ -50,8 +50,12 @@ FORGEJO_PASSWORD=
 #   권한: repository(write), user(read)
 FORGEJO_TOKEN=
 
-# npmjs 배포 토큰 (Automation 타입).
-#   npmjs.com → Access Tokens → Generate → Automation
+# ── npmjs ────────────────────────────────────────────────────
+# Automation 타입 토큰. 2FA 가 켜져 있어도 CI 에서 쓸 수 있다.
+#   npmjs.com → Access Tokens → Generate New Token → Classic → Automation
+#
+# 주의: 이 토큰이 채워지고 태그를 밀면 `designpaca` 이름이 npm 에 선점된다.
+#       되돌리기 어려우므로 승인 없이는 태그를 밀지 않는다.
 NPM_TOKEN=
 
 # Forgejo 사설 npm 레지스트리 미러용 토큰.
@@ -61,13 +65,24 @@ FORGEJO_NPM_TOKEN=
 # Forgejo 릴리스 생성용 토큰. 워크플로가 draft 릴리스를 만든다.
 RELEASE_TOKEN=
 
-# Cloudflare Pages 배포.
-#   dash.cloudflare.com → My Profile → API Tokens
-#   권한: Account / Cloudflare Pages / Edit
+# ── Cloudflare Pages (소개 페이지) ───────────────────────────
+# 릴리스 워크플로가 `npx wrangler pages deploy` 로 배포한다.
+# wrangler 를 로컬에 설치할 필요는 없다 — CI 가 npx 로 받는다.
+#
+# 토큰 만들기: dash.cloudflare.com → My Profile → API Tokens → Create Token
+#   권한 두 개가 필요하다
+#     Account · Cloudflare Pages · Edit      (배포)
+#     Account · Account Settings · Read      (계정 ID 조회 — 없으면 아래를 직접 채워야 한다)
 CF_API_TOKEN=
+
+# 계정 ID. CF_API_TOKEN 에 Account Settings:Read 권한이 있으면
+# 비워둬도 된다 — 토큰으로 조회해서 채워 넣겠다.
+# 직접 넣으려면 대시보드 우측 하단 "Account ID" 를 복사한다.
 CF_ACCOUNT_ID=
 
-# Cloudflare Pages 프로젝트 이름 (아직 만들지 않았다)
-CF_PAGES_PROJECT=
-# 연결할 도메인
+# Pages 프로젝트 이름. 아직 만들지 않았다.
+# 비워두면 `designpaca` 로 만들겠다(워크플로가 쓰는 이름과 같아야 한다).
+CF_PAGES_PROJECT=designpaca
+
+# 연결할 도메인. Pages 프로젝트를 만든 뒤 커스텀 도메인으로 붙인다.
 SITE_DOMAIN=designpaca.chanpaca.net