Đối chiếu Quy trình Spec-Driven Workflow với các Workflow hiện có
Quy trình này không thay thế bất kỳ workflow nào đang có, mà hoạt động như một nhạc trưởng điều phối (Orchestrator) gắn kết các workflow đơn lẻ lại với nhau một cách chặt chẽ.
Kết luận: Hoàn toàn không xung đột (0% Conflict).
1. Bản đồ phối hợp giữa Quy trình mới và các Workflow hiện có
Tất cả các workflow đã cài đặt đều tìm thấy vị trí tự nhiên của mình trong chu trình Spec-Driven:
[BẮT ĐẦU TASK: SPEC-DRIVEN WORKFLOW]
│
┌────────────────────────┴────────────────────────┐
▼ ▼
[Tính năng mới / Refactor lớn] [Sửa 1 bug cụ thể]
│ │
├─▶ Đọc specs//spec.md └─▶ Kích hoạt: /6step_workflow
├─▶ Dùng /check-logic để thẩm định luồng
│
▼
[PHASE 2: CORE & LOGIC] ──────▶ Kích hoạt Skill: erp-tdd (Viết Vitest trước)
│
▼
[PHASE 3: UI / UX] ───────────▶ Áp dụng: auto-save-form.md & ops-ui-tactical-blueprint
│
▼
[PHASE 5: KIỂM THỬ] ──────────▶ Kích hoạt: browser-automation (E2E & visual proof)
│
▼
[NGHIỆM THU & PUSH] ──────────▶ Kích hoạt: /git-workflow (Branch Guard & Push an toàn) 2. Đối chiếu chi tiết với từng Workflow hiện có
| Workflow hiện tại | Vai trò trước đây | Khi có Spec-Driven: có xung đột không? | Sự cộng hưởng |
|---|---|---|---|
| AI_WORKFLOW.md (Hiến pháp) | Quy định 5 Pha và các token duyệt (APPROVE PHASE 2, APPROVE PHASE 3...) | Kế thừa 100%, không đổi một token nào. | Thay vì in kế hoạch ra chat rồi bị trôi mất, nay kế hoạch được lưu vào .changes/active/<task>/tasks.md. |
| /6step_workflow | Săn và sửa một lỗi cụ thể (Audit → Reproduce → Root Cause → Fix) | Không xung đột. Giữ nguyên dùng cho bugfix nhanh. | Khi gặp bug phức tạp liên quan đến tính sai công nợ/tồn kho, 6-step có thể lấy specs/ làm chuẩn đối chiếu. |
| /check-logic | Rà soát lỗi nghiệp vụ dệt may, tính nhất quán tài chính | Hỗ trợ đắc lực. | Trước đây /check-logic phải tự suy luận từ code. Nay nó có file specs/yarn/spec.md làm chuẩn đối chiếu để bắt lỗi logic chính xác hơn. |
| /auto-save-form | Cơ chế lưu nháp draft & phục hồi form | Tích hợp vào Phase 3 (UI). | Khi làm form nhập sợi, kịch bản lưu nháp đã được ghi sẵn trong specs/yarn/spec.md (Scenario Lưu nháp). |
| /browser-automation | Mở trình duyệt kiểm tra giao diện & AI chat drawer | Tích hợp vào Phase 3 & 5. | Dùng để chạy kiểm chứng trực quan các Scenario đã định nghĩa trong Spec. |
| /git-workflow | Tạo nhánh, kiểm tra typecheck, commit & push | Tích hợp ở bước cuối cùng (Archive). | Sau khi gõ APPROVE MERGE, AI tự kích hoạt git-workflow để push code an toàn qua Branch Guard. |
3. Hướng dẫn phân định: khi nào dùng lệnh nào?
| Tình huống công việc | Workflow sử dụng |
|---|---|
| Khi muốn làm tính năng mới hoặc mở rộng module | Spec-Driven Workflow (yêu cầu AI lập proposal trong .changes/). |
| Khi gặp bug phát sinh cần điều tra sửa gấp | /6step_workflow (sửa nhanh theo 6 bước root cause). |
| Khi cần kiểm tra xem luồng nghiệp vụ có hở logic hay không | /check-logic (đối chiếu với các kịch bản trong specs/). |
| Khi cần đẩy code lên GitHub | /git-workflow (đảm bảo không bị chặn bởi Branch Guard). |
Hệ thống chỉ có thêm "bộ nhớ dài hạn" (specs/ và .changes/), hoàn toàn không bị gãy hay xung đột với bất kỳ thói quen nào đã thiết lập.