ArchSpine 战略
ArchSpine 的定位是 AI 辅助工程的语义控制面。它不是“把文档做得更漂亮”的工具,而是把仓库结构显式化、可查询化、可治理化。
问题是什么
大型仓库会以非常稳定的方式失序:
- God file 吞掉越来越多逻辑
- 职责跨层扩散
- 历史设计意图随着团队流动而消失
传统 prompt 驱动的 AI 工作流会放大这个问题,因为它把“理解仓库”变成了一次临时重建。
核心判断
ArchSpine 用三件事来解决这个问题:
- 确定性提取
- 显式治理
- 可持久化的语义记忆
确定性提取
以 AST 结构为稳定基础,避免 Agent 在语法和依赖上盲猜。
显式治理
让团队在 .spine/rules/ 中声明规则,再基于这些规则进行审计和修复。
语义记忆
把角色、职责和 drift 信息持久化,让仓库意图不依赖单个开发者记忆存在。
执行模型
运行时实现也必须和战略保持一致:
- pipeline 各阶段要使用显式的输入 / 输出契约
- 共享运行态要保持足够窄且可读
- 临时产物要和 telemetry 分开
- 编排逻辑应放在 service 层,而不是泄漏进 task 内部
这样 ArchSpine 才能在保持 CLI-first 可用性的同时,对未来的 MCP 或 daemon 入口仍然保持确定性和可治理性。
Open core 边界
开源层:
.spine协议- extractors
- 基础 CLI
- 本地聚合
- 本地 MCP 支持
如果后续有商业层,重点应该放在组织级控制面价值,而不是基础仓库生成能力。
战略护城河
ArchSpine 进入的是四个高价值工作流位置:
- commit 时的同步和仓库卫生
- CI / PR 阶段的治理
- 通过 MCP 为 Agent 提供上下文
- 新成员 onboarding 和仓库理解
长期目标
让 .spine 像 package.json 一样,成为 AI 可读仓库中的自然标准。