Tóm tắt nhanh:
ak-bootstrapdựng một dự án mới (web, mobile, CLI, API, MCP server, WebMCP hay thư viện) từ ý tưởng tới bản chạy được, đã kiểm tra. Nó chốt hợp đồng rồi giao thẳng choak-cook,ak-code-review,ak-enhance-ux-axnếu có web, và phát hành khi hợp đồng yêu cầu. Nó không có bướcak-planriêng và không tự cho mình quyền deploy hay push.
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 bắt đầu một dự án mới, hoặc làm lại một sản phẩm cũ ở chỗ mới, và muốn nhận bản chạy được có test, đã review. Không cần khi bạn muốn duyệt một bản plan trước khi làm: skill này không có bước ak-plan riêng, nên muốn tự chốt từng quyết định thì thêm --ask hoặc dùng --full.
flowchart LR
A["Ý tưởng dự án mới"] --> B["ak-bootstrap"]
B --> C["Hợp đồng đã chốt"]
C --> D["ak-cook làm và test"]
D --> E["ak-code-review"]
E --> F["ak-enhance-ux-ax --auto nếu có web"]
F --> G["Phát hành và kiểm tra thật nếu hợp đồng có"]
G --> H["Báo cáo và hướng dẫn bắt đầu"]Nó xoay quanh 4 khái niệm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Hợp đồng mở đầu | Trước khi tạo Git hay viết dòng code nào, đã chốt được những gì? | Kết quả: chủ quán đặt bàn online được. Ràng buộc: chạy trên Postgres sẵn có. Ngoài phạm vi: thanh toán. Nghiệm thu: test e2e đặt bàn pass. |
| Bề mặt của dự án | Người dùng hay agent chạm vào dự án qua đâu? | Một web app kèm API và MCP server là 3 bề mặt. Web thì có bước thiết kế giao diện và bước UX/AX. CLI, API, MCP thì bỏ wireframe, thay bằng thiết kế lệnh, route hoặc schema tool ngay trong hợp đồng. |
| Định nghĩa xong | Xong là chạy trên máy bạn, hay chạy ở nơi người dùng thật dùng? | Brief ghi "xong khi chạy trên production" thì chỉ xong khi đã phát hành lên production và kiểm tra như người dùng thật. Brief không nhắc nơi phát hành thì báo cáo ghi rõ chỉ mới kiểm tra ở máy. |
| Ranh giới cho phép | Khi nào chế độ tự động phải dừng lại chờ bạn? | Thiếu secret, một việc phá huỷ hoặc ra bên ngoài mà brief không cho, hay một khoản chi brief không nhắc tới. Brief ghi "tạo repo public và deploy" thì chỉ hai việc đó được phép, xoá bản deploy cũ vẫn phải hỏi riêng. |
Danh sách kiểm tra theo từng bề mặt chỉ là chủ đề cần soát, không phải việc phải làm thêm: mục nào brief không yêu cầu thì nó không tự thêm. Brief không nhắc nơi phát hành thì "xong" chỉ là chạy ở máy bạn.
Prompt mẫu cho web app mới:
/ak-bootstrap Làm web app đặt bàn cho nhà hàng <tên quán>.
Kết quả: khách chọn ngày giờ, số người và nhận email xác nhận.
Ràng buộc: Next.js, Postgres, giao diện tiếng Việt.
Không làm: thanh toán online, app mobile.
Xong khi: test e2e luồng đặt bàn pass và chạy được ở máy local.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--auto | Chạy một mạch, tự quyết (mặc định) | 1.0.0 |
--full | Đi kỹ từng bước, hỏi khi cần | 1.0.0 |
--fast | Ít nghiên cứu, vào làm sớm | 1.0.0 |
--parallel | Nhiều agent làm cùng lúc | 1.0.0 |
--ask | Được phỏng vấn tới khi chốt phạm vi | 2.19.0 |
--ultra | Code review 5 bản, kỹ hơn | 2.13.0 |
--yagni | Bản nhỏ nhất đủ dùng | 2.8.0 |
--skip-journal | Bỏ bài journal tự động ở cuối | 2.9.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-bootstrap: dựng dự án mới tới bản chạy được" 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-bootstrap". 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
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-bootstrap
