Tóm Tắt Bài Bản: Quy Trình Làm Việc Với Claude Code Cho Dự Án Thực Tế

Làm việc với Claude Code không chỉ đơn thuần là mở terminal lên và gõ vài dòng prompt. Để dự án thực tế có sự nhất quán, dễ mở rộng và tiết kiệm thời gian, bạn cần một quy trình làm bài bản. Bí quyết nằm ở việc sử dụng CLAUDE.md đúng cách và làm quen với hệ sinh thái tổ chức ngữ cảnh của AI.

Bài viết này tổng hợp toàn bộ cách vận hành Claude Code cho một luồng dự án (project workflow), giúp bất kỳ "AIEngineer" hay "Vibecoder" nào cũng có thể tối ưu hiệu suất làm việc.

1. Hiểu Vai Trò Của CLAUDE.md: "Bộ Nhớ" Của Dự Án

Khi bạn mở một session mới, AI thường sẽ không biết bạn định dùng công nghệ gì, chuẩn convention ra sao. Nhắc đi nhắc lại các quy tắc là một việc rất lãng phí thời gian và token.

Đó là lúc CLAUDE.md ra đời. Nó hoạt động như một “bộ nhớ dự án” và là nguồn căn (Source of Truth) được Claude nạp tự động mỗi khi bắt đầu một phiên làm việc mới.

Một file CLAUDE.md chuẩn mẫu nên bao gồm những thông tin cô đọng nhất sau đây:

• Tech Stack: Khung công cụ bạn đang dùng (Next.js, Tailwind, Postgres, v.v.).
• Cấu Trúc Thư Mục: Diễn giải ngắn gọn vai trò các thư mục chính.
• Commands: Lệnh build, test, lint, và chạy dự án (ví dụ: npm run dev, pytest).
• Kiến Trúc & Convention: Các lưu ý và tiêu chuẩn coding của riêng team (ví dụ: sử dụng Arrow Function, luôn type-check cho TypeScript, không dùng any).
• Những "Gotchas": Các lỗi rập khuôn mà AI khó tự suy ra (ví dụ: "Đừng import module X, hãy dùng module Y được viết lại ở utils/y.js").

Lưu ý: Mọi thứ trong CLAUDE.md phải cực kỳ ngắn gọn, rõ ràng và là những quy định "mất mạng cũng không được làm sai" của dự án.

---

2. Tổ Chức Dự Án Theo Nhiều Lớp (Layers)

Thay vì nhồi nhét mọi thứ vào một file CLAUDE.md duy nhất dài dằng dặc, bạn nên chia dự án làm nhiều lớp để quản lý ngữ cảnh thông minh:

• CLAUDE.md (Global Context): Khai báo các thiết lập cốt lõi, nằm ở gốc dự án (hoặc config global, parent folder, sub-folder tùy độ phức tạp). Đừng để các CLAUDE.md ở cấp dưới ghi đè quá sâu và gây nhiễu ngữ cảnh gốc.
• Skills: Là các hướng dẫn chuyên biệt hoặc các script có thể tự kích hoạt khi phát hiện ngữ cảnh tương ứng (Ví dụ: Một skill tên là database-schema chỉ được nạp khi bạn đụng vào code database).
• Hooks: Cấu hình để kiểm soát hành vi lúc trước hoặc sau khi chạy một công cụ (ví dụ: chạy npm run lint sau khi sửa code, format text,...).
• Agents: Phân tách các công việc, đóng gói các nhiệm vụ chuyên sâu biệt lập tránh trường hợp AI nhảy qua quá nhiều loại logic gây chéo ngữ cảnh.

---

3. Workflow Hằng Ngày (The Daily Ritual)

Theo kinh nghiệm của các kỹ sư chuyên sâu AI, dưới đây là quy trình hoàn chỉnh mỗi khi ngồi vào bàn làm việc:

1. Chạy /init đầu phiên: Để tự động phân tích nhanh codebase và update những setup ban đầu nếu cần thiết.
2. Setup ngọn giáo (Mũi nhử): Viết hướng dẫn cực kỳ cụ thể ở command. Tham chiếu file bằng tên file chính xác, giúp Claude không nhầm lẫn đường dẫn.
3. Mở Claude, Lên Plan: Bằng lệnh tự tạo hoặc nói chuyện qua chat, yêu cầu Claude nháp ra kế hoạch hành động trước. Không bắt đầu gõ code nếu AI chưa xác định đúng lộ trình (intent).
4. Auto-Accept khi cần: Nếu thấy các tool commands đã chuẩn (đọc file, tìm đoạn văn bản), hãy bật cơ chế auto-accept để luồng suy nghĩ của AI không bị gián đoạn vì đợi xác nhận.
5. Đóng Gói Ngữ Cảnh (Compact Context): Nút tắt /compact là tính năng cực kỳ hữu ích! Sau 10-15 turn trao đổi giải quyết xong 1 logic, hãy yêu cầu AI compact context hoặc tự reset nó để token ngắn gọn, lấy chỗ nhét code mới, tránh lạc đề (hallucinate).
6. Rewind khi đi lạc: Nếu Claude sửa hỏng một file hoặc đi quá xa so với dự định, dùng lệnh rewind (hoặc rollback) ngay lập tức dể đưa dự án trở lại checkpoint sạch sẽ gần nhất. Không cố chắp vá code rác do AI đẻ ra sai.
7. Chia nhỏ Session: Một lời khuyên vàng! Đừng bắt 1 session chat làm 3 tính năng. Xong tính năng A, hãy commit thường xuyên để chia sẻ và chuyển sang phiên session mới cho tính năng B.

Lời Kết

Sự khác biệt giữa một Coder biết xài AI và một AI Engineer thực thụ nằm ở khả năng kiểm soát ngữ cảnh hệ thống. Nếu bạn đang tập tành "Vibecoding", hãy bắt đầu bằng việc viết một CLAUDE.md thật tốt và tuân thủ kỷ luật chia nhỏ quy trình. Bạn sẽ bất ngờ về việc AI của mình trở nên "thông minh" và hợp ý bạn đến nhường nào.