Markdown in /src
8 hours ago
- Markdown正在成为智能体编码工作流中的新源代码，而不仅仅是文档。
- Markdown应与生成的代码一起检入/src，以保留代码背后的意图。
- 提示会话是临时的；持久化Markdown捕获规范和决策。
- Markdown是可差异化的、可搜索的、可审查的，并且对人类和LLM都可读。
- 提议的/src/md目录包含低级规范、架构决策和数据设计。
- 本地Markdown避免了在wiki或其他工具中分散的文档。
- 测试应源自Markdown，而非临时的提示。
- 开发者与Markdown和派生代码交互，并在需要时同步更改。
- /src/md内容应主要人工编写，而非由代理生成。
- 提议的/src/md结构包括README.md、TODO.md、OVERVIEW.md，以及功能、数据、API、基础设施的子目录。