awoooi/CLAUDE.md

AWOOOI Project Configuration

Claude Code 自動載入，定義核心原則

---

🚨🚨🚨 強制提醒 (每小時自我檢查)

你有確實執行以下動作嗎？沒有就立刻執行！

□ 讀過 MEMORY.md 索引？
□ 讀過 docs/LOGBOOK.md 最新進度？
□ 讀過 docs/HARD_RULES.md 絕對禁止規則？
□ 涉及特定主題時，讀過對應 feedback_*.md？

違反後果: 重複犯錯、統帥需要反覆提醒、信任度下降

---

🔴 絕對禁止 (Hard Rules)

做任何修改前，先讀對應的鐵律文件：

→ HARD_RULES.md

---

⚠️ Session 啟動第一步

在做任何事之前，先讀：

1. MEMORY.md - 記憶索引
2. docs/LOGBOOK.md - 最新進度
3. docs/HARD_RULES.md - 絕對禁止規則
4. 涉及主題的 feedback_*.md

不要讓統帥說「你讀過 Memory 了嗎？」

---

三大核心原則

1. 不可逆操作 → 人工確認 (刪除、logOut、DROP、force push)
2. 有疑問 → 先問統帥 (不確定就停下來)
3. 任務完成 → 更新 Memory (不等被問)

專案架構

• apps/api/ - FastAPI 後端
• apps/web/ - Next.js 前端
• k8s/ - Kubernetes 配置

🛑 修改前

修改以下檔案前，必須先讀 HARD_RULES.md：

• .github/workflows/* → GitHub Billing 章節
• *telegram* → Telegram Token 章節
• apps/web/** → i18n 章節
• Incident/Approval 流程 → 確認 Telegram + DB 鏈路

---

任務前必讀

涉及以下主題時，先讀取對應 Memory：

主題	Memory 路徑
重大變更	feedback_product_survival_principles.md
Telegram	feedback_telegram_token_disaster.md
OpenClaw	feedback_architecture_openclaw_core.md
命名規範	feedback_openclaw_naming.md
i18n	feedback_i18n_zero_hardcode.md
防禦性工程	feedback_defensive_engineering.md
模組化	feedback_modular_architecture.md
API 整合	feedback_api_response_verification.md
構建部署	feedback_build_from_git_only.md
測試	feedback_no_mock_testing.md 🔴🔴 禁止 Mock
API 路徑	feedback_api_path_naming.md 🔴 修改需同步前端
部署驗證	feedback_deployment_verification.md 🔴🔴 必須驗證 Pod 版本

Skills 載入

任務類型	Skill 路徑
前端	.agents/skills/01-awoooi-frontend-aesthetics.md
後端	.agents/skills/02-lewooogo-backend-core.md
AI/決策	.agents/skills/03-openclaw-cognitive-expert.md
DevOps	.agents/skills/04-awoooi-devops-commander.md
測試	.agents/skills/05-awoooi-sre-qa.md
Git	.agents/skills/06-awoooi-monorepo-master.md

Memory 系統

• 長期記憶：~/.claude/projects/-Users-ogt-awoooi/memory/
• 索引：MEMORY.md
• 進度：docs/LOGBOOK.md

Session 協議

啟動時：讀 MEMORY.md → LOGBOOK.md → 確認當前任務

結束前：更新相關 Memory → 更新 LOGBOOK → 標記下一步