jackyu66gitandCursor
0f320e040b
Add host-first environment contracts (Local vs CI vs Prod), deps-only compose, and the Profile → Portrait → deep-access mock payment slice with device identity and auto-migrate on API startup. Co-authored-by: Cursor <cursoragent@cursor.com>
39 lines
1.2 KiB
Markdown
39 lines
1.2 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/coding.md`
|
||
5. Task-relevant: `api.md` / `database.md` / `ui.md` / `security.md` / `product/lexicon.md` + `product/feature-map.md`
|
||
6. Run/dev tasks: `environment.md` + `development.md`（部署/镜像任务才读 `deployment.md` / `docker.md`）
|
||
7. UI tasks: `design/design-system.md` + `design/component-catalog.md` + `design/platform/*`
|
||
8. Relevant ADR under `.ai/adr/` if changing stack or style
|
||
|
||
## After coding
|
||
|
||
MUST:
|
||
|
||
1. Run / follow `.ai/review.md` and print Review block
|
||
2. Verify `.ai/definition-of-done.md`
|
||
3. Use matching checklist under `.ai/checklists/`
|
||
4. Prefer verifying with `.ai/commands.md` (build/test/health)
|
||
|
||
## Never
|
||
|
||
- Guess API shape
|
||
- Guess DB schema
|
||
- Guess product requirement
|
||
- 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”.
|