# AWOOOI Project Configuration

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

## 🔴 絕對禁止 (Hard Rules)

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

→ [HARD_RULES.md](docs/HARD_RULES.md)

---

## ⚠️ Session 啟動第一步

**在做任何事之前，先讀：**
1. `MEMORY.md` - 記憶索引
2. `docs/LOGBOOK.md` - 最新進度
3. 涉及主題的 `feedback_*.md`

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

---

## 三大核心原則

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

## 專案架構

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

## 🛑 修改前

修改以下檔案前，**必須先讀** [HARD_RULES.md](docs/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` |

## 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 → 標記下一步