Cuộc chiến framework Claude Code

• Các nhà phát triển hiện đang ở giai đoạn học cách cộng tác với AI, và giá trị của Claude được tối đa hóa khi nó được dùng như một framework chứ không chỉ là một chatbot
• Trong cộng đồng, nhiều thử nghiệm khác nhau về cách cấu hình và tận dụng Claude đang tiếp diễn, sôi nổi đến mức có thể gọi đây là Claude Code Framework Wars
• Từ đó, đang hình thành một xu hướng sử dụng Claude cho nhiều vai trò như quản lý dự án, kiến trúc sư, lập trình viên, reviewer
• Việc thiết kế framework đòi hỏi 8 quyết định chính, gồm quản lý công việc, cung cấp chỉ dẫn, cộng tác tác tử, vận hành phiên, truy cập công cụ, phát triển mã, chuyển giao, bảo toàn ngữ cảnh
• Bài học cốt lõi là AI không thay thế nhà phát triển mà trở thành đồng đội giúp nhân bội năng suất thông qua các quy tắc và vai trò được cấu trúc rõ ràng

---

Mở đầu

• Ý tưởng cốt lõi: xem Claude không phải là công cụ hội thoại đơn thuần mà là một framework, tạo ra kết quả có giá trị và có thể dự đoán được thông qua các quy tắc rõ ràng cùng luồng công việc cụ thể
  • Nhà phát triển chuyển từ việc viết code sang các vai trò giá trị cao hơn như quản lý dự án, thiết kế, kiến trúc
  • Framework Claude Code hoạt động bằng prompt có cấu trúc mà không cần viết code
• Claude Code Framework Wars: cộng đồng nhà phát triển đang thử nghiệm nhiều cách tiếp cận khác nhau để khai thác AI một cách hiệu quả
  • Hàng chục dự án mã nguồn mở đang cạnh tranh bằng cách định nghĩa luồng công việc và cấu trúc vai trò
  • Ví dụ: Agent OS, Claude-Flow

Các lựa chọn chính cần cân nhắc khi thiết kế framework

1. Vị trí quản lý công việc

• Cần xác định nguồn công việc mà Claude có thể tham chiếu
  • Backlog Markdown: quản lý công việc bằng danh sách việc cần làm ở định dạng Markdown
    • Ví dụ: Backlog.md, ReqText
  • Văn bản có cấu trúc: chuyển đặc tả sản phẩm thành công việc
    • Ví dụ: Agent OS
  • Issue/ticket: lưu đặc tả trong GitHub Issues hoặc ticket Jira và liên kết với code review
    • Ví dụ: ccpm
• Cốt lõi: công việc phải được lưu ở nơi Claude có thể truy cập và theo dõi được

2. Cách cung cấp hướng dẫn cho Claude

• Thay vì prompt mơ hồ, cần cung cấp chỉ dẫn cho Claude bằng cấu trúc rõ ràng
  • Thư viện lệnh: các lệnh slash được định nghĩa sẵn như /create-tasks, /review
  • Tiêu chuẩn coding: nêu rõ tech stack và guideline lập trình
  • Định nghĩa hoàn thành: mã hóa tiêu chí hoàn tất công việc
  • Hook xác minh kích hoạt: bắt buộc linting và test với mọi thay đổi
  • Claude reviewer: Claude đồng thời thực hiện cả phát triển lẫn review
• Cốt lõi: các quy tắc rõ ràng và có thể lặp lại giúp nâng cao chất lượng công việc của Claude

3. Cấu trúc cộng tác giữa các tác tử

• Khi dùng nhiều tác tử Claude, cần điều phối bằng vai trò và kế hoạch
  • Mô phỏng vai trò: AI đảm nhận các vai trò PM, kiến trúc sư, lập trình viên, tester
    • Ví dụ: Agent OS
  • Xử lý song song kiểu swarm: chạy đồng thời nhiều tác tử trong luồng có cấu trúc từ đặc tả → mã giả → code → test
    • Ví dụ: Claude-Flow
  • Artifact gốc theo repository: lưu công việc, log, bản ghi quyết định (ADR) trong codebase để duy trì bộ nhớ
    • Ví dụ: Roo Commander
• Cốt lõi: điều phối giúp tránh xung đột giữa nhiều AI worker

4. Cách vận hành phiên

• Để tránh sự lộn xộn trong đầu ra của AI, cần thiết lập session làm môi trường làm việc
  • Điều phối terminal: Claude kiểm soát lệnh, cửa sổ, log
    • Ví dụ: Symphony, Claude-Squad
  • Worktree song song: chạy nhiều nhánh song song bằng Git Worktrees
    • Ví dụ: Crystal
  • Container song song: chạy Claude trong các container độc lập để tránh xung đột
    • Ví dụ: ClaudeBox
• Cốt lõi: tối đa hóa năng suất bằng công việc song song mà không xảy ra xung đột

4. Cách thực thi phiên

• Để tránh sự lộn xộn trong đầu ra của AI, cần thiết lập session làm môi trường làm việc
  • Điều phối terminal: Claude kiểm soát lệnh, cửa sổ, log
    • Ví dụ: Symphony, Claude-Squad
  • Worktree song song: chạy nhiều nhánh song song bằng Git Worktrees
    • Ví dụ: Crystal
  • Container song song: chạy Claude trong các container độc lập để tránh xung đột
    • Ví dụ: ClaudeBox
• Cốt lõi: tối đa hóa năng suất bằng công việc song song mà không xảy ra xung đột

5. Truy cập công cụ của Claude

• Cấu hình để Claude tận dụng kiến thức trên toàn bộ tech stack
  • Tích hợp MCP: kết nối trình duyệt, cơ sở dữ liệu, test runner, framework tự động hóa UI
  • Thư viện công cụ tùy chỉnh: xây dựng bằng shell script và câu lệnh
    • Ví dụ: Symphony
  • Trình truy cập cơ sở dữ liệu: công cụ truy cập cơ sở dữ liệu mạnh mẽ
    • Ví dụ: Claudable with Supabase
  • Hook test và xác minh: chạy test bằng Vitest, Jest... trước khi hoàn tất công việc
    • Ví dụ: Agent OS
• Cốt lõi: tích hợp công cụ biến Claude từ công cụ tự động hoàn thành đơn thuần thành một thành viên chủ động của nhóm

6. Cách phát triển mã

• Claude đảm nhận nhiều vai trò khác nhau tùy nhu cầu
  • Quản lý dự án (PM): chuyển đặc tả sản phẩm thành công việc và backlog
    • Ví dụ: ccpm, Agent OS
  • Kiến trúc sư: thiết kế cấu trúc tổng thể, định nghĩa interface, đặt quy tắc trước khi coding
  • Người triển khai: viết code theo test và tiêu chuẩn
  • QA: rà soát vấn đề trong công việc
    • Ví dụ: BMAD-code
  • Reviewer: kiểm tra chất lượng PR, độ dễ đọc, rủi ro
• Cốt lõi: khai thác AI trên toàn bộ vòng đời phần mềm

7. Cách chuyển giao mã

• Xác định cách thức code đi vào repository
  • Khác biệt nhỏ: AI xử lý ticket và tạo PR nhỏ, luôn có review
    • Ví dụ: ai-ticket
  • Thử nghiệm: triển khai thay đổi sau feature flag
  • Scaffold toàn bộ ứng dụng: xây dựng và triển khai trọn vẹn ứng dụng bằng prompt cấp cao
    • Ví dụ: Claudable
• Cốt lõi: chọn vòng lặp an toàn cho production hoặc scaffold dành cho nguyên mẫu

8. Cách bảo toàn ngữ cảnh

• Giải quyết vấn đề hay quên của Claude bằng bộ nhớ framework
  • Tài liệu và nhật ký: liên tục cập nhật CLAUDE.md, ghi chú kiến trúc, nhật ký dự án
    • Ví dụ: Claude Conductor
  • Bộ nhớ bền vững và kiểm tra định kỳ: tóm tắt công việc gần đây, kiểm tra sức khỏe dự án, lưu quyết định
    • Ví dụ: Claude-Flow
• Cốt lõi: không có bộ nhớ thì AI sẽ lặp lại lỗi; có bộ nhớ thì tiến độ được tích lũy

Cách kết hợp

• Hãy coi các lựa chọn như một menu, không cần thiết lập tất cả cùng một lúc
  • Thiết lập cho người mới bắt đầu: backlog Markdown + khác biệt ticket
  • Nhóm có cấu trúc: đặc tả sản phẩm + tiêu chuẩn + mô phỏng vai trò
  • Thiên về thử nghiệm: artifact trong repository + session song song
  • Chế độ nguyên mẫu: app builder + scaffold tài liệu

Kết luận và hàm ý

• Bài học cốt lõi: Claude phát huy hiệu quả tốt nhất trong môi trường có cấu trúc
  • Không phải thay thế vai trò của nhà phát triển, mà là giảm công việc boilerplate để tập trung vào định nghĩa đặc tả, review thiết kế và xác định kiến trúc
  • Nếu công việc đi sai hướng, nó có thể nhanh chóng trật đường ray, vì vậy quản lý có cấu trúc là điều bắt buộc
• Dù vẫn còn ở giai đoạn đầu, các framework đang đưa AI đến gần hơn với tập hợp thành viên nhóm có thể quản lý được thay vì một chiếc hộp ma thuật
  • Càng cung cấp nhiều cấu trúc, giá trị nhận lại càng lớn
• Thông qua các dự án mã nguồn mở, cộng đồng đang thử nghiệm nhiều framework khác nhau để tìm cách sử dụng AI hiệu quả
  • Ví dụ: Symphony, ClaudeBox
• Nhà phát triển có thể tận dụng Claude một cách có hệ thống để tập trung vào công việc giá trị cao và tích hợp AI như một thành viên trong nhóm nhằm tối đa hóa năng suất