# 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 治理重构」诉求，否决。