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:
empty
2025-12-16 10:55:18 +08:00
parent d97152b5df
commit cc6e137994
9 changed files with 30 additions and 85 deletions

View File

@@ -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`
- 归档文档 → 不更新,保持历史原貌