Một file .md để AI nhớ việc giữa các phiên

Mỗi phiên làm việc với AI đều có giới hạn bộ nhớ. Hội thoại dài thì bị nén, mở phiên mới thì trắng tinh. Lần nào cũng phải kể lại "dự án mình gồm những gì, đang làm tới đâu" vừa mệt vừa tốn token.

Giải pháp của mình rất "thô": một file văn bản duy nhất tên PROJECT_STATE.md nằm ở gốc dự án. Đầu mỗi phiên, Claude đọc nó trước tiên.

Năm khối, không hơn

1. Hạ tầng và thông số: tên miền, hosting, các dịch vụ đang chạy.
2. Bản đồ tệp: mỗi file quan trọng một dòng, ghi nó dùng để làm gì.
3. Cờ đã xong: mỗi việc đã chốt một dòng, kể cả những việc đã quyết không làm.
4. Việc dở dang: xếp theo thứ tự ưu tiên cho phiên sau.
5. Bootloader: một dòng để dán vào phiên mới.

Quy tắc quan trọng nhất: ghi đè, không cộng dồn

Bản năng là cứ chép thêm nhật ký vào cuối file. Sau vài tuần file dài hàng chục trang và AI đọc nó còn tốn hơn kể lại từ đầu. Mình giữ file cố định khoảng 2.500–3.500 token, tối đa một trang A4. Phiên thứ 100 vẫn nặng như phiên thứ nhất.

Mỗi lần chốt (mình gõ /checkpoint), Claude viết lại toàn bộ file: chỉ giữ trạng thái hiện tại, bỏ quá trình thử sai, bỏ log lỗi cũ.

Không bao giờ ghi bí mật vào file

File này được đồng bộ qua Git giữa hai máy. Vì vậy không có API key, mật khẩu hay token nào nằm trong đó, chỉ ghi nơi lưu chúng.

Khi nào chốt

• Xong một đầu việc lớn.
• Hệ thống báo hội thoại sắp đầy hoặc vừa tự nén.
• Mình chủ động gõ lệnh chốt.

Bộ nhớ của AI là thứ bạn viết ra, không phải thứ nó tự giữ.