Browse Source

docs: archive outdated reports and add lifecycle policy

lingfengQAQ 4 months ago
parent
commit
a5f0baf392

+ 8 - 0
README.md

@@ -566,6 +566,14 @@ context_max_urgent_foreshadowing = 5  # 最大紧急伏笔数
 
 ---
 
+## 文档归类
+
+- 当前基线文档:`README.md`、`CLAUDE.md`、`.claude/references/*.md`
+- 历史归档文档:`docs/archive/reports/`
+- 文档状态规则:`docs/doc-lifecycle.md`
+
+---
+
 ## 项目结构
 
 ```

+ 4 - 1
_data_flow_validation.md → docs/archive/reports/data-flow-validation-v52.md

@@ -1,4 +1,7 @@
-# 数据流验证:webnovel-plan → context-agent → webnovel-write
+# [Archived] 数据流验证:webnovel-plan → context-agent → webnovel-write
+
+> 归档日期:2026-02-06
+> 归档原因:阶段性验证报告,结论已并入主流程文档,不再作为当前操作基线。
 
 ## 1. 章纲字段映射
 

+ 5 - 0
.claude/scripts/token_budget_report.md → docs/archive/reports/token-budget-report-v52.md

@@ -1,7 +1,12 @@
+[Archived]
+
 ======================================================================
 📊 章节创作 Token 预算分析
 ======================================================================
 
+归档日期:2026-02-06
+归档原因:静态预算报告基于早期假设(v5.2/v5.3),当前系统已启用动态上下文预算与阶段化配置,原报告仅保留作历史参考。
+
 ## 1. 参考文件 Token 消耗
 
 ### 必须加载(每章)

+ 34 - 0
docs/doc-lifecycle.md

@@ -0,0 +1,34 @@
+# 文档生命周期与归类
+
+本文件用于统一管理仓库文档的状态,避免“过时文档混在当前流程中”。
+
+## 状态定义
+
+- **current**:当前流程的执行基线文档(可直接按文档操作)。
+- **reference**:长期参考资料(方法论、模板、术语表),不等同于强制流程。
+- **archived**:历史记录或阶段性报告,仅保留追溯价值,不作为当前流程依据。
+
+## 归类规则
+
+- 若文档描述的流程已被新版本实现替代,标记为 `archived`。
+- 若文档是一次性测算/分析报告(如预算快照),完成后进入 `archived`。
+- 若文档被技能/脚本直接读取,必须保留为 `current` 或 `reference`,不得直接归档。
+
+## 当前已归档文档
+
+- `docs/archive/reports/data-flow-validation-v52.md`(阶段性数据流验证报告)
+- `docs/archive/reports/token-budget-report-v52.md`(早期静态 token 预算报告)
+
+## 当前核心基线(示例)
+
+- `README.md`
+- `CLAUDE.md`
+- `.claude/references/context-contract-v2.md`
+- `.claude/references/claude-code-call-matrix.md`
+- `.claude/references/genre-profiles.md`
+- `.claude/references/reading-power-taxonomy.md`
+
+## 维护建议
+
+- 每次发布新阶段功能时,检查是否有“旧报告/旧规范”仍位于根目录。
+- 新增阶段性分析文档时,建议直接写入 `docs/archive/reports/`。