Bạn đã biết mở công cụ AI và biết Git. Giờ ghép hai thứ thành một quy trình làm việc lặp lại được: dặn AI về dự án một lần, giao việc theo vòng ngắn, và luôn có mốc để quay lại.

Dặn AI một lần bằng file hướng dẫn dự án

Mỗi lần mở phiên mới, AI không nhớ gì từ lần trước. Để đỡ phải nhắc đi nhắc lại, nhiều công cụ cho phép đặt một file văn bản ở gốc dự án (với Claude Code là CLAUDE.md) để nó tự đọc khi bắt đầu. Hãy coi đó như tờ giấy dán ở quầy cho nhân viên mới.

# Dự án: Web đặt bàn quán cà phê

## Chạy thử
- Cài thư viện: npm install
- Chạy: npm run dev (mở http://localhost:3000)
- Kiểm thử: npm test

## Quy ước
- Viết chú thích bằng tiếng Việt
- Không sửa thư mục /db/migrations khi chưa hỏi
- Mọi khoá bí mật nằm trong .env, không in ra màn hình

Giữ file này ngắn, vài chục dòng là đủ. Chỉ ghi điều AI không tự đoán ra được: lệnh chạy, quy ước, vùng cấm.

Vòng lặp giao việc

Mô tảNêu mục tiêu và giới hạn
Kế hoạchBắt AI nêu cách làm trước
LàmCho AI sửa từng phần nhỏ
KiểmChạy test hoặc mở thử
LưuCommit khi ổn

Bước kế hoạch hay bị bỏ qua mà lại rất đáng giá. Nếu AI hiểu sai yêu cầu, bạn phát hiện ngay trên giấy, trước khi nó sửa mười file.

Khi AI làm sai

Điều này sẽ xảy ra, và không có gì lạ. Cách xử lý theo thứ tự: đọc thông báo lỗi và dán nguyên văn cho AI; nếu nó sửa vòng vo quá hai lần, quay về mốc commit gần nhất bằng Git rồi nói lại yêu cầu rõ hơn; nếu phiên đã quá dài và rối, mở phiên mới kèm tóm tắt tình hình.

Ví dụ

Một người làm web đặt bàn nhờ AI “thêm kiểm tra trùng giờ”. AI sửa, rồi trang đặt bàn báo lỗi trắng xoá. Vì trước đó anh đã commit, anh gõ lệnh quay lại mốc cũ, rồi nhắn lại: “Chỉ kiểm tra trùng giờ trong cùng một bàn, đừng đổi cấu trúc bảng”. Lần này đúng.

Giữ quyền kiểm soát

Ở chế độ mặc định, AI hỏi trước khi sửa hoặc chạy lệnh. Nhiều người sau vài lần thấy ổn thì bật chế độ tự chấp nhận mọi thứ. Đây là thói quen rủi ro nếu bạn chưa có commit gần nhất và chưa đọc diff (phần so sánh trước/sau). Nên chỉ nới quyền ở dự án thử nghiệm, và vẫn xem lại thay đổi trước khi commit.

Nên làm

  • Commit trước khi giao việc lớn
  • Yêu cầu AI chạy test sau khi sửa
  • Đọc diff trước khi lưu mốc

Nên tránh

  • Giao “làm hết đi” không giới hạn
  • Cho AI chạm vào file khoá bí mật
  • Để một phiên chạy hàng tiếng đến khi rối

Thử ngay

Tạo file hướng dẫn dự án cho một dự án thật của bạn, rồi hỏi:

Đọc file hướng dẫn dự án và nói lại bằng lời của bạn
bạn hiểu những quy tắc nào. Sau đó đề xuất kế hoạch
thêm chức năng tìm kiếm theo tên, chưa viết code.

Ghi nhớ

  • File hướng dẫn dự án giúp AI nhớ quy ước qua các phiên; giữ ngắn và thiết thực.
  • Vòng lặp: mô tả, kế hoạch, làm từng phần, kiểm, commit.
  • Sai hai lần thì quay về mốc Git cũ và nói lại rõ hơn.
  • Chỉ nới quyền tự động khi đã có commit an toàn và vẫn đọc diff.
Bài trướcBài sau