platform-prototype/CLAUDE.md

项目约束

本项目所有工作必须严格遵守 项目背景.md 中定义的全部规范，包括：

• 项目结构规范（三端目录划分、模块分目录）
• HTML 原型编写规范（独立文件粒度、自包含、视觉尺寸、设计令牌）
• 交互效果规范（导航跳转、Tab切换、交互注释标注）
• 命名规范（小写短横线文件名、BEM 类名）
• 墨刀导入兼容约束（禁止外部引用、简洁DOM、内联SVG）
• 模块文档规范（CHANGELOG、PRD、截图，详见 项目背景.md 第七部分）

每次生成或修改 HTML 原型文件前，必须先确认符合上述约束。

Agent 行为约束（补充项目背景.md 中未涉及的 Agent 专属规则）

PRD 文档更新时机

• 禁止自动更新：修改原型页面时不得自动同步更新 PRD 文档
• 仅在用户明确要求时才编写、更新 PRD 或重新截取页面截图
• PRD 的具体编写规范和截图规范见 项目背景.md 第 7.3 和 7.4 节

CHANGELOG 更新时机

• 每次提交代码前，自动整理本次变更内容并追加到对应模块的 doc/CHANGELOG.md 中
• 格式规范见 项目背景.md 第 7.2 节

导航页同步

• 新增原型页面时，必须同步在 index.html 的 SITE_MAP 中添加对应条目
• PRD 文档生成后需要在导航页对应的一级菜单卡片左下角加上 PRD 文档的跳转逻辑

记忆体系（会话启动必读）

强制规则：每次新会话启动时，必须先读取本项目的记忆体系索引，再按需加载关键记忆文件，然后才能开始处理用户请求。长会话中若上下文被压缩，同样需要重新加载。

读取流程

1. 读取索引：cat .claude/memory/MEMORY.md — 获取记忆文件清单与最近更新状态
2. 必读文件（每次会话必须加载）：
   • decisions.md — 关键决策与架构约定，避免重复讨论已决事项
   • feedback.md — 协作规范与用户纠正，避免重犯已纠正的错误
   • project_progress.md — 当前阶段进度与待办，避免重复已完成工作
3. 按需加载（与当前任务相关时加载）：
   • project_overview.md — 技术栈与架构（涉及架构讨论时）
   • user_profile.md — 用户角色与偏好（需要个性化回复时）

记忆体系的更新与同步

1. 记忆体系文件更新：当收到git指令并完成本地代码提交之后要自动调用/memory-sync插件完成记忆文件的更新

记忆目录

.claude/memory/
├── MEMORY.md              # 索引（入口）
├── decisions.md           # 关键决策
├── feedback.md            # 协作规范
├── project_progress.md    # 阶段进度
├── project_overview.md    # 技术栈与架构
└── user_profile.md        # 用户画像

记忆文件是跨会话持久化的知识，优先级高于 Agent 的默认推断。若记忆内容与当前代码状态冲突，以代码为准并更新记忆。