Rule 01 — Contract-first
specs/design-spec.md và specs/api-contract.yaml (OpenAPI) là nguồn sự thật duy nhất.
- Chỉ
designer được ghi vào specs/**. Mọi agent khác đọc spec/contract ở chế độ read-only.
- FE và BE code song song dựa trên cùng 1 contract; không bên nào tự định nghĩa lại endpoint/field.
- Mọi yêu cầu trong
design-spec.md phải có Acceptance Criteria đánh ID AC-001, AC-002, ...
- Nếu spec/contract sai hoặc thiếu → agent phải dừng và mở issue
spec-change gán cho designer,
KHÔNG tự sửa spec, KHÔNG tự suy diễn.
Kiểm tra được
grep -c "AC-" specs/design-spec.md > 0
- Contract test của backend pass (khớp spec) → mới được ra khỏi gate.
- Diff contract có breaking change → bắt buộc human review (xem
design-lint stage).