Vấn đề: AI "mất trí nhớ" sau mỗi phiên
File rule (.cursorrules) trả lời câu hỏi "làm như thế nào". Nhưng còn "dự án đang ở đâu, đã quyết định những gì, kiến trúc ra sao" thì sao? Mỗi phiên chat mới, AI lại như nhân viên mới ngày đầu đi làm.
CLAUDE.md (và biến thể như claude.md, AGENTS.md, hay các "memory file" của từng editor) là lời giải: một file bộ nhớ động mô tả bức tranh tổng thể của dự án, được AI đọc đầu mỗi phiên và tự cập nhật sau mỗi cột mốc.
CLAUDE.md khác .cursorrules thế nào?
.cursorrules | CLAUDE.md | |
|---|---|---|
| Trả lời | "Làm theo quy tắc nào" | "Dự án này là gì, đang ở đâu" |
| Tính chất | Khá tĩnh, ít đổi | Động, cập nhật liên tục |
| Nội dung | Tech stack, quy ước, điều cấm | Mục tiêu, kiến trúc, tiến độ, quyết định kỹ thuật |
Cấu trúc một CLAUDE.md tốt
# CLAUDE.md — Bộ nhớ dự án
## Mục tiêu
App quản lý công việc nhóm, tích hợp Supabase realtime.
## Kiến trúc hiện tại
- Frontend: Next.js App Router
- Backend: Supabase (Postgres + RLS + Realtime)
- Auth: Supabase Auth, magic link
## Quy ước & quyết định kỹ thuật
- 2026-06-10: Chọn Supabase RLS thay vì check auth ở code
- 2026-06-15: Bỏ Zustand, dùng React Context cho global state
## Tiến độ
- [x] Auth flow (đăng nhập/đăng ký)
- [x] CRUD task cơ bản
- [ ] Realtime sync giữa các thành viên ← ĐANG LÀM
- [ ] Thông báo
## Điểm cần lưu ý / nợ kỹ thuật
- Component TaskList chưa tối ưu re-render
Cách làm cho AI "tự cập nhật" file
Cuối mỗi phiên làm việc lớn, ra lệnh:
"Cập nhật CLAUDE.md: đánh dấu mục Realtime sync đã xong, ghi lại quyết định dùng Supabase channel thay vì polling vào mục Quyết định kỹ thuật, và thêm bất kỳ nợ kỹ thuật nào phát sinh."
Dần dần file này thành "ký ức tập thể" của bạn và AI. Phiên sau, AI đọc CLAUDE.md là nắm ngay bối cảnh — không cần bạn kể lại.
⚠️ Lưu ý tên file: convention phổ biến nhất hiện nay là CLAUDE.md (viết hoa) đặt ở gốc dự án. Một số nhóm dùng
AGENTS.mdcho đa công cụ. Hãy nhất quán trong một dự án.
Bài tập
Tạo CLAUDE.md cho dự án của bạn với 4 mục: Mục tiêu, Kiến trúc, Tiến độ (dạng checklist), Quyết định kỹ thuật. Làm việc một phiên, rồi yêu cầu AI tự cập nhật file. Mở phiên mới và kiểm tra AI có nắm bối cảnh không.