jackyu66gitandCursor
bd22d9dddd
落地 synastry/star/ask API 与 H5 页面，补齐 cece-frontend-re complete-design 证据文档，并加入 Android 模拟器截图抓取脚本。 Co-authored-by: Cursor <cursoragent@cursor.com>
43 lines
1.8 KiB
Markdown
43 lines
1.8 KiB
Markdown
# AI Contract
|
||
|
||
Highest operational contract for every agent session.
|
||
|
||
## Before coding
|
||
|
||
MUST read:
|
||
|
||
1. `.ai/constitution.md`
|
||
2. `.ai/architecture.md`
|
||
3. `.ai/domain.md` (+ `domain/domain-map.md` when touching models/API)
|
||
4. `.ai/definition-of-done.md`（完成标准；开始前知道何谓 Done）
|
||
5. `.ai/coding.md`
|
||
6. Task-relevant: `api.md` / `database.md` / `ui.md` / `security.md` / `testing.md` / `product/lexicon.md` + `product/feature-map.md` + **`product/feature-design.md`** + **`product/feature-spec/<id>.md`**（该功能 Spec；§4 User Flow、§7 Rules、§9 API、§12 Acceptance 必须非空）
|
||
7. Run/dev tasks: `environment.md` + `development.md`（部署/镜像任务才读 `deployment.md` / `docker.md`）
|
||
8. UI tasks: `design/design-system.md` + `design/component-catalog.md` + `design/platform/*`
|
||
9. Competitor / reverse-engineering tasks: `design/reverse-engineering-spec.md`（STEP 1–18 · Evidence First；禁止 Demo 式省略）
|
||
10. Relevant ADR under `.ai/adr/` if changing stack or style
|
||
|
||
## After coding
|
||
|
||
MUST:
|
||
|
||
1. Verify `.ai/definition-of-done.md` — **Done ≠ Code Complete**
|
||
2. Run / follow `.ai/review.md` and print **Review Report**（DoD §7）
|
||
3. Use matching checklist under `.ai/checklists/`
|
||
4. Prefer verifying with `.ai/commands.md` (build/test/health)
|
||
5. If P1 scope: update or respect labels in `product/p1-status.md`（当前为 **P1 Complete**；扩行为须新 Spec）
|
||
|
||
## Never
|
||
|
||
- Guess API shape
|
||
- Guess DB schema
|
||
- Guess product requirement
|
||
- Code new/changed feature behavior without Feature Spec（`product/feature-design.md`）
|
||
- Invent endpoints, tables, or domain words not in `.ai/domain.md` / OpenAPI / task
|
||
- Silently reverse an Accepted ADR
|
||
- Default local workflow to full-stack Docker / rebuild app images on every code change
|
||
|
||
## If unclear
|
||
|
||
**ASK FIRST.** Do not invent. Do not “assume and continue”.
|