一位创业公司 CTO 复盘自己推行“文档优先”的整套做法：用一页纸代替半小时站会、把文档工时显式写进排期、给每个 feature 合并时附一段“为什么选 X 不选 Y”。他也承认过度文档会反噬（过时页面比没有更糟），因此只记录能活过一个季度的 80% 内容，并用一条轻量 CI 检查强制新埋点必须配 wiki 条目。文中给出 ADR、incident post-mortem、Diátaxis、docs gardener 等具体机制，适合正在搭建工程规范的中小团队负责人与一线工程师参考。
Aspire 团队用 GitHub Agentic Workflows 在 10 人规模下把跨仓库文档自动化跑通。工作流以单 Markdown 文件定义，agent 先判断是否需要文档并起草内容，仅输出 JSON 意图；真正的写操作由受限的 safe-outputs handler 执行——GitHub App 安装范围只有产品仓库和文档仓库两个 repo，且只能开 PR 到 main 或 release/*。Aspire 13.3/13.4 期间，396 个合并的产品 PR 产生 82 个文档 PR，中位 44.8 小时合并，全部由原功能 PR 的 SME 评审，100% 合并率。关键设计是 milestone 到 release 分支的精确映射，以及 draft-only 流程。文中也坦承 v1 有 13% 误判率、大 diff 撑爆 prompt 预算等失败经验。适合正为“代码和文档分开仓库”头疼的工程团队。