docs: 文档生命周期管理规范化
CLAUDE.md: - 新增「文档管理」章节,明确文档分类和更新策略 - 核心原则:不创建需要手工同步的文档 删除过时文档: - PROJECT_STRUCTURE.md(代码即结构) - docs_index.md(直接浏览目录) 归档历史设计文档: - PRD/TECHSPEC/IXSPEC 移入 docs/archive/ 统一应用名称: - 所有文档中 "Live Photo Maker" → "Live Photo Studio" 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
24
CLAUDE.md
24
CLAUDE.md
@@ -57,3 +57,27 @@ xcodebuild -scheme to-live-photo -configuration Release -destination 'generic/pl
|
||||
- 新增 View 必须适配深色模式和 iPad
|
||||
- 触控目标 ≥ 44pt
|
||||
- 错误处理使用 `LivePhotoError` 枚举,禁止裸 `throw`
|
||||
|
||||
## 文档管理
|
||||
|
||||
### 核心原则
|
||||
> 不创建需要手工同步的文档。如果信息会随代码变化,要么让代码自描述,要么接受文档必然过时。
|
||||
|
||||
### 文档分类
|
||||
| 类型 | 文件 | 更新策略 |
|
||||
|-----|------|---------|
|
||||
| 宪法 | `CLAUDE.md` | 谨慎修改,每次变更需明确意图 |
|
||||
| 任务 | `TASK.md` | 活跃更新,追踪里程碑进度 |
|
||||
| 运维 | `docs/TEST_MATRIX.md`, `docs/USER_GUIDE.md` | 随功能<E58A9F><E883BD><EFBFBD>更同步更新 |
|
||||
| 上架 | `docs/APP_STORE_METADATA.md` | 版本发布前更新 |
|
||||
| 归档 | `docs/archive/` | 只读,不再更新 |
|
||||
|
||||
### 禁止创建
|
||||
- 目录结构文档(如 PROJECT_STRUCTURE.md)— 代码即结构
|
||||
- 文档索引(如 docs_index.md)— 直接浏览 docs/ 目录
|
||||
- 任何需要"记得同步"的描述性文档
|
||||
|
||||
### 更新触发
|
||||
- 新增/修改功能 → 同步 `USER_GUIDE.md` 相关章节
|
||||
- 新增测试场景 → 同步 `TEST_MATRIX.md`
|
||||
- 归档文档 → 不更新,保持历史原貌
|
||||
|
||||
Reference in New Issue
Block a user