Files
digital-psychology/.ai/adr/0007-ess-ai-dual-track.md
jackyu66gitandCursor 19d3cd5945 refactor(ECR-001): 接入 ESS 并完成结构对齐 Phase A–E
绑定 ESS 双轨治理,拆分超大 H5 页与 Go 引擎,抽出 membership 服务,
并将 star/fortune 重命名为 outlook(JSON 双写兼容);同时修复 /psy API 代理与首页 + 菜单层级。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-05 17:51:40 +08:00

1.5 KiB
Raw Permalink Blame History

ADR-0007 — ESS 与 .ai/ 双轨治理

  • Status: Accepted
  • Date: 2026-08-05
  • Tags: process, ess, agents

Context

仓库已有成熟的 .ai/ AI Engineering System(领域、Feature Spec、DoD、架构冻结)。
2026-08-05 绑定 engineering-spec-system v1.0,引入 docs/ECR|TASKS|HANDOFF|STATE 与角色门禁。
若两套文档并行且无优先级,Agent 会冲突或重复发明规则。

Decision

  1. 产品 / 领域 / Lexicon / Feature Spec / DoD / 架构冻结 / 安全编码:以 .ai/ 为唯一权威。
  2. 变更分级 / 角色(Architect·Engineer·Reviewer·Release/ ECR·Task·Handoff·validate:以 ESS + 根目录 docs/ 为权威。
  3. L2+ 行为或结构重构:必须同时满足
    • Active Feature Spec(若涉及产品行为;纯结构重构可用 PRODUCT_SPEC「行为冻结」)
    • Approved ECR under docs/ECR/
  4. L3 栈或包边界:另需 .ai/adr/ AcceptedESS ENGINEERING_SPEC 引用该 ADR。
  5. 禁止将 ESS 整树复制进本仓;仅保留 Profile / wrappers / 过程工件。

Consequences

  • Agent 会话:先 docs/PROJECT_PROFILE.md,再按 AGENTS.md 加载 .ai/
  • 冲突时:用户可见语义与完成标准听 .ai/;能否开工听 ECR/Role。
  • 后续重构按 ECR-001 分 Phase,禁止无合同大爆炸重写。

Alternatives considered

  • 用 ESS 替换 .ai/:丢弃已验证的 lexicon/DoD/feature-spec,成本高,否决。
  • 只用 .ai/ 忽略 ESS:无法满足「用 ESS 治理重构」诉求,否决。