Tóm tắt nhanh:
ak-brainstormbiến một ý tưởng chưa rõ thành một quyết định rõ: làm gì, không làm gì, xong khi nào, làm cách nào. Nó đọc code thật của bạn, so sánh tối đa 3 cách làm, khuyên một cách rồi chuyển choak-planhoặcak-fix. Nó không viết code.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn biết mình muốn gì nhưng chưa rõ làm cách nào, đang phân vân giữa hai hướng, hoặc gặp bug chưa rõ nguyên nhân. Không cần cho câu hỏi một bước như "hàm này làm gì?".
flowchart LR
A["Ý tưởng mơ hồ"] --> B["ak-brainstorm"]
B --> C["Hợp đồng 4 điều + cách làm được chọn"]
C --> D["ak-plan rồi ak-cook"]
C --> E["ak-fix"]
C --> F["Dừng, chỉ khám phá"]Nó luôn chốt 4 điều:
| Điều | Câu hỏi | Ví dụ |
|---|---|---|
| Kết quả | Xong thì người dùng thấy gì? | Bấm "Đăng nhập với Google" và vào dashboard |
| Ràng buộc | Không được phá gì? | Giữ đăng nhập email cũ, không đổi bảng users |
| Ngoài phạm vi | Gần đó nhưng lần này không làm? | Không làm GitHub, Apple login |
| Nghiệm thu | Bằng chứng nào cho thấy đã xong? | Test e2e Google pass, user cũ vẫn vào được |
Có từ 2 cách làm trở lên thì nó ghi thêm đánh đổi: mỗi cách dựa vào giả định nào và hỏng đầu tiên ở đâu. Khi lựa chọn định hình một ranh giới nhiều biến thể dùng chung, nó thử thêm một trường hợp thứ hai có thật trước khi khuyên mở điểm nối. Với bug, nó chứng minh nguyên nhân trước rồi mới bàn cách sửa.
Prompt mẫu cho tính năng mới:
/ak-brainstorm Thêm đăng nhập bằng Google cho app <tên app>.
Kết quả: người dùng bấm "Đăng nhập với Google" và vào dashboard.
Ràng buộc: giữ đăng nhập email/mật khẩu hiện có, không đổi schema bảng users.
Không làm: GitHub/Apple login, gộp tài khoản trùng email.
Xong khi: có test e2e cho luồng Google và user cũ vẫn đăng nhập được.Các prompt trong bài dùng dạng /ak-brainstorm của Claude Code và Cursor. Trên Codex, bạn gõ $ak-brainstorm.
| Cờ | Để làm gì | Từ ak |
|---|---|---|
--ask | Hỏi bạn một vòng, tối đa 4 câu, khi code không trả lời được | 2.16.0 |
--report | Lưu quyết định thành file Markdown | 2.13.0 |
--html | Xuất thêm file HTML có sơ đồ để xem, chia sẻ | 2.5.0 |
--ak-render | Dựng file HTML bằng AK Render, tự kèm --html | 3.0.0-beta.5 |
--advice | Model mạnh hơn góp ý ở các mốc quan trọng | 2.5.0 |
--ultra | Chạy 5 bản độc lập, chọn nguyên một bản thắng | 2.13.0 |
--yagni | Cắt về bản nhỏ nhất đủ dùng | 2.8.0 |
--no-antv, --no-diagram-design, --no-editorial-visuals | Tắt hình minh hoạ trong file HTML | 2.13.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 6 tình huống kèm prompt, giải thích từng cờ (dùng khi, không cần khi, nhận lại gì, đi kèm cờ nào), lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-brainstorm: chốt làm gì và làm cách nào trước khi code" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-brainstorm". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 21/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-brainstorm
