Quy trình build dự án từ đầu với Antigravity (Solo Builder)

Mình chia sẻ quy trình build một dự án từ đầu với Antigravity theo kiểu Solo Builder — để mọi thứ clear nhất, quy trình đầy đủ, khi mò lại đều biết mình đang ở đâu. Solo Builder

1. AGENTS.md thuở sơ khai

Đây là file "hiến pháp" của Anti — luôn được load vào ngữ cảnh. Bước này mình thường để phong cách phản hồi, techstack… vào đây. Ví dụ:

• Luôn hướng dẫn manual test sau mỗi phase/plan.
• Nhiệm vụ phức tạp mà user phải làm — nếu có thể viết script, dùng browser… để AI làm hộ thì nên đề xuất.

File này chưa cần đẹp, chỉ là setup rule cơ bản cho AI. Lát nữa chúng ta sẽ vòng lại.

2. Setup thư mục docs

Thời đại này docs là để AI đọc là chính con người chỉ đọc cái cần. Các file/folder trong thư mục này:

• brief.md — mong muốn, ý tưởng, mô tả dự án: dự án là gì, muốn như nào. Viết bằng ngôn ngữ tự nhiên, cho người đọc.
• BRD.md — chi tiết hơn brief: có những chức năng nào, chân dung người dùng, công nghệ quan trọng, các flow quan trọng, do/don't.
• plans/ — toàn bộ các phase để hoàn thiện dự án. Có master-plan.md lưu tất cả phase + trạng thái, và các file ten-phase.md ghi việc phải làm, expect đầu ra, hướng dẫn test (tất nhiên làm phase nào thì plan chi tiết cho phase đó).
• CHANGELOG.md — lưu thay đổi sau mỗi lần làm chức năng, fix bug, refactor… để cả người lẫn AI biết dự án đang ở đâu.

Có ý tưởng → nói chuyện với AI → brief → nói chuyện với AI → BRD → nói chuyện với AI → plans

3. AGENTS.md rework

Đến đây đã đủ thông tin dự án. Bảo AI dựa vào thư mục docs/ để tạo lại một AGENTS.md chuyên nghiệp. Đừng quên thêm logic trigger update CHANGELOG.md vào đây. Về sau mỗi lần làm việc, AI đều có ngữ cảnh nhờ file này.

4. Setup Kit, MCP, Rules, Skill, Workflow (nếu cần)

Đã đủ ngữ cảnh để biết cần làm gì, giờ research một chút:

• Có dùng Kit không, bộ nào phù hợp?
• Dùng bên thứ 3 gì, có MCP không? Cài Context7 nếu chưa có.
• Có rules gì cần tuân thủ không?
• Có skill đặc thù / hay ho cho dự án này không?
• Có quy trình nào làm đi làm lại để đóng thành workflow không?

Hơi mơ hồ? Q&A nhanh:

5. Còn gì nữa setup luôn đi

Còn gì cần thiết thì setup ở bước này luôn, ví dụ:

• Git
• Môi trường
• UI Design
• …

6. Phase by phase và vòng lặp vô hạn

Đến đây đủ đồ chơi rồi, bắt tay vào code thôi (tính ra giờ mới code á). Mỗi phase của mình:

1. Pick task — xem cần làm gì.
2. Lên plan — kế hoạch chi tiết, checklist, expect, cách kiểm thử.
3. Review plan — hợp lý chưa, update nếu cần.
4. Thực thi — AI làm; mình đi lướt FB, xem YouTube, hoặc nhảy qua dự án khác.
5. Review thực thi — đọc walkthrough của AI, review git diff xem có gì bất thường.
6. Test — bảo AI bật browser test / viết-chạy unit test / manual test (tuỳ).
7. Update / fix / improve nếu cần — AI không phải lúc nào cũng ngon ngay; mấy cái mơ hồ giờ mới có cái để nhìn.
8. Review + Commit — review kỹ diff hơn, commit + push nếu cần.
9. Lặp lại vô hạn tới khi xong dự án.

7. Review tổng thể, release checklist, mấy cái lặt vặt

Dự án hòm hòm rồi, làm vài việc trước khi lên production:

• Review (bằng AI) xem có vấn đề gì không, security ra sao, refactor/improve gì thì làm. Cài hoặc tự đóng gói skill cho việc này nếu cần.
• Mấy cái lặt vặt: favicon, ảnh OG, Google Analytics… v.v.

8. Deploy

Từ đây là vượt quá scope của Antigravity rồi.