doc-gov@0.3.2 · AI-native project governance

让人和 AI 都知道，该信哪份文档。

Project Governance System 是一个给长期项目用的轻量治理层。它不替代 Git，也不替代工程流程；它解决的是 AI 时代更麻烦的问题：规则、计划、文档和当前真相不能越写越多，最后没人敢碰。

terminalgovernance check

$ pnpm add -D @pieai/doc-gov

$ pnpm doc-gov doctor

✓ router-check

✓ check

✓ scan --check

✓ links

✓ audit

✓ doctor

如果一个项目有很多 AI 会话参与，PGS 负责让每个会话先看同一张地图。

What it governs

AI 很会生成内容，PGS 负责让内容有秩序。

AGENTS 路由先告诉 AI 该进入哪条工作 lane，避免每次从 README 和猜测开始。

SSOT、policy、reference、execution 分层，让规则、当前状态和历史材料各有货架。

过期文档不再靠人脑记忆辨认，而是通过生命周期、扫描和审计暴露出来。

一组 CLI 检查把路由、链接、结构、扫描和 doctor 串成可重复验证的证据链。

install path

写清楚 AGENTS 启动规则

把 docs 分成 policy / governance / reference

标记 canonical、status、owner 和生命周期

在提交前跑 doc-gov 检查

查看项目结构、治理规则、adoption playbook 和 issue 入口。

当前 latest 为 doc-gov@0.3.2。按项目需要安装 CLI，把检查接进日常工作流。