jackyu66gitandCursor
27f27a1cb2
Mark WAVE0 FROZEN CANDIDATE for Human Review; docs + .ai domain/product only — no apps or migrations. Co-authored-by: Cursor <cursoragent@cursor.com>
75 lines
2.0 KiB
Markdown
75 lines
2.0 KiB
Markdown
# Contract-First Rules（Ops Platform · Wave 0）
|
||
|
||
> Engineering Loop（v1.1 FROZEN）= **通用执行框架**
|
||
> Ops Platform = **被 Loop 执行的一个 Domain**
|
||
> **禁止**因产品变复杂而改 Loop 内核。
|
||
|
||
Status: `Draft` → Human Review
|
||
|
||
---
|
||
|
||
## Start Authorization
|
||
|
||
- Wave / ECR 进入执行须 **Human 明文 Start Authorization**。
|
||
- Loop **不自启**。
|
||
|
||
---
|
||
|
||
## 允许 / 禁止路径（Wave 0）
|
||
|
||
| 允许 | 禁止 |
|
||
|------|------|
|
||
| `docs/**` | `apps/**` |
|
||
| `.ai/domain/**` | `internal/service/**`（经 apps/api） |
|
||
| `.ai/product/**`（feature-map / lexicon / feature-spec 登记） | database migration |
|
||
| | frontend / backend implementation |
|
||
| | 开实现向 ECR coding |
|
||
| | 真支付 · UGC 社区实现 |
|
||
|
||
---
|
||
|
||
## 契约栈（冻结语义）
|
||
|
||
```text
|
||
Capability → BC → Domain → API (+ contract_diff) → AC(四类) → ECR → Evidence → Archive
|
||
```
|
||
|
||
任一层缺失 → Architect **停**；不得 Builder。
|
||
|
||
---
|
||
|
||
## 必需 Artifact（实现向 ECR）
|
||
|
||
1. Capability 归属（L0）
|
||
2. boundary-rules 兼容声明（L1）
|
||
3. glossary 词已登记（L2）
|
||
4. OpenAPI + BD（L3）
|
||
5. **`docs/CONTRACT_DIFF/ECR-xxx.yaml`（P0 必需）**
|
||
6. Functional / Security / Performance / Observability AC（L4）
|
||
7. TEST_REPORT 映射 AC-ID
|
||
|
||
---
|
||
|
||
## Loop 角色对齐（不改 Loop）
|
||
|
||
| Loop 角色 | 本 Domain 动作 |
|
||
|-----------|----------------|
|
||
| Architect | 写 L0–L4 + boundary + glossary + contract_diff |
|
||
| Contract Gate | Human Approve + ess-validate architect |
|
||
| Builder | 仅 Change Boundary 内实现 |
|
||
| Validator | AC + contract_diff + tests |
|
||
| Guardian | boundary-rules · 无架构回归 |
|
||
| Final Approval | Closed · TRACEABILITY · Archive |
|
||
|
||
---
|
||
|
||
## Wave 0 完成定义
|
||
|
||
- `docs/WAVE0/**` 锁定清单齐全
|
||
- `.ai/domain/{boundary-rules,glossary,entity-catalog}.md|yaml` 已同步
|
||
- feature-map §7 已指向 Contract-First
|
||
- `VALIDATION_REPORT.md` PASS
|
||
- **无** apps 变更
|
||
|
||
下一闸门：Human Review Wave 0 → 再授权 **ECR-013A**（仅 RBAC）。
|