Context engineering và guardrails để "thuần hoá" coding agent

Trong bài này
Coding Agent như Cursor, Windsurf, Cline hay Claude Code thường cho kết quả ấn tượng ở giai đoạn đầu, nhưng khi dự án lớn dần với nhiều file và nghiệp vụ rẽ nhánh, chúng có thể làm hỏng tính năng đang chạy, kéo thêm thư viện xung đột hoặc phá vỡ kiến trúc. Nguyên nhân nằm ở cách dùng thiếu cấu trúc, gọi là Unstructured Vibe Coding. Hướng khắc phục là kết hợp Spec-Driven Agentic Coding, Context Engineering và Automated Guardrails, tức quy trình đặc tả trước, cấp ngữ cảnh ổn định cho Agent và đặt các hàng rào kiểm soát tự động.
Vì sao Coding Agent làm hỏng codebase
Agent hiện đại không kém thông minh, nhưng chúng vận hành bằng cách dự đoán xác suất trong một Context Window, tức cửa sổ ngữ cảnh có dung lượng hữu hạn. Khi người dùng giao tiếp thiếu cấu trúc, Agent rơi vào ba điểm mù.
Lost in the Middle: hội thoại kéo dài qua nhiều lượt sửa lỗi khiến Agent dần quên các quy chuẩn kiến trúc đã nhắc ở đầu phiên.
Architectural Blindness: nếu ranh giới giữa các tầng không được chỉ rõ, Agent có xu hướng đặt truy vấn Database ngay trong Controller hoặc Component giao diện để tính năng chạy nhanh nhất.
Dependency Hallucination: thay vì dùng lại các hàm tiện ích đã có trong dự án, Agent tự viết hàm mới hoặc cài thêm thư viện bên ngoài.
Context Engineering: bộ quy tắc ngữ cảnh cho dự án
Trước khi nhờ AI viết bất kỳ dòng code nào, kỹ sư nên thiết lập Static Context Rules, tức bộ quy tắc ngữ cảnh cố định, qua các tệp cấu hình ở thư mục gốc như .cursorrules, .windsurfrules hoặc CLAUDE.md. Tệp này hoạt động như một System Prompt bất biến, buộc Agent đọc và tuân thủ quy ước của dự án ở mỗi lượt sinh mã.
Một tệp .cursorrules cho dự án Full-stack gồm Next.js, TypeScript, Prisma và Tailwind có thể chia thành bốn phần: công nghệ và thư viện cốt lõi, ranh giới thư mục và kiến trúc, quy ước viết code cùng xử lý lỗi, và giao thức thực thi kèm kiểm chứng.
Phần công nghệ nêu rõ Zod dùng để kiểm tra mọi dữ liệu đầu vào API và Form, còn Prisma ORM làm việc với PostgreSQL.
Phần kiến trúc quy định thư mục src/app/ chỉ chứa routing, layout và page mỏng; business logic nằm trong src/services/; các Zod schema dùng chung nằm ở src/lib/validations/.
Phần quy ước cấm dùng any và yêu cầu mọi Server Action cùng API Route được bọc trong try/catch, trả về định dạng thống nhất.
Phần thực thi cấm tự ý cài gói npm mới khi chưa được xác nhận, đồng thời yêu cầu chạy npm run typecheck và npm run lint sau mỗi lần chỉnh sửa.
- KHÔNG tự ý cài đặt thêm gói npm mới nếu chưa hỏi ý kiến và được xác nhận.
- Sau khi hoàn thành chỉnh sửa code, luôn chạy `npm run typecheck` và `npm run lint` để đảm bảo không phát sinh lỗi biên dịch.Quy trình ba pha: Spec, Plan, Execute
Để Agent không làm việc vượt quá yêu cầu, quy trình tách bạch giữa tư duy thiết kế và việc sinh mã thành ba pha.
Đặc tả yêu cầu: thay vì bắt Agent code ngay, chuyển sang Ask hoặc Architect Mode và cùng AI viết tệp docs/feature-spec.md, trong đó mô tả luồng dữ liệu từ UI qua API tới Database, liệt kê Edge Cases cùng trạng thái lỗi, và nêu thay đổi Schema nếu có.
Lập kế hoạch tác động: khi đặc tả đã chuẩn, yêu cầu Agent liệt kê chính xác các tệp cần tạo mới hoặc sửa, giải thích ngắn thay đổi ở từng tệp, và chưa viết code cho đến khi kế hoạch được duyệt. Danh sách này giúp phát hiện sớm việc Agent định sửa nhầm module lõi nhạy cảm.
Thực thi và tự kiểm thử: sau khi duyệt, Agent bắt đầu viết mã và tận dụng Feedback Loop từ Terminal để tự sửa lỗi. Agent viết Unit Test hoặc Integration Test song song với tính năng, tự chạy npm test hoặc pytest, đọc Stack Trace khi test Fail và sửa cho đến khi toàn bộ Pass.
Quản trị Context Window và các Guardrails
Dù quy trình tốt, dự án vẫn gặp rủi ro nếu bỏ qua các cơ chế kiểm soát. Trước hết là vệ sinh ngữ cảnh, gồm hai nguyên tắc.
Một tính năng, một phiên chat: không dùng chung một cửa sổ chat kéo dài cho nhiều tính năng. Sau khi hoàn thành module và git commit, nên mở phiên mới để làm sạch bộ nhớ đệm của Agent.
Gắn thẻ ngữ cảnh chủ động: dùng cú pháp @file hoặc @folder để chỉ định đúng các tệp liên quan, thay vì để Agent tự quét toàn bộ dự án và gây nhiễu.
Vai trò của kỹ sư phần mềm thay đổi
Điểm chính
Nguồn tham khảo
Các nguồn mà bài viết này dựa vào.


