Vấn đề
Hãy thành thật: chúng ta không còn muốn đọc code nữa. Không muốn kiểm tra mọi thứ agent làm, cũng không muốn nhớ từng chi tiết kỹ thuật của dự án.
Nhưng nếu không ai kiểm soát các agent, chúng sẽ biến bất kỳ dự án nào thành một mớ hỗn loạn không thể bảo trì — mà cả con người lẫn agent đều không gỡ nổi. Chỉ là vấn đề thời gian.
Ý tưởng
HUMAN-INTENT.md là một tệp nằm ở gốc repository của bạn. Nó chứa ý định của bạn: kiến trúc dự án, quy tắc phát triển và các quyết định sản phẩm.
Nó không phải là tài liệu của code. Nó là luật mà code phải tuân theo.
Quy tắc
-
Do bạn viết — và chỉ mình bạn
Agent không bao giờ được sửa tệp này. Mỗi dòng trong đó là một quyết định do con người đưa ra.
-
Chỉ dẫn trong đó là luật đối với agent
Những gì HUMAN-INTENT.md nói được ưu tiên hơn tất cả. Nếu code mâu thuẫn với tệp, thì code sai.
-
Nó xác định kiến trúc, quy tắc và sản phẩm
Ý định, không phải công thức. Agent vốn đã biết mọi pattern; việc của bạn là chốt điều gì phải đúng — và vì sao.
Vì sao nó hiệu quả
Không ai theo kịp agent: code sinh ra nhiều hơn mức bất kỳ ai muốn đọc. Kiểm soát từng dòng là vô vọng. Kiểm soát ý định thì có thể.
HUMAN-INTENT.md nâng việc kiểm soát lên một tầng cao hơn: bạn theo dõi một tệp chứa các quyết định của mình thay vì hàng nghìn dòng code. Chừng nào tệp còn là luật, dự án còn phát triển theo ý định của bạn — kể cả khi không ai đọc code.
Bắt đầu thế nào
- Tạo HUMAN-INTENT.md ở gốc repository của bạn.
- Ghi lại những quyết định bạn đã đưa ra: kiến trúc, quy tắc phát triển, sản phẩm.
- Yêu cầu agent đọc tệp này và coi nó là luật — tham chiếu nó từ AGENTS.md hoặc CLAUDE.md.
- Mỗi khi có quyết định mới, hãy thêm vào tệp. Không bao giờ để agent viết vào đó.
- Hãy review tệp này, thay vì review code.