仓库即真理源头

仓库即真理源头（Repository as Source of Truth）是Agent-First开发模式中的一项核心知识管理原则。它要求所有对AI Agent有效的信息——包括设计、架构、规范、配置、文档等——都必须存在于代码仓库中，而非Slack对话、Google Doc或人脑共识中。

核心原则

1. 信息可访问性：任何运行时不可访问的信息对Agent等同不存在。
2. 持续上下文推送：团队持续将上下文从外部渠道推入仓库。
3. 版本控制：所有信息都纳入版本管理，确保可追溯和可回滚。
4. 自动化验证：通过CI和lint检查确保仓库信息的准确性和一致性。

解决的问题

• 信息孤岛：消除Slack、文档、人脑中的隐性知识。
• Agent信息缺失：确保Agent始终能访问到最新、最准确的信息。
• 知识流失：人员更迭不会导致关键知识丢失。

实施方法

1. 将所有设计文档、架构描述、规范文件纳入仓库。
2. 建立从外部渠道到仓库的信息同步机制。
3. 使用自动化工具验证仓库信息的完整性和一致性。
4. 部署"文档园丁"Agent维护文档健康度。

与相关概念的关系

• [[渐进式披露]]：仓库即真理源头是渐进式披露的基础。
• [[context-engineering]]：该原则是上下文工程的重要实践。
• [[harness-engineering]]：该原则是Harness Engineering知识管理的基石。