Files
jackyu66gitandCursor 0f320e040b feat: P1 profile/portrait API and freeze local-dev environment
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>
2026-08-02 16:24:57 +08:00

1.5 KiB

AI System Evolution Roadmap

Do not build everything at once. Rules have maintenance cost.

Phase 1 — Now (shipped)

  • Rules: constitution, architecture, domain, coding, api, database, ui, …
  • Environment layer (FROZEN): environment.md · development.md · docker.md · deployment.md · commands.md
  • ADR, patterns, examples, playbooks
  • Review / DoD / checklists / forbidden / workflow / file-map
  • ai-contract.md
  • Cursor runtime: .cursor/* → symlink → .ai/ (no content copy)

Invest next time in product implementation, not more meta-rules:

产品冻结 → Domain → ERD → OpenAPI → 页面路由 → P1 编码

Do not expand the engineering-spec layer unless a repeated AI failure demands it.

Phase 2 — When the codebase grows

Add only when pain appears:

Item Why wait
anti-patterns/ Useful after real mistakes accumulate
metrics.md Numbers matter once CI exists
quality-gates.md Wire when lint/test gates are real
memory/ (known-bugs, tech-debt, todo) Fill from actual incidents

Phase 3 — Multi-agent / heavy automation

Item Why wait
graph/domain.yaml Knowledge graph for relation reasoning
mcp/*.json Structured context servers
skills/<feature>/ Packaged feature kits (login, payment, …)

Markdown remains human-readable; JSON/YAML for machines — introduce when agents > 1 or retrieval latency hurts.

Rule of thumb

If adding a rule file does not prevent a repeated AI failure this week, do not add it.