File CLAUDE.md được nạp vào đầu mọi phiên. Nó rẻ, nó luôn ở đó, và đúng vì vậy mà dễ bị nhồi quá nhiều. Bản của mình là một trang.
Những gì nằm trong đó#
Không có mô tả dự án. Chỉ có cách làm việc:
- Điều tra nguồn sự thật trước, rồi mới implement, rồi chứng minh bằng health check hoặc log.
- Nêu giả định. Mơ hồ thì hỏi.
- Sửa phẫu thuật: chỉ động vào chỗ cần, không dọn code của người khác.
- Đặt tiêu chí thành công kiểm chứng được và lặp đến khi đạt.
- Việc phá huỷ thì kiểm tra và backup trước.
Mỗi dòng trả lời được câu hỏi: làm sao biết Claude đã tuân thủ? Nếu không trả lời được, dòng đó chỉ là lời mong.
Ba điều mình học được#
Thứ nhất, ngắn thắng dài. Quy tắc cuối trang bị bỏ qua nhiều hơn quy tắc đầu trang.
Thứ hai, chia theo mức độ ép buộc. Lời dặn thì để trong CLAUDE.md. Thứ không được phép sai thì làm thành hook (xem bài hook chặn lệnh phá huỷ).
Thứ ba, viết bằng ngôn ngữ mình nghĩ. Mình viết tiếng Việt xen thuật ngữ tiếng Anh, và Claude trả lời cùng giọng.
Quy tắc hay nhất mình có là quy tắc mình ngại viết nhất: “không bao giờ yêu cầu hay hiển thị khóa riêng”. Có những thứ phải nằm ở cấp quy tắc, không bàn cãi.