Sơ đồ pipeline¶
┌──────────────────────────────┐
│ [User request] / /kickoff │
└──────────────┬───────────────┘
▼
┌────────────────────────────────┐
│ ORCHESTRATOR │
│ chẻ issue · phân vai · board │
└────────────────┬───────────────┘
▼
┌────────────────────────────────┐
│ DESIGNER │
│ design-spec + contract + data │
└────────────────┬───────────────┘
▼
╔═══════════════════════════╗
║ 👤 HUMAN APPROVE (design) ║ ← gate bắt buộc
╚═══════════════════════════╝
▼
┌────────────────────┴────────────────────┐
▼ ▼
┌───────────────────────┐ ┌───────────────────────┐
│ DEV-FRONTEND │ │ DEV-BACKEND │
│ code UI · build/lint │ (song song) │ API · schema · unit │
│ component test │◄────needs─────►│ contract test │
└──────────┬────────────┘ └──────────┬────────────┘
│ gate: fe-verify │ gate: be-verify
└────────────────────┬───────────────────┘
▼
┌────────────────────────────────┐
│ TESTER │
│ test từ AC · e2e · report │
│ bug có repro nếu fail │
└────────────────┬───────────────┘
▼
┌────────────────────────────────┐
│ DOCS-WRITER │
│ docs/features/<issue>-<slug> │
└────────────────┬───────────────┘
▼
┌────────────────────────────────┐
│ CI/CD (GitHub Actions) │
│ design-lint → FE ∥ BE → test │
└────────────────┬───────────────┘
▼
┌──────────────────────────────┐
│ staging (auto trên main) │
└──────────────┬───────────────┘
▼
╔═══════════════════════════╗
║ 👤 HUMAN APPROVE (prod) ║ ← gate bắt buộc
║ chỉ đúng SHA đã review ║
╚═══════════════════════════╝
▼
┌──────────────────────────────┐
│ prod → board-sync: │
│ gắn label status::deployed │
└──────────────────────────────┘
Vòng lặp (loop) & escalate¶
Mỗi gate có thể lặp lại tối đa MAX_FIX_ITERATIONS (mặc định 3):
fe-verify fail ──► dev-frontend sửa ──► fe-verify ──► (lặp)
│
└── vượt ngưỡng ──► label needs-human ──► 👤
Khi vượt ngưỡng hoặc gặp: breaking change contract, dependency lớn, lệnh phá hủy, secret lộ, test flaky → dừng + hỏi người (Rule 07).
Chỗ con người can thiệp¶
| Điểm | Hành động |
|---|---|
| Sau design | approve/reject design-spec + contract |
needs-human / blocked |
đọc nguyên nhân, quyết hướng xử lý |
| Deploy prod | bấm duyệt đúng commit SHA (release-gate) |
| Lệnh phá hủy / secret lộ | xử lý ngay (Rule 08) |
Mọi thứ khác: agent tự chạy trong giới hạn ngân sách + vòng lặp.