digital-psychology/.ai/workflow.md

Workflow — Feature Development Flow

默认循环。环境：本机 Go/Vite + deps-only Docker（见 development.md）。

Receive task
    ↓
1. Understand
   - feature-map / lexicon / user-journey / page-tree（产品）
   - **feature-design.md + feature-spec/<id>.md**（功能详细设计；缺失则先补）
   - domain-map / erd / OpenAPI（数据与契约）
    ↓
2. Feature Spec（强制）
   - 新功能或重大行为：复制 _TEMPLATE → 填满 §1–§13
   - 对照 Spec §4/§6/§7/§9/§12；playbook: feature-spec
    ↓
3. Design（技术契约）
   - Update OpenAPI / erd / migration 草案（对齐 Spec §8/§9）
   - ADR if stack/API style changes
   - 更新 Spec §14 Implementation Notes
    ↓
4. Implement
   - Backend（service 竖切）→ Frontend
   - Follow patterns + playbooks
    ↓
5. Verify
   - Spec §12 Acceptance + definition-of-done.md（非仅 build）
   - commands（L0/L1/L2 as required）
   - Review Report + checklist
    ↓
6. Document
   - OpenAPI / erd / Spec Gaps / p1-status 标签若变化
    ↓
Commit（Conventional Commits，one concern）

Architecture Check

1. Reverse Accepted ADR? → ASK / new ADR.
2. Correct layer? Handler / Service / Repository?
3. Domain words = .ai/domain.md + lexicon for UI?
4. Envelope still {code,message,data}?
5. Local workflow still host runtime（非 Docker-only 编码）?

Stop conditions

• Unclear requirement → ASK FIRST
• Need GraphQL / new auth scheme / new datastore → ADR before coding
• Urge to “just ALTER TABLE” → write migration instead

Playbooks

Prefer: feature-spec · add-api · new-page · new-table · payment · login