Dự án nhiều người không mất ngữ cảnh — bộ 4 file liên tục
4 file gốc repo (CLAUDE.md, PRD.md, README.md, progress.md) để dự án dài ngày, nhiều dev luân phiên không mất ngữ cảnh giữa các phiên.
📖 Claude không nhớ gì giữa các phiên — chỉ file trên đĩa tồn tại. Với dự án kéo dài nhiều tuần và dev luân phiên (chuyện thường ngày ở công ty outsource), chuẩn hoá 4 file ở gốc repo:
| File | Vai trò | Ai cập nhật, khi nào |
|---|---|---|
CLAUDE.md | Hiến pháp: stack, convention, Definition of Done | Tech lead; khi quy ước đổi |
PRD.md | Đặc tả tính năng theo hành vi + acceptance criteria + edge case | BA/PM hoặc dev; trước mỗi feature |
README.md | Mục Implementation Status: đã xong ✅ / đang làm 🔄 / còn lại ⬜ | Dev; ngay khi feature xong |
progress.md | Nhật ký QUYẾT ĐỊNH: cách đã thử & loại bỏ, vì sao chọn hướng này, câu hỏi mở | Dev; khi có quyết định đáng nhớ |
CLAUDE.md được đọc tự động; 3 file còn lại nạp bằng nghi thức mở phiên (30 giây, tiết kiệm hàng giờ tái dựng ngữ cảnh):
Phiên mới. Đọc theo thứ tự: CLAUDE.md, PRD.md, README.md (mục Implementation
Status), progress.md. Xác nhận hiểu trạng thái dự án và cho biết ta đang dừng ở đâu.Mẫu PRD.md + progress.md có sẵn tại templates/prd-va-tiep-noi-phien.md. Mẹo: nhiều người dùng kinh nghiệm mở phiên mới khi context chạm ~50% thay vì đợi đầy — theo dõi bằng /context.
🏋️ Bài tập 3.7: Thêm 4 file vào repo đang làm, cập nhật Implementation Status theo thực tế, rồi mở phiên MỚI với nghi thức trên — kiểm chứng Claude tóm tắt đúng "ta đang ở đâu".
✅ Checklist tốt nghiệp Chương 3: ☐ CLAUDE.md đã merge ☐ 1 bugfix trọn vòng E-P-C-C ☐ Dùng được /compact /rewind /permissions ☐ Repo có đủ 4 file liên tục (Bài 3.7) ☐ (Nâng cao) 1 MCP hoặc hook hoạt động.