规则	唯一权威出处	边界
`docs-spec` 本地权威、长期参考入库和过程文档蒸馏	documentation-governance.md	该文件等价承担 `docs/reference/docs-spec.md` 的职责；其他 reference 只交叉引用，不另写一套文档治理规则。
中文优先的 issue、PR 和文档规则	chinese-first-documentation.md	英文标识可保真，解释、约束和验收口径必须中文化。
用户和参谋反馈默认高优先级分流	user-feedback-triage.md	`blocked`、等待上游或环境限制只描述状态，不能替代反馈优先级。
指挥官一手事实、真实推进和 PR 协作边界	commander-collaboration.md	本目录的文档治理规则不覆盖 pikasTech/HWLAB#131 的指挥作风边界。

参考索引

主题	参考文档
中文优先规则	chinese-first-documentation.md
用户反馈分流规则	user-feedback-triage.md
文档治理与 docs-spec 本地权威	documentation-governance.md
架构和 M3 上位约束	architecture.md
DEV 运行态、端口、k3s、DB readiness 和环境边界	dev-runtime-boundary.md
部署正规化、`deploy.json` DEV CD 路径、SecretRef preflight、runner/host 边界、artifact 发布和 Cloud Web rollout	deployment-publish.md
Cloud Workbench 默认界面和 UX 边界	cloud-workbench.md
Code Agent chat 同源通道 readiness 与真实回复判定	code-agent-chat-readiness.md
MVP E2E 验收测试与带编号测试报告 issue 规则	MVP-e2e-acceptance.md
指挥官/runner 协作、PR 和 prompt handoff	commander-collaboration.md
M3 闭环 rollout runbook	m3-loop-rollout-runbook.md
runner GitHub 可见性与 prompt handoff	runner-issue-visibility-handoff.md

当前稳定来源

pikasTech/HWLAB#7：指挥官看板、优先级顺序和当前 issue 状态；用户反馈必须挂到这里的醒目位置。
pikasTech/HWLAB#78：DC-DCSN-P0-2026-003，M3 虚拟硬件可信闭环方向和上位约束。
pikasTech/HWLAB#121：issue 和长期文档中文化要求。
pikasTech/HWLAB#122：用户和参谋反馈默认按高优先级用户反馈处理，并挂到 #7。
pikasTech/HWLAB#123：docs-spec 规则必须固化进 HWLAB 长期参考文档；本仓库由 documentation-governance.md 作为等价本地权威。
pikasTech/HWLAB#131：指挥作风纠偏、一手事实优先和真实推进规则。
pikasTech/HWLAB#99：Cloud Workbench 默认前端方向。
pikasTech/HWLAB#108：禁止外层页面纵向滚动、中文 UI 和内部 Markdown 帮助页。
pikasTech/HWLAB#61：DEV 手动 rollout 复盘，以及走向 CLI 加 deploy/deploy.json 自动化的路径。
pikasTech/HWLAB#109：文档治理和长期参考体系。
pikasTech/HWLAB#116：服务部署正规化三阶段：长期参考、受控 CLI/脚本入口、UniDesk CI/CD 加镜像化交付。
pikasTech/HWLAB#235：Cloud API、DB、部署与运行态专题，承载 deploy.json、DEV CD、runtime 和 16666/16667 运行态收敛关系。
pikasTech/HWLAB#340：deploy.json DEV CD 路径长期化、master CLI wrapper、Secret preflight 和恢复后健康审计。

当 issue、报告或旧文档与本目录 reference 文档冲突时，先更新 reference 文档，再让 AGENTS.md 保持短索引。过程记录不得被改写；只能把稳定结论蒸馏进这里。