Files
awoooi/CLAUDE.md
OG T 9bff46a1b0 feat: integrate Sentry + fix CI/CD issues
Sentry Integration (補強 SignOz):
- Add @sentry/nextjs for frontend error tracking + session replay
- Add sentry-sdk[fastapi] for backend error tracking
- Create sentry.client/server/edge.config.ts
- Integrate with next.config.js + instrumentation.ts
- Add Sentry exception capture in FastAPI error handler
- Create deployment scripts for Self-Hosted @ 192.168.0.110

CI/CD Fixes:
- Fix F821 Undefined name 'Field' in incidents.py
- Add NEXT_PUBLIC_API_URL env var to CI build step
- Add build-arg to Docker build verification

E2E Test Improvements:
- Fix strict mode violations in dashboard-acceptance tests
- Add timeout increase for Phase 4 demo tests
- Make tests more resilient to UI variations

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-03-24 15:19:52 +08:00

3.2 KiB
Raw Blame History

AWOOOI Project Configuration

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


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

你有確實執行以下動作嗎?沒有就立刻執行!

□ 讀過 MEMORY.md 索引?
□ 讀過 docs/LOGBOOK.md 最新進度?
□ 讀過 docs/HARD_RULES.md 絕對禁止規則?
□ 涉及特定主題時,讀過對應 feedback_*.md
□ 修改檔案前,讀過該檔案的所有註解? 🔴 NEW

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


🔴 絕對禁止 (Hard Rules)

做任何修改前,先讀對應的鐵律文件:

HARD_RULES.md


⚠️ Session 啟動第一步

在做任何事之前,先讀:

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

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


四大核心原則

  1. 變更前 → 先讀註解 (理解設計意圖再動手) 🔴 NEW
  2. 不可逆操作 → 人工確認 (刪除、logOut、DROP、force push)
  3. 有疑問 → 先問統帥 (不確定就停下來)
  4. 任務完成 → 更新 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_read_comments_first.md 🔴 先讀註解
重大變更 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 → 標記下一步