Bạn viết CLAUDE.md, mô tả dự án thật đẹp, rồi sang phiên sau vẫn phải nhắc lại từng thứ: "nhớ giọng này", "đừng đụng thư mục kia", "kiểm trước khi bảo xong". Cảm giác như cái file chẳng làm gì. Vấn đề không phải agent lười đọc — là bạn viết một bản mô tả, mà mô tả thì agent đọc-cho-biết rồi vẫn tự do làm theo ý nó.
Một CLAUDE.md có ích không kể dự án là gì — nó ra lệnh: mặc định cái này, dừng lại hỏi ở chỗ kia, vùng này thì cẩn thận, xong nghĩa là đã kiểm thế này. Khung dưới đây gọn nhất có thể mà vẫn đủ năm mục đó. Bỏ phần mô tả hoa mỹ, giữ phần buộc hành vi:
✕ Viết như README
✓ Viết như luật
Dán khung này vào CLAUDE.md rồi điền chỗ ngoặc. Mục đáng giá nhất là "Dừng lại hỏi" và "Trước khi bảo xong" — đó là hai chỗ một dòng luật chặn được phần lớn cú đoán sai và cú "Done!" mà chưa kiểm. Viết ngắn; mỗi dòng là một mệnh lệnh, không phải một đoạn văn.