本目录是 AltForge 的长期文档源。文档采用分层结构，避免把项目目标、当前设计、单次变更和历史记录混在一起。
| 层级 | 用途 | 入口 |
|---|---|---|
| Workflow | 当前项目要做什么、怎么做、怎么验证 | docs/workflow/ |
| Knowledge | 长期稳定的术语、结构、行为和参考资料 | docs/knowledge/ |
| Changes | 单次需求、修复或流程变更的生命周期 | docs/changes/ |
| Records | Issue、ADR、发布、归档和工程规则 | docs/issues/、docs/adr/、docs/releases/、docs/archive/、docs/rules/ |
- 产品形态：AltStore Classic 派生项目，由 iOS 端 AltForge 与 macOS 端 AltServer 协作完成侧载。
- 主分支：
marketplace，但当前发布配置明确构建 Classic 版本，不嵌入 Marketplace extension。 - 构建入口：
AltStore.xcworkspace。 - 工具链：Xcode 26；项目当前
SWIFT_VERSION为 5.0，两份根 README 均已明确区分工具链版本和 Swift language mode。未来迁移 Swift 6 language mode 需要独立 change 与验证。 - 最低系统：iOS 17.4、macOS 11；
AltJIT最低 macOS 13。 - 发布产物：未签名 IPA、未公证的 macOS AltServer、未签名的 Windows AltServer ZIP、
apps.json、三类自有远程配置 JSON 与校验和；标签流水线只创建 Draft。 - 本地 macOS 试装：DMG 构建、安装与清理指南。
- Release CDN：版本固定对象、Actions 变量、完整性与回滚要求。
- 已知重点：Unicode IPA 兼容、简体中文、本地构建可复现性、签名安装链路测试。
- 当前事实写入 workflow 或 knowledge，不用新文件制造第二份真相。
- 新功能、bugfix、重构和流程变化必须创建 change 记录，并同步需求、设计和验证文档。
- 未解决风险进入
docs/issues/，关键技术取舍进入docs/adr/。 - 默认工程治理规则从
docs/rules/README.md进入；提交前至少检查 提交规则 和 Definition of Done。 - 文档路由以
spec-init.topology.yml和docs/rules/document-routing-rules.md为准。