四条纪律,让体系自己保持常新
文档体系最大的敌人是「建完就烂」。这四条已写进根 CLAUDE.md,每次开发自然触发——不是额外负担,是顺手的事。
架构变了 → 更新 reference
动了数据流 / 技术栈 / 模块结构,顺手改 docs/reference/ 对应文档,而不只写 memory。
做了不可逆决定 → 追加 ADR
在 docs/decisions/ 新增一条,编号递增、只增不改。决定变了就写新的、旧的标「已被 NNNN 取代」。
收尾 /wrap → 检查同步
会话收尾时,除更新 memory 外,回头看 reference / ADR 是否需要跟着改。
写新 PRD → 挂状态徽章
新方案顶部加徽章;实现后回 docs/README.md 状态表把它标成「已实现」。
◆ 什么进 git 文档
架构、不可逆决策、领域不变量等耐久真相。可评审、可追溯、不随 memory 丢失。
例:「营地为什么先审后发」→ ADR 0001
◆ 什么留 memory
当前部署到哪、哪个开关激活没、踩了什么坑、待办进度等易变状态。
例:「175 当前是否已开 JSAPI」→ memory