Làm sao để package AI-ready: llms.txt và MCP không đủ

Tác giả của Backpack for Laravel — package admin panel đời thứ 10 năm — vừa chia sẻ bài học thực chiến sau khi tối ưu hóa cho AI agent. Kết quả bất ngờ: hai tiêu chuẩn được quảng cáo nhiều nhất, llms.txt và MCP server, gần như không mang lại hiệu quả. Agent hiếm khi đọc llms.txt, và khi gọi MCP thì truy vấn thường quá ngắn, trả về kết quả vô nghĩa. Tác giả đang cân nhắc gỡ bỏ cả hai.
Điều thực sự giúp agent viết code chính xác là API ổn định lâu năm. Backpack giữ chữ ký hàm CRUD::column(‘name’) gần như không đổi 4 năm, khiến hàng triệu dòng code huấn luyện vẫn đúng với phiên bản mới. Mỗi breaking change (đổi tên, xóa hàm) tốn gấp đôi: người dùng phải sửa, agent vẫn gợi ý cách cũ còn nhiều năm. Lời khuyên: deprecate thay vì rename, giữ chữ ký cũ hoạt động.
Với các lỗi do agent dùng pattern phiên bản cũ, giải pháp không phải hy vọng model tự cập nhật, mà là in-project instruction — file hướng dẫn cục bộ trong repo dự án. Bài viết nhấn mạnh: “Điều yếu đuối là thứ agent phải nhớ đi tìm; điều mạnh là thứ đã ở trước mặt nó hoặc trong đầu nó”. Đây là bài học quý giá cho lập trình viên Việt Nam xây dựng thư viện, SDK hoặc framework muốn thân thiện với kỷ nguyên AI coding.
Bài được AI biên dịch và tóm tắt từ nguồn trên. Xem bài gốc để có đầy đủ thông tin.