Tóm tắt
File CLAUDE.md là "system prompt" cho Claude Code trong project của bạn. Viết tốt thì Claude hiểu codebase ngay; viết tệ thì Claude đoán mò.
Bài viết đưa 1 template thực dụng dùng được cho 80% project, gồm:
- Stack — ngôn ngữ, framework, runtime
- Commands —
npm run dev,npm run test, ... - Architecture — sơ đồ thư mục + giải thích role mỗi folder
- Conventions — style rules, naming, do/don't
- Gotchas — bug đã gặp, không muốn lặp lại
- Setup — bước one-time trước khi chạy lần đầu
Đọc bản đầy đủ + copy template
theagents.work/day-la-file-claude-md-ban-can-cho-hau-het-prj
Vì sao đáng đọc
Tốn 30 phút viết CLAUDE.md đúng → tiết kiệm hàng chục giờ Claude hỏi lại / làm sai sau này.