绑定 ESS 双轨治理,拆分超大 H5 页与 Go 引擎,抽出 membership 服务, 并将 star/fortune 重命名为 outlook(JSON 双写兼容);同时修复 /psy API 代理与首页 + 菜单层级。 Co-authored-by: Cursor <cursoragent@cursor.com>
1.5 KiB
1.5 KiB
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
- 产品 / 领域 / Lexicon / Feature Spec / DoD / 架构冻结 / 安全编码:以
.ai/为唯一权威。 - 变更分级 / 角色(Architect·Engineer·Reviewer·Release)/ ECR·Task·Handoff·validate:以 ESS + 根目录
docs/为权威。 - L2+ 行为或结构重构:必须同时满足
- Active Feature Spec(若涉及产品行为;纯结构重构可用 PRODUCT_SPEC「行为冻结」)
- Approved ECR under
docs/ECR/
- L3 栈或包边界:另需
.ai/adr/Accepted;ESS ENGINEERING_SPEC 引用该 ADR。 - 禁止将 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 治理重构」诉求,否决。