4. Bức tranh framework quy trình

Chương 3 dạy sâu một workflow. Chương này trả lời câu hỏi người học hay gặp ngay sau đó: "Còn OpenSpec, Spec Kit, BMAD, GSD... thì sao? Mình có đang chọn sai không?"

Câu trả lời ngắn: các framework này cùng giải một bài toán là bắt agent hiểu đúng việc trước khi viết code, rồi kiểm lại sau khi viết. Chúng khác nhau ở độ nặng: viết bao nhiêu tài liệu, dừng lại cho người duyệt bao nhiêu lần.

Tiêu chí chọn: cái giá của việc làm sai

Đừng chọn theo số sao GitHub hay độ hot trên mạng. Hỏi một câu: nếu agent hiểu sai yêu cầu, mình mất bao nhiêu?

Cái giá nếu làm sai	Ví dụ	Mức quy trình hợp lý
Rẻ: sửa trong vài phút	Đổi màu nút, sửa lỗi chính tả, bug có test tái hiện	Chỉ CLAUDE.md/AGENTS.md, đọc diff là đủ
Vừa: mất một buổi làm lại	Một tính năng mới cỡ vừa trong app có sẵn	Superpowers (spec ngắn + plan + TDD)
Đắt: sai thì kéo theo nhiều thứ	Đổi schema dữ liệu, thay đổi chạm nhiều module, nhiều người cùng làm	OpenSpec, Spec Kit, BMAD, GSD Core: nhiều tài liệu hơn, nhiều gate duyệt hơn

Quy trình nặng không làm agent thông minh hơn. Nó chỉ bắt bạn nghĩ kỹ và ghi lại trước khi agent chạy. Việc rẻ mà dùng quy trình nặng thì tốn thời gian và token vô ích; việc đắt mà dùng quy trình nhẹ thì trả giá ở khâu làm lại.

Bảng so sánh

Framework	Trọng tâm	Độ nặng	Gate duyệt	Hợp với
Chỉ CLAUDE.md/AGENTS.md	Ghi quy ước dự án, lệnh, định nghĩa "xong". Không có quy trình riêng	Nhẹ nhất	Do bạn tự đặt, thường chỉ là đọc diff	Việc nhỏ, rõ ràng, sai thì sửa nhanh
Superpowers	Kỷ luật làm việc: brainstorm → spec → plan → thực thi bằng subagent kèm TDD → review → hoàn tất nhánh	Nhẹ đến vừa	Duyệt spec, duyệt plan, review cuối	Một dev làm tính năng cỡ vừa, muốn có TDD và review sẵn
OpenSpec	Quản lý từng thay đổi bằng proposal và spec nằm trong repo	Vừa	Duyệt proposal trước khi apply, archive sau khi xong	Codebase có sẵn, cần lưu vết vì sao từng thay đổi được làm
Spec Kit	Spec-driven đầy đủ: constitution → specify → plan → tasks → implement → converge	Nặng	Mỗi bước sinh một tài liệu để duyệt	Dự án mới, cần tài liệu đầy đủ, nhiều người đọc spec
BMAD	Quy trình nhiều pha: Clarify → Plan → Build & verify, rồi học lại và quay về Plan	Vừa đến nặng	Cuối mỗi pha	Dự án cần làm rõ yêu cầu kỹ trước khi lập kế hoạch
GSD (GSD Core)	Mỗi pha: discuss → plan → execute (subagent chạy song song theo đợt) → verify → ship	Vừa đến nặng	Cuối mỗi pha	Dự án nhiều pha, dùng nhiều tool agent khác nhau
Ralph loop	Cơ chế lặp, không phải quy trình lập kế hoạch: đưa lại cùng một prompt cho tới khi xong	Thiết lập nhẹ, chi phí chạy có thể cao	Không có gate giữa chừng; chỉ có tiêu chí xong và giới hạn số vòng	Việc đã có spec/plan và có test tự kiểm

Đọc bảng theo cột "Gate duyệt": càng nhiều gate thì càng chậm, nhưng càng ít khả năng agent chạy xa theo hướng sai.

Từng framework

Chỉ CLAUDE.md / AGENTS.md

Không cài gì thêm. Bạn viết quy ước dự án vào AGENTS.md (dùng chung cho mọi agent) và để CLAUDE.md nạp nó bằng @AGENTS.md. Starter của khóa học làm đúng như vậy: practice/starter/CLAUDE.md chỉ có dòng @AGENTS.md và vài lưu ý riêng cho Claude Code.

Đây là nền cho mọi framework phía dưới, không phải lựa chọn loại trừ. Chi tiết: CLAUDE.md / AGENTS.md.

Superpowers

Plugin cho Claude Code (cũng có cho Codex). Gồm các skill tự kích hoạt theo ngữ cảnh: brainstorming → writing-plans → subagent-driven-development hoặc executing-plans kèm TDD → review → finishing. Bạn không phải nhớ lệnh; mô tả việc cần làm là agent tự vào quy trình.

/plugin install superpowers@claude-plugins-official

Phiên bản hiện tại v7.0.1 (21/10/2026). Đây là workflow chính của khóa học, xem từng bước ở chương 3.

OpenSpec

Mỗi thay đổi là một "change" có proposal và spec trong repo. Làm xong thì archive, để spec của dự án luôn phản ánh hiện trạng.

npm install -g @fission-ai/openspec@latest
openspec init

Quy trình trong agent: /opsx:explore → /opsx:propose → /opsx:apply → /opsx:archive. Phiên bản v1.15.0.

Spec Kit (GitHub)

Bộ công cụ spec-driven của GitHub. Mỗi bước sinh một tài liệu riêng, từ "hiến pháp" dự án tới danh sách task.

uv tool install specify-cli
specify init <thư-mục> --integration <agent>

Quy trình: /speckit-constitution → /speckit-specify → /speckit-plan → /speckit-tasks → /speckit-implement → /speckit-converge. Lệnh dùng dấu gạch ngang, không phải dấu chấm. Phiên bản v1.2.3.

BMAD-METHOD

Quy trình theo pha: Clarify → Plan → Build & verify, sau đó "Learn & adjust" quay lại Plan.

npx bmad-method install

Phiên bản v6.12.4. Cần Node 20.12+ và Python 3.10+.

GSD → GSD Core

Repo gốc gsd-build/get-shit-done đã archived (bản cuối v1.42.3), README của nó chỉ sang dự án kế nhiệm là GSD Core (open-gsd/gsd-core). Dùng GSD Core, đừng cài bản cũ.

npx @opengsd/gsd-core@latest

Bắt đầu bằng /gsd-new-project. Mỗi pha đi qua discuss → plan → execute → verify → ship. Hỗ trợ Claude Code, Codex, OpenCode, Copilot, Cursor, Windsurf. Phiên bản v1.18.0.

Ralph loop

Không phải quy trình lập kế hoạch mà là cách chạy: một Stop hook chặn agent kết thúc và đưa lại cùng một prompt, tới khi agent in ra chuỗi báo xong hoặc chạm giới hạn số vòng. Ralph loop thường dùng sau khi đã có spec và plan từ một framework ở trên.

/plugin install ralph-loop@claude-plugins-official

Cách dùng và rào chắn: chương 5.

Số liệu tham khảo: một bài so sánh của cộng đồng

Chỉ mang tính tham khảo

Số liệu dưới đây từ bài viết của Felipe Fontoura (đăng 11/07/2026, cập nhật 13/10/2026). Đây là nguồn cộng đồng, không phải đo đạc chính thức:

• Chỉ một lần chạy (n=1) cho mỗi framework, trên một feature duy nhất.
• Chạy với Opus 5.5, Claude Code 2.1.296.
• Các framework là phiên bản cũ hơn hiện tại.
• GSD không có trong bài so sánh.

Framework (bản đã thử → bản hiện tại)	Thời gian agent	Chi phí	Acceptance đạt
OpenSpec (1.14.1 → 1.15.0)	277 giây	$2,16	12/13
BMAD (6.12.2 → 6.12.4)	217 giây	$1,89	13/13
Spec Kit (1.2.0 → 1.2.3)	473 giây	$2,84	13/13
Superpowers (7.0.0 → 7.0.1)	40 giây	$0,33	13/13

Bài cũng ghi hai số không có lợi cho Superpowers: agent viết 8 test (OpenSpec 10, BMAD 10, Spec Kit 12) và không có file spec riêng (0 dòng, so với 88–690 dòng). Nhanh và rẻ một phần vì làm ít tài liệu hơn.

Nên rút ra gì: với một feature cỡ vừa, quy trình nặng tốn thời gian và tiền hơn nhiều mà kết quả acceptance không tốt hơn. Không nên rút ra: "Superpowers luôn tốt nhất". Một lần chạy không đủ để kết luận, và với việc đắt giá (xem bảng đầu chương), tài liệu dày hơn chính là thứ bạn muốn mua. Tác giả bài viết cũng kết luận theo hướng đó: chọn mức quy trình theo cái giá của việc làm sai, và có thể kết hợp (ví dụ OpenSpec để quản lý thay đổi, Superpowers để thực thi).

Khóa học chọn gì

Khóa học dùng Superpowers trên Claude Code làm workflow chính, vì:

• Đủ nhẹ để chạy trọn một vòng trong buổi lab.
• Có sẵn các gate cần thiết (duyệt spec, duyệt plan, review) và TDD.
• Cài một lệnh, không cần thêm CLI hay runtime khác.

Khi đã quen một quy trình, chuyển sang framework khác chủ yếu là học tên lệnh mới; tư duy "spec → plan → thực thi có test → review" vẫn giữ nguyên. Bắt đầu ở chương 3: Workflow chính.

Nguồn

• Superpowers: https://github.com/obra/superpowers
• OpenSpec: https://github.com/Fission-AI/OpenSpec
• Spec Kit: https://github.com/github/spec-kit
• BMAD-METHOD: https://github.com/bmad-code-org/BMAD-METHOD
• GSD (archived): https://github.com/gsd-build/get-shit-done
• GSD Core: https://github.com/open-gsd/gsd-core
• Ralph loop plugin: https://github.com/anthropics/claude-plugins-official/tree/main/plugins/ralph-loop
• CLAUDE.md import @AGENTS.md: https://code.claude.com/docs/en/memory
• Bài so sánh (cộng đồng): https://felipefontoura.com/articles/spec-driven-development-tools-compared/