Workflow brainstorm → plan → cook → ship với AgentKit: quy trình dev với AI có kiểm soát (2026)

· Tác giả: Jasmine - dev dùng Claude Code và AgentKit hằng ngày, chạy pipeline này trên các dự án thật.

⚠️ AgentKit nào? Phân biệt với OpenAI AgentKit

Trước khi đi vào quy trình, phải nói rõ để bạn không tìm nhầm. Bài này nói về AgentKit cho Claude Code - bộ kit skills, agents và workflow tại agentkit.best, dùng qua CLI ak. Đây là bản kế nhiệm của Claude Kit (lệnh cũ ck đã đổi thành ak).

Nó khác hoàn toàn với OpenAI AgentKit - bộ công cụ của OpenAI (Agent Builder, ChatKit, Connector Registry) ra mắt cuối 2025 để xây agent trên nền OpenAI. Hai thứ trùng tên nhưng không liên quan: một bên đóng gói quy trình cho Claude Code, một bên là nền tảng dựng agent của OpenAI. Nếu bạn gõ "agentkit workflow" và thấy kết quả về Agent Builder kéo-thả node, đó là sản phẩm OpenAI - không phải thứ đang bàn ở đây. Cũng đừng nhầm với agentkits.net hay docs cũ docs.claudekit.cc (đã chuyển sang docs.agentkit.best).

brainstorm → plan → cook → ship là gì?

Đây là một pipeline 4 phase để làm việc với AI coding agent, trong đó mỗi phase kết thúc bằng một gate kiểm duyệt của con người trước khi phase kế tiếp bắt đầu. Mục tiêu là chặn thói quen phổ biến: ném một prompt mơ hồ cho AI rồi để nó vừa đoán yêu cầu vừa viết code - cách nhanh nhất dẫn tới rework.

Bốn phase như sau:

• Brainstorm - hội tụ ý tưởng: chốt outcome mong muốn, ràng buộc, non-goals và tiêu chí chấp nhận. Chưa viết dòng code nào.
• Plan - biến outcome thành kế hoạch chi tiết: task đánh số, quyết định kiến trúc, thứ tự thực thi. Con người duyệt kế hoạch.
• Cook - thực thi theo plan đã duyệt, từng task một, có thể chạy song song bằng subagents, luôn giám sát diff.
• Ship - review toàn bộ diff, tạo commit theo quy ước, mở PR, chạy test/build và verify trước khi merge.

Nếu bạn từng nghe về spec-driven development là gì (spec → plan → code), pipeline này gần giống nhưng thêm hai gate ở hai đầu: brainstorm để hội tụ ý tưởng trước khi viết spec, và ship để đóng vòng release sau khi code xong. Nói cách khác, nó bao trọn từ "ý tưởng còn mơ hồ" đến "code đã lên nhánh chính".

Vì sao cần quy trình 4 phase (thay vì để AI code bừa)?

Câu trả lời ngắn: vì vibe coding không kiểm soát rất tốn tiền sửa. Khi bạn để agent tự đoán yêu cầu, nó thường bám vào một giả định sai ngay từ đầu, rồi viết hàng trăm dòng dựa trên giả định đó. Bạn phát hiện ra khi đã quá muộn, và phải quay lại gỡ. Đây là vòng lặp rework kinh điển.

Muốn hiểu gốc rễ, xem vibe coding là gì và cách tránh AI-slop - code chạy được nhưng thừa thãi, khó bảo trì, đầy pattern lặp. Ba lỗi hay gặp nhất khi bỏ quy trình:

• Sai giả định: agent hiểu nhầm yêu cầu và không ai chặn nó lại kịp.
• Rework: code viết ra phải bỏ vì lệch outcome.
• AI-slop: agent thêm abstraction, file, và "tính năng" không ai cần.

Nguyên tắc đơn giản: năm phút cấu trúc ý tưởng ở đầu thường tiết kiệm ba mươi phút gỡ rối ở cuối. Gate review giữa các phase chính là chỗ để bạn bắt lỗi khi nó còn rẻ. Đây không phải quan liêu hoá - bạn vẫn để AI làm phần nặng, chỉ là đặt điểm dừng đúng chỗ.

Có một lý do sâu hơn về mặt kỹ thuật: chi phí sửa một lỗi tăng theo cấp số nhân qua từng phase. Một giả định sai bắt được ở phase Brainstorm chỉ tốn một câu chỉnh lại; cũng giả định đó lọt tới phase Cook thì đã kéo theo cả chuỗi code phụ thuộc; và nếu nó chỉ lộ ra sau khi Ship, bạn phải revert, viết lại, và giải thích trong PR. Pipeline bốn phase không làm bạn code nhanh hơn ở từng bước - nó làm bạn ít phải quay lại hơn, và với AI agent thì đó mới là khoản tiết kiệm thật.

Phase 1 - Brainstorm: chốt outcome trước khi code

Phase đầu tiên trả lời một câu duy nhất: chúng ta thực sự muốn xây cái gì, và khi nào thì coi là xong? Với AgentKit, bạn khởi động bằng:

/ak:brainstorm thêm tính năng đăng nhập bằng Google cho app hiện tại

Mô hình ở đây là Diverge → Converge. Đầu tiên agent bung ra nhiều hướng tiếp cận, đặt câu hỏi làm rõ, nêu các đánh đổi. Sau đó bạn cùng nó hội tụ về một lựa chọn. Output cuối của phase brainstorm nên gồm bốn thứ rõ ràng:

• Outcome: kết quả mong muốn, mô tả bằng hành vi quan sát được.
• Ràng buộc: stack, thư viện, quy ước sẵn có phải tuân thủ.
• Non-goals: những thứ cố tình không làm lần này (chống scope creep).
• Tiêu chí chấp nhận: dấu hiệu để biết đã đạt.

Lưu ý quan trọng: đừng để agent nhảy vào code ở phase này. Nếu nó bắt đầu đề xuất diff, kéo nó lại - brainstorm là để suy nghĩ, không phải để gõ. Gate của bạn: đọc bốn mục trên, chỉnh cho khớp ý mình, rồi mới cho qua.

Phase 2 - Plan: biến outcome thành kế hoạch chi tiết

Có outcome rồi, phase Plan biến nó thành một bản kế hoạch thực thi mà cả bạn lẫn agent đều nhìn vào cùng một chỗ:

/ak:plan

Nếu không dùng AgentKit, bạn có thể đạt hiệu quả tương tự bằng plan mode có sẵn của Claude Code (Anthropic - xem tài liệu Claude Code, truy cập 08/2026). Điểm mấu chốt là kế hoạch phải cụ thể tới mức thực thi được:

• Task đánh số: từng bước nhỏ, kiểm tra được độc lập.
• Quyết định kiến trúc: file nào tạo mới, file nào sửa, contract giữa các phần.
• Thứ tự & phụ thuộc: cái gì phải xong trước cái gì.

Muốn đi sâu phần này, xem lập kế hoạch với Claude Code. Gate của phase Plan là điểm có giá trị nhất trong cả pipeline: bạn đọc kế hoạch trước khi một dòng code nào được viết. Sửa một dòng trong plan rẻ hơn nhiều so với sửa cả một module. Nếu kế hoạch dựa trên giả định sai, bạn bắt được ngay tại đây - chứ không phải sau khi Cook chạy xong.

Phase 3 - Cook: thực thi có kiểm soát

Đây là phase mà đa số người nghĩ là "toàn bộ công việc", nhưng thực ra nó chỉ chạy tốt sau khi hai phase trước đã xong. Khi plan đã được duyệt:

/ak:cook

Agent thực thi theo kế hoạch từng task một, đánh dấu tiến độ theo danh sách đã đánh số. Vì mục tiêu và các bước đã rõ, đây là lúc để agent chạy như một "long-running autonomous burst" - làm việc dài hơi mà bạn không phải cầm tay từng dòng. Ba điểm cần giữ:

• Bám plan: mỗi thay đổi phải map về một task. Nếu agent muốn làm ngoài kế hoạch, đó là tín hiệu quay lại phase Plan.
• Subagents cho việc song song: các task độc lập (ví dụ viết test trong khi implement) có thể giao cho subagent chạy song song, miễn là không đụng cùng file. Xem thêm quy trình vibe coding bài bản để so sánh cách kiểm soát.
• Giám sát diff: bạn không đọc từng dòng agent gõ, nhưng liếc qua diff sau mỗi task để phát hiện lệch hướng sớm.

Cook không có nghĩa là "buông tay". Nó là ủy quyền có ranh giới: plan là ranh giới, diff là cửa sổ quan sát.

Phase 4 - Ship: review diff, commit, PR, verify

Phần bị bỏ quên nhiều nhất. Rất nhiều hướng dẫn dừng ở "code chạy được" rồi coi như xong. Nhưng "chạy trên máy tôi" chưa phải là ship. Phase cuối đóng vòng release:

/ak:ship

Quy trình Ship điển hình gồm bốn bước, và đây là gate cuối chống merge code sai:

1. Review toàn bộ diff: đọc lại tất cả thay đổi như một reviewer, không phải như tác giả. Đây là lúc dùng code review với AI để bắt lỗi logic, rò rỉ, và code thừa.
2. Commit theo quy ước: conventional commits (feat:, fix:, refactor:…), tách commit theo phạm vi, quét secret trước khi đưa lên.
3. Mở PR: mô tả rõ what/why, liên kết về outcome ở phase brainstorm để reviewer hiểu bối cảnh.
4. Verify: chạy lại test/build/lint. Nếu gate này đỏ, không merge.

Điểm hay của việc tách Ship thành phase riêng: nó buộc bạn nhìn tổng thể thay đổi một lần nữa, sau khi đã rời khỏi trạng thái "đang code". Nhiều bug ngớ ngẩn lộ ra đúng ở lần đọc lạnh này.

Ví dụ thực chiến: chạy 1 mini-project qua cả 4 phase

Để pipeline không chỉ là lý thuyết, đây là cách một tác vụ nhỏ đi hết bốn phase - ví dụ minh hoạ để bạn hình dung nhịp làm việc, không phải số liệu đo đếm bịa ra. Tác vụ: thêm một endpoint GET /api/health trả về trạng thái service và phiên bản.

Brainstorm. /ak:brainstorm thêm health check endpoint. Agent hỏi: cần trả về gì (status, version, uptime?), có cần auth không, format JSON ra sao. Chốt outcome: endpoint public, trả {status, version, timestamp}, non-goal: chưa cần metrics chi tiết. Gate: duyệt.

Plan. /ak:plan. Kế hoạch ba task: (1) tạo handler health.ts, (2) đăng ký route, (3) viết test. Kèm quyết định: đọc version từ package.json. Gate: đọc plan, thấy hợp lý, duyệt.

Cook. /ak:cook. Agent làm tuần tự ba task, viết handler, gắn route, thêm test. Liếc diff sau mỗi task - không có gì ngoài kế hoạch. Gate: diff sạch.

Ship. /ak:ship. Review toàn diff, commit feat(api): add health check endpoint, mở PR, chạy test - xanh. Gate cuối: merge.

Before/after (định tính, không phải phép đo chính xác): khi làm cùng loại tác vụ không theo pipeline, mình thường vấp ở chỗ agent tự thêm những thứ không cần (rate limit, cache) rồi phải gỡ - đúng kiểu rework. Với bốn gate, những thứ ngoài phạm vi bị chặn ngay ở phase Plan, nên phần Cook gần như không phải làm lại. Con số cụ thể tuỳ dự án - .

AgentKit hiện thực hóa pipeline này thế nào (so với DIY)

Bạn hoàn toàn có thể chạy pipeline bốn phase mà không cần công cụ nào - chỉ cần kỷ luật và vài prompt tự viết. Nhưng có sự khác biệt giữa "tự nhớ quy trình" và "quy trình được đóng gói thành lệnh".

DIY: bạn tự viết skill/prompt cho từng phase, tự nhớ đặt gate, và mỗi dự án lại dựng lại từ đầu. Bản EN có vài framework spec-driven (Superpowers, Spec Kit, BMAD) nhưng phải tự lắp; bản VI thì hầu như chỉ có mẹo rời rạc.

AgentKit: đóng gói sẵn bốn lệnh /ak:brainstorm → /ak:plan → /ak:cook → /ak:ship, cùng dàn agent kỹ sư và thư viện skill dùng chung, cài đặt dưới 5 phút (theo docs.agentkit.best, truy cập 08/2026).

Về gói: Engineer Kit giá $99 (60+ skills, 30+ workflows, 17 engineer agents - đúng phần dùng cho pipeline này), hoặc Bundle $149 gồm cả Marketing Kit. Trang có ghi money-back guarantee (không nêu số ngày cụ thể) và lifetime updates cho kit; giá $99/$149 hiển thị không kèm phí định kỳ. Muốn xem sâu, đọc Engineer Kit có gì và bài AgentKit là gì (review chi tiết).

Mẹo, lỗi thường gặp & giới hạn trung thực

Pipeline này mạnh, nhưng không phải lúc nào cũng đáng. Nói thẳng vài giới hạn:

• Khi nào là overkill: sửa một dòng, đổi text, fix typo - bốn phase là thừa. Với thay đổi nhỏ và rõ, cứ sửa thẳng. Pipeline dành cho tác vụ có độ mơ hồ hoặc nhiều bước.
• Chi phí token: phase Brainstorm và Plan tiêu token cho phần "suy nghĩ" mà chưa ra code. Đây là đầu tư để tiết kiệm rework, nhưng nếu tác vụ vốn đã rõ thì bạn đang trả tiền cho bước không cần. Xem context engineering để tối ưu.
• Learning curve: quen kiểu "prompt một phát ra code" thì bốn phase ban đầu thấy chậm. Cái được là ít quay lại sửa hơn.
• Đừng skip gate: lỗi phổ biến nhất là duyệt plan cho có rồi để Cook chạy. Gate chỉ có giá trị khi bạn thật sự đọc. Bỏ gate = quay về vibe coding, chỉ khác là có thêm vài lệnh.

Tóm lại: dùng pipeline khi công việc xứng đáng với cấu trúc của nó, và luôn giữ con người ở mỗi cửa.

Câu hỏi thường gặp (FAQ)

brainstorm → plan → cook → ship khác spec-driven development thế nào?

Spec-driven đi theo spec → plan → code. Pipeline này thêm hai gate ở hai đầu: brainstorm để hội tụ ý tưởng trước khi có spec, và ship để đóng vòng release (review diff, commit, PR, verify) sau khi code xong. Nó bao trọn từ ý tưởng mơ hồ đến code lên nhánh chính.

Có bắt buộc dùng AgentKit không, hay tự làm được?

Tự làm được. Bạn có thể dựng prompt/skill cho từng phase và tự đặt gate. AgentKit chỉ đóng gói sẵn bốn lệnh /ak:* cùng agent và skill dùng chung để khỏi dựng lại mỗi dự án - nhanh hơn, nhưng không phải điều kiện bắt buộc.

AgentKit này có phải OpenAI AgentKit không?

Không. Đây là AgentKit cho Claude Code (agentkit.best, CLI ak, tiền thân Claude Kit). OpenAI AgentKit (Agent Builder, ChatKit) là sản phẩm riêng của OpenAI, trùng tên nhưng không liên quan.

Pipeline này dùng cho team được không?

Được. Outcome ở phase brainstorm và kế hoạch ở phase plan trở thành tài liệu chung để review; PR ở phase ship là điểm cộng tác tự nhiên. Gate review vốn hợp với quy trình nhiều người.

Có tốn nhiều token không?

Phase Brainstorm và Plan tiêu token cho phần suy nghĩ trước khi ra code. Với tác vụ mơ hồ hoặc nhiều bước, khoản này thường rẻ hơn chi phí rework. Với tác vụ đã rõ và nhỏ, bỏ qua pipeline sẽ tiết kiệm hơn.

Bắt đầu ở đâu?

Chọn một tác vụ nhỏ nhưng không tầm thường (ví dụ thêm một endpoint), rồi chạy đúng thứ tự /ak:brainstorm → /ak:plan → /ak:cook → /ak:ship, dừng lại đọc kỹ ở gate sau brainstorm và sau plan. Làm quen nhịp trước, mở rộng sau.

Kết luận & bước tiếp theo

Bốn phase - Brainstorm (chốt outcome), Plan (kế hoạch chi tiết), Cook (thực thi có kiểm soát), Ship (review + release) - biến việc dùng AI từ "code bừa rồi sửa" thành một quy trình có kiểm soát, với con người canh mỗi cửa. Muốn xem pipeline áp dụng liên tục trên dự án thật, đọc tiếp workflow AgentKit thực chiến 30 ngày.

Lệnh, giá và số liệu AgentKit có thể thay đổi - kiểm tra lại tại agentkit.best trước khi mua.