docs(architecture): 宏观工程设计基线与规则落盘

[DeliciousBuding]

目标

把上一轮「AgentHub 宏观软件工程设计」研究沉淀为可复用的架构基线，并同步到规则与决策入口。本轮只落文档与规则，不实现任何代码行为。

变更

• 新增 docs/architecture/10-macro-engineering-design.md：双平面目标架构、协议分层（自有 REST/WS / MCP / A2A / AG-UI）、事件一致性合同、最小代理权、OTel GenAI 可观测、差距矩阵与 P0/P1/P2 路线图、anti-goals、来源与证据等级、未验证清单。
• docs/architecture.md：新增 4 条非协商边界与 owner 链接。
• docs/architecture/README.md：登记新子文档。
• docs/decisions.md：新增 ADR-025（双平面正式化）与 ADR-026（协议分层 + 四条 P0 设计合同，设计基线、未实施）。
• AGENTS.md：新增 §2.5 宏观工程设计基线（常驻指针 + 6 条硬边界）；§11 增加 issue-as-spec 字段合同。
• docs/governance/verifier-map.md：四条新规则登记为“无”机器门禁。

验证

• python scripts/verify/verify-doc-ssot.py：doc SSOT ok；verifier-map 52 条脚本路径与 44 个 CI 文件检查通过。
• git diff --check：通过。
• AGENTS.md 284 行（<300 行预算）；新架构文档 140 行。

明确未做（不是本次完成）

• 未审计 outbox 与业务事务同写、event version、snapshot；未实现 task-scoped/per-action 授权；未接入 OTel GenAI span；未验证远程执行真实 E2E。
• Wave 6 遗留发现跟进：refresh 黑名单可观测性 + egress/outboundhttp 审计四项产品发现 #2064 五项低风险发现仍保持 Open，不在本 PR 范围。

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: cd317e6d-cd3e-4fa7-b175-4a2934a1b5ef

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}