This replaces the self-expiring docs latest-merge SHA in the final REV004 summary with a stable wording that points readers to current mainline content, preventing the summary from going stale immediately after each merge. Constraint: The top-level handoff summary must remain self-consistent after it is merged into main Rejected: Keep chasing a concrete docs latest-merge SHA in follow-up patches | creates infinite self-expiring metadata churn Confidence: high Scope-risk: narrow Reversibility: clean Directive: Prefer stable branch-relative wording over self-referential merge SHAs in evergreen handoff docs Tested: Reviewed rendered markdown diff for semantic equivalence plus improved stability Not-tested: No document export/render pipeline executed for this wording-only change
docs 研究与指南入口
目录用途
docs/ 用于维护研究资料、映射说明、工具使用指南与历史版本参考。
子目录说明
docs/design/00_Management/:项目管理、治理基线与 AI 维护规范docs/design/01_Overview/:概要设计主文档与总体架构docs/design/02_Detailed_Design/:详细设计主文档与模块设计docs/design/03_Technical_Design/:数据库、接口、安全、部署等技术专项docs/design/04_Appendix/:附录与历史归档资料guides/:执行指南与映射口径(优先使用)design/:设计辅助文档research/:调研资料v1.6/:历史版本材料
推荐阅读顺序
guides/SPECKIT_WORKFLOW_HUMAN_GUIDE.mdguides/SYSTEM_CAPABILITY_CLOSURE_MAP.mdguides/BACKEND_CURRENT_STATUS.mdguides/BACKEND_TABLE_MAPPING.md- 其他辅助资料
维护原则
- 该目录作为“辅助事实来源”,不替代主文档
- 如与主文档冲突,优先以主文档与当次用户要求为准