jackyu66gitandCursor
19d3cd5945
绑定 ESS 双轨治理，拆分超大 H5 页与 Go 引擎，抽出 membership 服务， 并将 star/fortune 重命名为 outlook（JSON 双写兼容）；同时修复 /psy API 代理与首页 + 菜单层级。 Co-authored-by: Cursor <cursoragent@cursor.com>
33 lines
1.5 KiB
Markdown
33 lines
1.5 KiB
Markdown
# 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/` Accepted；ESS 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 治理重构」诉求，否决。
|