---
title: "CLAUDE.md một trang là đủ"
date: 2026-11-09
tags: [Claude]
reading_time: 2 phút
author: Cris
url: https://cris-blog.pages.dev/posts/claude-md-mot-trang-la-du/
---

# CLAUDE.md một trang là đủ

> Vài quy tắc ngắn thay đổi cách agent làm việc nhiều hơn cả một prompt dài.

**TL;DR**

- Viết cách làm việc, không viết tiểu sử dự án.
- Mỗi quy tắc phải kiểm chứng được là đã tuân thủ hay chưa.
- Quy tắc nào cần ép buộc thì chuyển thành hook, đừng nhờ model nhớ.

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.

> **Ghi chú:** Thử một phép kiểm tra: đưa CLAUDE.md cho người lạ, hỏi họ đoán xem bạn làm nghề gì. Nếu họ đoán đúng, file đang nói về bạn. Nếu họ đoán sai, file đang nói về dự án và bạn đang viết nhầm chỗ.

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.

---

*Viết bởi Cris · cris.blog · 09/11/2026*