template-monorepo/CLAUDE.md

CLAUDE.md

Claude Code project memory. 本檔以 @import 把專案規範帶入 context；所有規則的單一真實來源（SSOT）在 docs/AGENTS.md。

核心規範（必讀）

@docs/AGENTS.md @docs/model.md

專案總覽

@README.md

子系統設計

@docs/identity-member-design.md @docs/auth-unified-registration.md

子目錄 README（按需查閱，未 @import；需要時用 Read 工具開啟）

• generate/api/README.md — .api 寫法、middleware 宣告、@respdoc
• generate/doc-generate/README.md — go-doc tag / @respdoc 參考
• internal/library/errors/README.md — 8 碼錯誤碼設計
• internal/library/mongo/README.md — Mongo + Redis cache 流程
• internal/library/redis/README.md — Redis client 共用
• internal/library/validate/custom/README.md — 自訂 validator tag
• internal/response/README.md — Handler / Logic 分工
• internal/model/auth/README.md
• internal/model/member/README.md
• internal/model/permission/README.md
• internal/model/notification/README.md
• deploy/README.md — Docker compose / 部署
• etc/README.md — 設定檔說明

工作原則摘要

• 回應一律繁體中文。
• 改動 Go 程式碼後執行 make check（= make fix + make test）才算完成。
• 不主動建立 *.md 文件，除非使用者明確要求。
• 不主動 commit；commit 前先 git status / git diff 確認；commit message 描述「為什麼」。
• rm -rf / 強制 push / 改 git config 等破壞性操作前必須先取得使用者同意。
• 程式碼註解只寫「為什麼」與邊界條件，不寫「import the module」這種顯而易見的描述。