feat(平台): 补齐服务端持久化和AI拆解契约

CLAUDE.md

@@ -2,6 +2,23 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## ⚠️ 必读文档（开始任何工作前先读）
+
+以下 4 个文档定义了项目的架构、决策、流程和路线图。**每次新会话开始时必须先读这些**，避免重新讨论已决定的方案：
+
+- `docs/architecture.md` — 整体架构、心智模型、关键设计原则
+- `docs/decisions.md` — 关键设计决策记录（含为什么这么做）
+- `docs/workflow.md` — 工作流程、协作偏好、命名规范
+- `docs/roadmap.md` — V1/V2/V3 路线图和已完成清单
+
+文档更新触发条件：
+- **architecture.md**：新增核心模块、模块边界变更、系统架构调整、新增服务、数据流变化
+- **decisions.md**：方案评审完成、多方案比较后定方案、废弃旧方案、重要设计决策
+- **workflow.md**：新增业务流程、流程节点修改、状态机变更、审批流程变更
+- **roadmap.md**：Phase 完成、Milestone 完成、新增计划、优先级调整
+
+不影响以上四类的小改动（UI 排版、bug fix、文案）不需要更新文档。
+
 ## Project Overview
 
 FTB 智能项目管理系统 — 一个集成 AI 能力的项目管理平台，核心层级：产品 → 项目 → 迭代 → 任务。