diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..628632e
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,16 @@
+# star-cloud — 專案開發規範（Claude Code）
+
+> 本專案的開發規範與 Antigravity 共用**同一份來源**：`.agents/rules/`。
+> 下方以 `@` import 載入，避免重複維護。**要修改規範請直接編輯 `.agents/rules/` 內的檔案**，不要改這裡。
+
+## 一律遵循的專案規範（always-on）
+
+@.agents/rules/framework.md
+@.agents/rules/api-rules.md
+@.agents/rules/rbac-rules.md
+@.agents/rules/skill-trigger.md
+
+## Claude 專屬補充
+
+- `.agents/rules/` 與 `skill-trigger.md` 原為 Antigravity 撰寫，其中提到的 `view_file` 工具，在 Claude 對應為 `Read`；`.agents/skills/` 的 SKILL.md 可用 `Read` 讀取後依其指引作業。
+- 提交訊息規範（繁體中文、`[FEAT]/[FIX]/[DOCS]/[STYLE]/[REFACTOR]` 前綴 + 數字列表）與環境晉升（dev → demo → main）流程，已封裝為使用者層自訂指令 `/now-push`、`/start-task`、`/promote-env`、`/hotfix-prod`，需要時可直接呼叫。