Claude 101

CLAUDE.md: 30 phút đầu tư, lợi cả dự án

Cách tạo, merge template theo stack, và nguyên tắc viết CLAUDE.md để Claude hiểu luật ngay từ đầu.

🎯 Mục tiêu: Repo bạn phụ trách có CLAUDE.md khiến Claude "hiểu luật" ngay từ tin nhắn đầu.

📖 CLAUDE.md là file ở gốc repo mà Claude Code tự đọc mỗi phiên — chứa lệnh build/test, convention, kiến trúc, quy ước Git. Cách làm:

  1. cd repo && claude → gõ /init — Claude quét codebase và sinh bản nháp.
  2. Merge với template theo stack trong templates/ (CLAUDE-vue.md / CLAUDE-php-laravel.md / CLAUDE-node.md) — điền các phần còn để trống theo dự án của bạn.
  3. Nguyên tắc chất lượng: ngắn (<200 dòng), mỗi dòng kiểm chứng được. "Chạy npm run test:unit trước khi commit" ✅; "hãy code cẩn thận" ❌. Mỗi dòng tự hỏi: bỏ đi Claude có làm sai không? Không → xoá.
  4. Commit CLAUDE.md vào repo — cả team hưởng. Thêm quy tắc nhanh giữa phiên: gõ # luôn dùng composition API, không options API (Claude tự lưu vào memory).

🏋️ Bài tập 3.2 (mốc Tuần 3 cho dev): Tạo CLAUDE.md cho repo bạn đang làm bằng quy trình trên, mở PR cho tech lead review.