Memory Index
本目錄提供給 Codex 的是「按需命中索引」，不是每次 session 全讀清單。
使用規則
- 先讀這份索引，再打開必要的單篇 memory。
- 只在任務與主題直接相關時才讀全文。
- 若資訊已升格為架構決策，應以 ADR 為準，不重複維護兩份真相。
索引
| 檔案 | 用途 | 何時閱讀 |
|---|---|---|
history_logs.md |
重大里程碑與歷史脈絡 | 要理解演進背景、排查「為何變成這樣」時 |
ai_automation_closure_20260429.md |
四 AI Agent 自動化閉環、Smoke、metrics 與 Grafana 觀測實況 | 接續 AI 自動化、EventRouter、AutoHeal、OpenClaw memory、ElephantAlpha 編排、可觀測性時 |
credentials_passbook.md |
伺服器、帳密、埠位對照 | 需要維運、部署、憑證核對時 |
feedback_db_metadata_import.md |
SQLAlchemy metadata / create_all() 漏表鐵律 |
新增 model、修 schema、排查 fresh env 漏表時 |
db_connection_pool_singleton_20260430.md |
PostgreSQL too many clients 連線池放大事故與 DatabaseManager singleton 修正 |
排查 DB 連線數暴增、route 內反覆初始化 DatabaseManager、SQLAlchemy engine/pool 行為時 |
project_phase38_56_observability_war_room.md |
Phase 38→56 AI 觀測台戰役落地盤點、已知缺口與後續拆分方向 | 接續觀測台頁面、Telegram 指令、scheduler probe、AutoHeal/CodeReview L2 入口、Chart.js polish 或 deploy_doctor 時 |
observability_ui_qa_guardrails_20260505.md |
AI 觀測台 UI/UX guard、production smoke、CSS mirror 與 quick review 非互動入口 | 修改 /observability/* 前端、側欄、topbar、Chart.js、CSS 或部署觀測台前端變更時 |
project_phase3f_cleanup_roadmap.md |
ADR-017 執行矩陣與階段紅線 | 正在做 3f 模組化收尾時 |
code_modularization_inventory_20260430.md |
Python 大檔盤點、分層規範與拆分工作項目 | 新增功能、拆大檔、審查是否違反模組化治理時 |
schema_inventory_baseline.md |
DB 表分類與 drift 基線 | 要收斂 migration / ORM / raw SQL 真相時 |
frontend_v3_handoff_20260512.md |
前端 V3 守門落地、正式部署、UI/UX 響應式缺口與接續順序 | 新 session 接續前端 V3 全站 UI/UX、手機版確認、/daily_sales 或 /edm 修正與部署時 |
claude_inventory_validation_20260513.md |
Claude Code V1/V2 盤點逐項驗證、已修項與不可盲動清單 | 接續盤點整改、判斷某項是否仍是阻擋、避免重複清已修項時 |
關聯 Guide
docs/guides/codex_agent_roles.md用途：12 位歷史 Agent 的 Codex 化角色矩陣。 何時閱讀：要做多角色分工、任務派工、review 流程設計時。docs/guides/observability_ui_governance.md用途：AI 觀測台/observability/*頁面的 UI/UX 設計治理、禁用事項與巡檢指令。 何時閱讀：新增或修改觀測台頁面、側欄、Chart.js、資料密集卡片/表格、空狀態時。
新增規則
- 單篇只處理一個主題。
- 優先記錄高重用知識，不保存一次性對話。
- 若內容超過一頁仍持續成長，先評估是否應改成 guide 或 ADR。