Repo as System of Record

概述

Repo as System of Record 是一种软件工程实践，指将任务定义、架构约束、质量标准等信息全部写在代码仓库中，而不是依赖口头约定或即时消息传递，使 AI 代理能够读取仓库获取所需的所有信息。

关键内容

1. 核心理念：
2. 仓库作为唯一的真实来源（Source of Truth）
3. 将所有项目规则、约束和规范编码到仓库中

4. 让 AI 代理能够自主获取必要的上下文信息

5. 实施方式：

6. 任务定义写入仓库
7. 架构约束写入仓库
8. 质量标准写入仓库
9. 不依赖 Slack 消息或口头约定

10. 通过文档文件（如CLAUDE.md）定义项目规范

11. 优势：

12. 确保 AI 代理能够访问最新的规范
13. 避免因沟通不畅导致的错误
14. 支持自动化验证和约束执行
15. 提高团队协作的一致性和透明度

16. 在Harness分层架构中实现规范的系统化管理

17. 在Harness Engineering中的应用：

18. 作为Harness框架的重要组成部分
19. 支持Agent对项目环境的全面理解
20. 实现规范的自动化执行和验证

来源

• Harness Engineering的本质是什么？ - riba2534 的回答 — 知乎文章
• Harness Engineering: Leveraging Codex in an Agent-First World — OpenAI官方文章

相关

• Harness-Engineering — relates_to
• CLAUDE.md文档 — relates_to
• Knowledge-Base — relates_to
• Version-Control — relates_to
• Harness分层架构 — relates_to
• Software-Engineering-Best-Practices — relates_to