Thuần hóa Coding Agent: context engineering và guardrails
Bài viết trên Viblo trình bày cách dùng spec, tệp quy tắc .cursorrules/CLAUDE.md và vòng lặp test tự động để Coding Agent không phá codebase production.

Cursor, Windsurf, Cline hay Claude Code đã trở thành công cụ quen tay của nhiều lập trình viên. Nhưng cũng rất quen một kịch bản: 10 phút đầu agent sinh code nhanh đến mức tưởng nghề sắp bị thay thế, đến khi dự án phình lên vài chục file thì agent bắt đầu sửa hỏng thứ đang chạy. Bài viết của tác giả Huy Quốc trên Viblo, đăng ngày 16/11/2026, đề xuất một cách xử lý cụ thể: thay lối "vibe coding" cảm tính bằng spec-driven agentic coding, cộng thêm context engineering và các hàng rào kiểm soát tự động.
Điểm đáng chú ý là bài không bàn đến việc mô hình nào thông minh hơn, mà đặt vấn đề ở phía kỹ sư: cấu trúc ngữ cảnh, ranh giới kiến trúc và quy trình xác minh mới là thứ quyết định agent tạo ra giá trị hay tạo ra nợ kỹ thuật.
Vấn đề không nằm ở mô hình
Theo tác giả, các Coding Agent hiện đại vận hành bằng dự đoán xác suất token kế tiếp trong một context window hữu hạn, không có mô hình nhận thức ổn định về toàn bộ hệ thống. Khi giao tiếp thiếu cấu trúc, ba điểm mù kỹ thuật xuất hiện:
- Suy giảm sự chú ý (lost in the middle): hội thoại kéo dài qua hàng chục lượt sửa lỗi khiến agent dần "quên" các quy chuẩn kiến trúc đã nêu ở đầu phiên.
- Thiếu bức tranh toàn cảnh (architectural blindness): nếu không được chỉ rõ ranh giới giữa các tầng, agent có xu hướng nhét truy vấn database thẳng vào controller hoặc component giao diện, vì đó là đường ngắn nhất để tính năng "chạy được".
- Ảo giác phụ thuộc (dependency hallucination): thay vì tái sử dụng hàm tiện ích có sẵn, agent viết lại một hàm mới hoặc tự cài thêm thư viện ngoài, kéo theo xung đột với
package.json.
Đây là cách lý giải của tác giả bài gốc, không phải kết luận từ một nghiên cứu được dẫn trong bài. Nhưng nó khớp với trải nghiệm khá phổ biến: agent càng tự do thì càng dễ tối ưu cho lượt hiện tại thay vì cho codebase về dài hạn.
Hai cách tiếp cận, hai kết cục
Bài gốc đặt hai lối làm việc cạnh nhau để thấy khác biệt không nằm ở công cụ mà ở đầu vào và cơ chế kiểm soát:
| Tiêu chí | Vibe coding cảm tính | Spec-driven agentic coding |
|---|---|---|
| Đầu vào chính | Prompt rời rạc, ngắn | Tệp đặc tả (PRD.md, ARCHITECTURE.md) và rules |
| Phạm vi tác động | Agent tự do sửa toàn bộ codebase | Giới hạn danh sách file được phép chạm |
| Kiểm soát chất lượng | Click thử bằng mắt | Vòng lặp tự động chạy linter, typecheck, unit test |
| Khả năng bảo trì | Thấp, dễ rơi vào vòng lặp sửa lỗi | Cao hơn, bám theo kiến trúc của team |
Điểm mấu chốt trong bảng này là cột thứ ba: chất lượng không phụ thuộc vào việc bạn viết prompt hay đến đâu, mà vào việc agent có bị chặn bởi các ràng buộc kiểm chứng được bằng máy hay không.
"Hiến pháp dự án": biến quy ước thành tệp cấu hình
Bước đầu tiên tác giả đề xuất là thiết lập bộ quy tắc ngữ cảnh tĩnh trước khi yêu cầu agent viết bất kỳ dòng code nào, thông qua các tệp như .cursorrules, .windsurfrules hoặc CLAUDE.md ở thư mục gốc. Tệp này đóng vai trò gần như một system prompt bất biến, được nạp lại ở mỗi lượt sinh mã.
Nội dung nên có, theo bài gốc: tech stack và thư viện lõi, ranh giới thư mục, quy ước code và xử lý lỗi, cùng giao thức thực thi (khi nào được cài package mới, chạy lệnh gì sau khi sửa). Với dự án full-stack Next.js/TypeScript/Prisma/Tailwind, mẫu trong bài có thể tóm gọn lại như sau:
# PROJECT CONSTITUTION
## Tech stack
- Next.js 15 (App Router), React 19, TypeScript strict mode
- Tailwind CSS + Shadcn/UI, không inline style, không CSS module rời
- TanStack Query v5 cho client state, Server Actions cho mutation
- Prisma + PostgreSQL, Zod cho validate đầu vào
## Ranh giới kiến trúc
- src/app/: chỉ routing, layout, page mỏng; không business logic
- src/services/: business logic thuần, giao tiếp DB qua Prisma
- src/lib/validations/: Zod schema dùng chung FE và BE
- src/components/ui/: component nguyên tử, không gọi API
## Quy ước code
- Không dùng any; mọi props và hàm phải có type rõ ràng
- Server Action/API route bọc try/catch, trả về { success, data?, error? }
- Trước khi viết helper mới, kiểm tra src/lib/utils.ts
## Kiểm chứng
- Không tự cài npm package mới khi chưa được duyệt
- Sau khi sửa, chạy npm run typecheck và npm run lint
Ảnh: Viblo
Điều đáng lưu ý: giá trị của tệp này không nằm ở việc nó dài hay đẹp, mà ở chỗ mỗi dòng đều kiểm chứng được. "Không dùng any" thì typecheck bắt được. "Không cài package mới" thì review diff package.json bắt được.
Quy trình ba pha: Spec → Plan → Execute
Tác giả tách hẳn tư duy thiết kế khỏi pha sinh mã, thành ba bước riêng biệt.
Pha 1 — Đặc tả hóa yêu cầu
Chuyển agent sang chế độ Ask/Architect Mode và cùng viết tệp docs/feature-spec.md: mô tả luồng dữ liệu từ UI qua API xuống database, liệt kê các trường hợp biên và trạng thái lỗi, xác định thay đổi schema nếu có. Ở pha này chưa có dòng code nào, nên sai sót về nghiệp vụ vẫn còn rẻ.
Pha 2 — Lập kế hoạch tác động
Yêu cầu agent liệt kê chính xác các tệp sẽ tạo mới và các tệp hiện có cần sửa, kèm giải thích ngắn cho từng tệp, và không được viết code cho đến khi kế hoạch được duyệt. Theo bài gốc, đây là bước chặn sớm nhất nếu agent có ý định sửa nhầm vào module lõi.
Pha 3 — Thực thi và vòng lặp tự kiểm thử
Sau khi kế hoạch được duyệt, agent viết mã song song với unit test hoặc integration test rồi tự chạy npm test (hoặc pytest). Khi test đỏ, agent đọc stack trace, sửa và chạy lại cho tới khi xanh. Đây là điểm khác biệt cốt lõi so với việc tự mở trình duyệt click thử: phản hồi do máy sinh ra, lặp lại được, và không phụ thuộc vào việc kỹ sư có nhớ kiểm tra hay không.
Ảnh: Viblo
Vệ sinh context window
Bài gốc đưa hai nguyên tắc vận hành đáng chép vào quy trình của team:
- Một tính năng, một phiên chat. Không dùng chung một cửa sổ hội thoại cho nhiều tính năng khác nhau. Hoàn thành module,
git commitxong thì mở phiên mới để xóa bộ nhớ đệm ngữ cảnh. - Gắn thẻ ngữ cảnh chủ động. Thay vì để agent tự quét toàn dự án, dùng cú pháp
@filehoặc@folderđể chỉ đúng những tệp liên quan. Ít nhiễu hơn, và tiết kiệm context window.
Bốn điểm đỏ phải kiểm trước khi merge PR
Theo tác giả, agent có xu hướng ưu tiên happy path và bỏ qua lỗ hổng bảo mật. Checklist bắt buộc trước khi duyệt PR do AI tạo ra gồm:
- Lộ khóa truy cập: API key hay chuỗi kết nối DB có bị đưa vào tệp phía client hoặc biến
NEXT_PUBLIC_...hay không. - Phân quyền (IDOR): agent thường viết đủ bước kiểm tra đăng nhập nhưng quên kiểm tra quyền sở hữu dữ liệu, kiểu user A gọi API sửa dữ liệu của user B.
- Truy vấn N+1: rà các vòng lặp gọi database bên trong hàm xử lý danh sách.
- Mã dư thừa: xóa file nháp, hàm không được gọi, thư viện thừa mà agent tạo ra trong lúc thử nghiệm.
Bốn điểm này không mới với người làm backend, nhưng chúng dễ bị bỏ qua chính vì agent viết code nhanh và trông có vẻ hoàn chỉnh.
Vì sao đáng quan tâm với độc giả Việt Nam
Phần lớn team sản phẩm ở Việt Nam là team nhỏ: một vài kỹ sư, review chéo hạn chế, tiến độ gấp. Đây đúng là môi trường mà Coding Agent tạo ra khác biệt lớn nhất về tốc độ, nhưng cũng là nơi nợ kỹ thuật tích tụ nhanh nhất vì ít người soi code. Một tệp quy tắc 30 dòng cộng với việc bắt buộc chạy typecheck và test trước khi merge là thứ một team hai người vẫn làm được ngay trong buổi chiều, không cần đầu tư hạ tầng.
Ở chiều ngược lại, bài gốc cũng chỉ ra rằng kỹ năng đang được định giá lại: gõ cú pháp nhanh không còn là lợi thế, mà là khả năng phân tách module và đóng gói tri thức nghiệp vụ thành quy chuẩn để agent thực thi đúng. Với các bạn đang học nghề, đây là gợi ý khá thực tế về việc nên đầu tư vào đâu.
Ai nên thử, và thử thế nào
- Kỹ sư dùng agent hằng ngày: bắt đầu bằng cách viết
.cursorruleshoặcCLAUDE.mdcho dự án hiện tại, chỉ gồm những quy tắc kiểm chứng được bằng linter, typecheck hoặc test. - Tech lead: chuẩn hóa tệp quy tắc thành template chung cho cả team, đưa checklist bốn điểm đỏ vào mẫu pull request.
- PM/BA muốn tự làm micro-tool nội bộ: áp dụng quy trình ba pha, nhưng thu hẹp phạm vi từng bước nhỏ.
Cách thử nhanh nhất là chọn một tính năng nhỏ chưa làm, chạy đủ ba pha Spec → Plan → Execute một lần, rồi so sánh lượng file bị sửa và số lần phải sửa lại so với thói quen prompt trực tiếp.
Lưu ý và hạn chế
- Bài gốc là chia sẻ kinh nghiệm cá nhân đăng trên blog cộng đồng Viblo, không kèm số liệu đo lường hay thử nghiệm có kiểm soát. Các nhận định như agent thực thi chính xác phần lớn khối lượng công việc lặp lại là đánh giá chủ quan của tác giả.
- Tên tệp cấu hình (
.cursorrules,.windsurfrules,CLAUDE.md) phụ thuộc vào từng công cụ và có thể thay đổi theo phiên bản; nguồn chưa nêu phiên bản cụ thể của Cursor, Windsurf, Cline hay Claude Code. - Quy trình ba pha chậm hơn gõ prompt trực tiếp ở giai đoạn đầu, đặc biệt với thay đổi nhỏ. Đây là đánh đổi có chủ ý, không phải quy tắc áp dụng cho mọi trường hợp.
- Cuối bài gốc, tác giả có lời mời đọc nội dung để lại ở phần bình luận, hướng tới việc giới thiệu sản phẩm hoặc dịch vụ đào tạo. Độc giả nên cân nhắc khi tham khảo phần này.
Kết
Giá trị lớn nhất của bài viết không nằm ở mẫu .cursorrules cụ thể, mà ở cách đặt vấn đề: nếu đã đưa agent vào dự án production, thì trách nhiệm thiết kế ngữ cảnh và hàng rào kiểm chứng thuộc về kỹ sư, không thể giao cho xác suất của mô hình. Bắt đầu từ một tệp quy tắc ngắn và một vòng lặp test tự động là đủ để thấy khác biệt.
Nguồn: Viblo
Nguồn tham khảo: Viblo
Bài viết liên quan

AI cho lập trình viên8 phút đọc
learn-claude-code: repo dạy tự xây agent harness từ 0
Repo Python của shareAI-lab dạy cách tự viết harness cho coding agent: tools, knowledge, observation, quyền hạn. Tính đến 15/11/2026, repo đạt 80.412 sao.

Công nghệ Việt Nam13 phút đọc
Harness Engineering: bộ khung giúp AI Agent viết code đáng tin hơn
Bài viết trên Viblo lý giải vì sao cùng một model nhưng kết quả khác hẳn nhau, và cách dựng harness cấp dự án chỉ với bốn file.

Bảo mật9 phút đọc
Vapor Panda dùng ARTEX AI tấn công tự động hơn 200 tổ chức
CrowdStrike cho biết nhóm Vapor Panda dùng ARTEX AI điều phối nhiều agent tấn công song song hơn 200 tổ chức ở 14 quốc gia, xâm nhập thành công ít nhất 9.
Bình luận
Đang tải bình luận…