# Architecture Decision Records (ADR)

> 本目錄記錄 **EwoooC**（原 MOMO Pro System）的所有重大架構決策。
> 專案範圍：`momo-pro-system` 目錄（不含 AWOOOI / WOOO AIOps SaaS Platform）
> 遵循 Claude Code 官方規範：CLAUDE.md（憲法）+ ADR（決策）+ Memory（協作）+ Skills（流程）

## 編號規則

- 格式：`ADR-XXX-kebab-case-title.md`
- 編號連續遞增，已撤銷的 ADR 保留編號（標記 `Status: Superseded by ADR-YYY`）

## 狀態

| 狀態 | 說明 |
|---|---|
| `Proposed` | 提案中，尚未實作 |
| `Accepted` | 已批准，正在實作或已實作 |
| `Deprecated` | 已被取代，但保留歷史 |
| `Superseded` | 被新 ADR 完全取代 |

## 索引

| ADR | 標題 | 狀態 | 日期 |
|---|---|---|---|
| [001](ADR-001-three-agent-self-learning-division.md) | 三 Agent 自主學習分工（Hermes/NemoTron/OpenClaw） | Accepted | 2026-04-18 |
| [002](ADR-002-pgvector-as-sole-km-store.md) | pgvector 作為唯一 KM 向量庫 | Accepted | 2026-04-18 |
| [003](ADR-003-local-embedding-on-ollama.md) | Embedding 本地化到 Ollama 主機 | Accepted | 2026-04-18 |
| [004](ADR-004-nemotron-fallback-chain.md) | NemoTron 配額耗盡 fallback 至 Hermes Rule-based | Accepted | 2026-04-18 |
| [005](ADR-005-quality-score-time-decay.md) | KM 品質分數加入時間衰減 | Accepted | 2026-04-18 |
| [006](ADR-006-project-rename-to-ewoooc.md) | 專案正名 MOMO Pro System → EwoooC | Accepted | 2026-04-18 |
| [007](ADR-007-ai-learning-dual-write.md) | AI 學習雙寫規範（DB + KM 同步寫入） | Accepted | 2026-04-18 |
| [008](ADR-008-actual-runtime-on-188.md) | 正式運行環境確認 — 188 Docker Compose(非 110 K3s) | Accepted | 2026-04-18 |
| [009](ADR-009-embedding-retry-queue-persistence.md) | Embedding Retry Queue 持久化（DB-backed） | Accepted | 2026-04-19 |
| [010](ADR-010-gitea-cicd-pipeline.md) | EwoooC Gitea CI/CD Pipeline（Gitea Actions + Docker Compose） | Accepted | 2026-04-19 |

## 規範

1. **任何重大架構決策**（影響三條產品線之一、改動資料結構、引入新依賴）必須建 ADR
2. **每份 ADR 包含**：Context（背景）→ Decision（決策）→ Alternatives Considered（替代方案）→ Consequences（後果）
3. **建立後同步更新**：本 README 索引、相關 SOT 文件、`MEMORY.md`