Markdown 正在取代代码成为真正的源码

Markdown in /src

随着 LLM 生成的代码越来越廉价，代码背后的意图反而成了最宝贵的资产。然而，这些意图往往散落在瞬时的 Prompt 会话、Slack 线程或 Wiki 文档中，导致真正的'源码'缺失。在 agentic coding 时代，我们应当将 Markdown 视为真正的源码，直接存入 /src 目录，与生成的代码并列。这样不仅保留了架构决策和数据设计等核心逻辑，还能让人类和 Agent 都能通过本地化（Locality）原则高效获取上下文。与其依赖易逝的提示词，不如让 Markdown 成为系统行为的单一事实来源，让测试和代码都从这份持久的规范中衍生出来。