docs/ 现在只保留面向仓库访客、用户、部署者、贡献者的说明文档。
仓库根目录仍保留少量平台约定文件,方便 GitHub 和发布平台直接识别:
README.mdCONTRIBUTING.mdCHANGELOG.mdAGENTS.md
其中根 CONTRIBUTING.md 只是 GitHub 的发现入口,当前有效的贡献指南仍是 docs/contributing.md。
内部需求、规格、设计、任务、实现、规则、发布记录与问题追踪已经统一迁入 spec/。如果你要查 SSD 工作流或内部工程文档,请直接看 spec/README.md。
spec/ 的内部结构参考 spec-init 边界与 OpenSpec 风格变更流:稳定项目文档位于 spec/workflow/*、spec/knowledge/*、spec/rules/、spec/releases/,活跃 delta specs 位于 spec/changes/active/,内部文档不再混放在 docs/。
- 用户使用说明
- 部署与自部署文档
- 贡献指南与仓库协作说明(根
CONTRIBUTING.md只做入口) - 多语言 README
- 截图、图片和其他公开资源
- proposal / spec / design / tasks / implementation
- 内部 architecture 约束
- 内部 issue / quality tracking
- 活跃变更目录与历史变更档案
这些内容全部属于 spec/。
docs/
├── README.md
├── contributing.md
├── web-self-hosted.md
├── README.en.md
├── README.zh-TW.md
├── README.ja.md
├── README.de.md
├── README.es.md
├── README.fr.md
└── imgs/
spec/README.mdspec/workflow/spec/knowledge/spec/rules/spec/releases/spec/changes/active/spec/changes/archive/spec/changes/legacy/spec/issues/active/