Context engineering là gì: cách làm thay cho vibe coding

Thử hình dung thế này. Anh nhờ AI viết script tổng hợp doanh số tuần. Lần một, nó dùng pandas, trong khi cả đội đã thống nhất không dùng. Lần hai, nó quên bỏ qua dòng trống. Lần ba chạy được, nhưng tên cột lại không khớp file thật của phòng kinh doanh.

AI không kém, nó chỉ không biết những gì anh biết. Cách chữa có một cái tên: context engineering.

Đọc nhanh trong 30 giây

• Context engineering là cách làm việc với AI lập trình bằng cách chuẩn bị đủ bối cảnh: quy tắc dự án, code mẫu, tài liệu, tiêu chí kiểm tra.
• Ngày 02/07/2025, Cole Medin đưa lên GitHub mẫu coleam00/context-engineering-intro để áp dụng cách này với Claude Code, giấy phép MIT.
• Dùng qua hai lệnh /generate-prp (lập kế hoạch) và /execute-prp (làm theo kế hoạch, tự kiểm tra).
• Hợp với đội đã dùng AI lập trình vài tuần và thấy AI lặp lại cùng một kiểu lỗi.

Context engineering là gì, khác vibe coding chỗ nào?

Context engineering là việc thiết kế toàn bộ thông tin mà trợ lý AI cần để làm xong một việc từ đầu tới cuối, không dừng ở một câu lệnh. Vibe coding thì ngược lại: mô tả vài dòng, để AI tự đoán phần còn lại, thấy chạy được là xong.

Ví von cho dễ nhớ. Anh chị thuê thợ mới về sửa bếp. Nói "sửa giúp cái bếp" thì thợ làm theo ý thợ. Đưa bản vẽ, ảnh mẫu bếp mình thích, danh sách vật liệu không dùng, và dặn rõ xong việc phải mở được vòi nước, thì thợ làm đúng ý ngay lần đầu. AI lập trình cũng vậy.

README của repo dùng một hình ảnh khác: prompt engineering giống đưa người ta một tờ giấy nhớ, còn context engineering giống viết hẳn một kịch bản phim đủ chi tiết. Tác giả đặt khẩu hiệu ngay đầu README: "Context Engineering is 10x better than prompt engineering and 100x better than vibe coding". Đây là cách nói của tác giả, không phải số đo.

Cùng một yêu cầu: một bên để AI đoán, một bên đưa AI đủ bối cảnh.

Lý do chính README nêu ra: phần lớn lỗi của agent không phải do model kém, mà do thiếu ngữ cảnh.

Trong bộ mẫu context-engineering-intro có gì?

Repo context-engineering-intro là một bộ khung thư mục dùng cho Claude Code, giấy phép MIT. Hãy nghĩ nó như một cặp hồ sơ giao việc: mỗi ngăn đựng một loại giấy tờ mà người nhận việc cần đọc.

Năm ngăn trong cặp hồ sơ giao việc cho AI.

• CLAUDE.md: luật chung cho cả dự án, AI đọc ở mọi cuộc trò chuyện. Ví dụ giới hạn độ dài file, cách tổ chức module, yêu cầu viết test, quy ước đặt tên.
• INITIAL.md: nơi anh chị mô tả tính năng muốn làm, chia bốn mục FEATURE, EXAMPLES, DOCUMENTATION, OTHER CONSIDERATIONS.
• examples/: thư mục để code mẫu. README nhấn mạnh đây là phần quan trọng nhất, vì AI làm tốt hơn hẳn khi được thấy mẫu để bắt chước.
• PRPs/: chứa các bản PRP, viết tắt của Product Requirements Prompt. Giống tài liệu yêu cầu sản phẩm, nhưng viết cho AI đọc, có sẵn các bước làm, cách xử lý lỗi và lệnh kiểm tra.
• .claude/commands/: hai lệnh tùy biến generate-prp và execute-prp cho Claude Code.

Mẹo

Nếu chỉ có thời gian cho một việc, hãy dồn công vào thư mục examples/. Hai ba file code tốt nhất của đội dạy AI nhanh hơn mười trang quy tắc.

Bắt đầu với Claude Code trong 6 bước

Các bước dưới đây chép theo phần Quick Start của README. Nếu anh chị chưa quen Claude Code, nên đọc trước bài Claude Code là gì.

Viết luật, viết yêu cầu, cho AI lập kế hoạch, rồi cho AI làm và tự kiểm tra.

1. Tải mẫu về máy:

git clone https://github.com/coleam00/Context-Engineering-Intro.git
cd Context-Engineering-Intro

2. Sửa CLAUDE.md cho đúng quy tắc dự án. Bước này không bắt buộc, mẫu đã có sẵn bản dùng được.
3. Đặt code mẫu liên quan vào thư mục examples/.
4. Viết yêu cầu tính năng vào INITIAL.md.
5. Trong Claude Code, cho AI nghiên cứu và viết bản PRP:

/generate-prp INITIAL.md

Lệnh này đọc yêu cầu, dò code có sẵn để tìm mẫu, tìm tài liệu liên quan, rồi ghi kế hoạch vào PRPs/ten-tinh-nang.md. Theo README, bản PRP tự chấm mức tự tin từ 1 tới 10.

6. Cho AI làm theo bản PRP:

/execute-prp PRPs/your-feature-name.md

AI đọc toàn bộ PRP, lập danh sách việc, làm từng phần, chạy test và lint, sửa lỗi tới khi đạt hết tiêu chí. Hai lệnh này thực chất là file Markdown trong .claude/commands/, mở ra sửa được.

Viết INITIAL.md cho một việc thật

Quay lại script doanh số ở đầu bài. Thay vì gõ "viết script tóm tắt doanh số", anh chị điền INITIAL.md như sau:

## FEATURE:
Script Python đọc file doanh_so_tuan.xlsx (sheet "Data", cột Ngày, Nhân viên, Sản phẩm, Doanh thu),
tính tổng doanh thu theo nhân viên và theo sản phẩm, xuất ra file tom_tat.xlsx.

## EXAMPLES:
examples/doc_excel.py: cách nhóm em đang đọc Excel bằng openpyxl, làm theo cấu trúc này.

## DOCUMENTATION:
https://openpyxl.readthedocs.io/

## OTHER CONSIDERATIONS:
- Có dòng trống và ô doanh thu bị nhập chữ, phải bỏ qua và ghi log.
- Không dùng pandas.
- Phải có test cho trường hợp file rỗng.

Bốn mục này trả lời trước đúng những câu AI hay đoán sai: dữ liệu nằm ở đâu, làm theo mẫu nào, cấm gì, thế nào là xong.

Cái giá của việc chuẩn bị kỹ

Lưu ý

• Tốn công chuẩn bị. Viết INITIAL.md và gom ví dụ mất thời gian. Với việc nhỏ năm phút, cách này nặng nề.
• Tốn token hơn. Bước generate-prp cho AI đọc code, tìm tài liệu, nên dùng nhiều lượt hơn một câu lệnh đơn. Tài liệu không nói chi phí cụ thể.
• Viết cho Claude Code. Mô tả repo nói ý tưởng áp dụng được cho trợ lý AI khác, nhưng anh chị phải tự chuyển đổi.
• Chưa bàn RAG và công cụ. Tác giả ghi rõ bản này chưa đi sâu vào hai phần đó, hẹn làm sau.
• File quyền. Mẫu có .claude/settings.local.json cấp quyền cho Claude Code. Đọc kỹ trước khi dùng trên máy có dữ liệu công ty.

Nhận xét của chuyên gia

Khi đào tạo AI cho doanh nghiệp, tôi hay gặp cảnh AI làm sai cùng một kiểu lỗi, tuần này qua tuần khác. Gốc rễ thường không ở model, mà ở chỗ quy tắc của dự án chỉ nằm trong đầu người cũ, chưa ai ghi ra. Bộ mẫu này buộc đội phải viết những điều đó thành chữ.

Với doanh nghiệp Việt, giá trị lớn nhất không nằm ở hai lệnh slash, mà ở thói quen viết yêu cầu có cấu trúc. Bốn mục FEATURE, EXAMPLES, DOCUMENTATION, OTHER CONSIDERATIONS dùng tốt cả khi giao việc cho người.

Hợp với ai: đội đã dùng AI lập trình vài tuần và bắt đầu thấy lỗi lặp lại; người làm công cụ nội bộ cần kết quả ổn định; người đào tạo cần một mẫu giao việc cho học viên.

Chưa hợp với ai: người chỉ cần thử ý tưởng nhanh; đội chưa có code mẫu nào để đưa vào examples/. Thêm một rủi ro: dễ tin vào điểm tự tin của PRP, trong khi điểm đó do chính AI tự chấm.

Cách bắt đầu của tôi: chọn một tính năng nhỏ có thật, viết CLAUDE.md ngắn chừng một trang, đưa hai ba file code mẫu tốt nhất vào examples/, đọc duyệt bản PRP rồi mới chạy execute. Xong một vòng, sửa CLAUDE.md theo những lỗi AI còn mắc.

Một câu để nhớ: AI không đọc được suy nghĩ của anh chị, nhưng đọc rất kỹ những gì anh chị chịu viết ra.

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

Context engineering có thay thế prompt engineering không?

Context engineering bao gồm cả prompt engineering. Câu lệnh vẫn cần viết rõ, nhưng nó chỉ là một phần, đứng cạnh quy tắc dự án, code mẫu, tài liệu và lệnh kiểm tra.

PRP khác gì PRD?

PRD là tài liệu yêu cầu sản phẩm viết cho người đọc. PRP trong mẫu này viết cho trợ lý AI, có thêm bước làm, mẫu xử lý lỗi và lệnh kiểm tra phải chạy qua.

Không dùng Claude Code thì áp dụng context engineering được không?

Mô tả repo cho biết cách làm này áp dụng được với trợ lý AI lập trình khác. Hai lệnh generate-prp và execute-prp là file Markdown, có thể dán nội dung vào công cụ khác, nhưng tài liệu không hướng dẫn cụ thể.

Mẫu context-engineering-intro có mất phí không?

Không. Repo dùng giấy phép MIT, tải và sửa miễn phí. Chi phí nằm ở gói Claude Code hoặc lượt dùng API anh chị đang trả.

Xem thêm các mốc khác trong dòng thời gian AI 2025 tới 2026.

Nguồn: coleam00/context-engineering-intro trên GitHub, 02/07/2025.