Bạn đang dùng Claude Code mỗi ngày nhưng vẫn phải giải thích đi giải thích lại cùng một thứ, lần nào cũng từ đầu? Đó là dấu hiệu rõ ràng nhất của việc thiếu một hệ thống tổ chức. AI-Agent-Master ra đời để giải quyết đúng vấn đề đó — không phải thêm một công cụ mới, mà là một bộ khung giúp bạn tổ chức AI làm việc có kỷ luật, nhất quán và có thể mở rộng theo thời gian.
AI-Agent-Master là gì?
AI-Agent-Master là một template cấu trúc thư mục đặt bên trong thư mục .claude/ của dự án — nơi Claude Code đọc cấu hình và hướng dẫn trước khi làm bất kỳ việc gì. Thay vì chỉ có một file CLAUDE.md chứa vài dòng ghi chú, AI-Agent-Master tổ chức toàn bộ “bộ não” của AI thành 5 tầng rõ ràng: Agents, Skills, Commands, Rules, References.
Nếu bạn đã từng làm việc nhóm, cách tiếp cận này quen thuộc lắm. Nó giống như bạn có một đội dev với mỗi người một chuyên môn, có quy trình làm việc rõ ràng, có tài liệu chuẩn — thay vì một người làm tất cả mà không ai biết người kia đang làm gì.
Tại sao cần cấu trúc này?
Hầu hết mọi người dùng Claude Code theo kiểu “nhắn tin trực tiếp” — hỏi câu nào, trả lời câu đó, xong rồi thôi. Cách đó ổn cho việc nhỏ, nhưng khi dự án lớn dần, bạn sẽ đụng ngay vào vài vấn đề:
- AI không nhớ quyết định kỹ thuật từ buổi trước
- Mỗi lần bắt đầu phải giải thích lại cách đặt tên biến, cách tổ chức folder, cách deploy
- Cùng một task, hôm nay AI làm theo cách này, tuần sau làm theo cách khác
- Không có cách nào để “nhân bản” quy trình sang dự án mới
AI-Agent-Master giải quyết tất cả những điều này bằng cách đóng gói kinh nghiệm và quy tắc vào các file cấu hình — để AI tự đọc, tự áp dụng, không cần bạn nhắc nhở mỗi lần.
5 thành phần cốt lõi AI-Agent-Master
1. Agents — Phân vai rõ ràng, không ai làm thay ai
agents/
├── project-manager.md
└── ui-ux-designer.mdThay vì để một AI ôm đồm hết từ code đến thiết kế đến quản lý dự án, bạn tạo các agent chuyên biệt. PM Agent chịu trách nhiệm lập kế hoạch, viết PRD, chia sprint. UI/UX Designer Agent lo wireframe, design tokens, trải nghiệm người dùng.
Khi Claude Code kích hoạt một agent, nó tạo ra một cửa sổ ngữ cảnh riêng biệt — giống như giao việc cho một đồng nghiệp chuyên môn. Agent đó làm xong, tổng hợp kết quả lại, báo cáo về cho phiên làm việc chính. Cuộc hội thoại của bạn không bị ngập trong hàng trăm dòng log trung gian.
Mẹo nhỏ: Bạn có thể mở rộng thêm agent bất kỳ lúc nào — thêm
backend-engineer.md,security-auditor.md,devops.md— mỗi cái một file Markdown với hướng dẫn vai trò.
2. Skills — Kinh nghiệm được “đóng hộp” sẵn
skills/
├── policies/write-guard.md
├── plans/plan.md
├── token/token.md
├── multi-agent/multi-agent.md
├── device-fingerprint/
├── monitoring/
├── payment/payment-gateway.md
├── prod-incident/
└── rabbitmq/Mỗi skill là một tài liệu hướng dẫn chi tiết về một kỹ năng cụ thể. Khi Claude Code gặp một task phù hợp, nó tự động kéo skill đó vào ngữ cảnh và làm theo đúng quy trình.
Ví dụ, token/token.md chứa hướng dẫn về “kỷ luật token” — cách sử dụng ngữ cảnh tiết kiệm để không “đốt tiền” AI không cần thiết. payment/payment-gateway.md chứa toàn bộ cách tích hợp SePay và VietQR — thứ bạn không muốn phải giải thích lại mỗi lần có dự án mới thanh toán.
Cái hay là skills có thể tái sử dụng hoàn toàn. Bạn chỉ cần viết một lần, mọi dự án sau đều dùng được.
3. Commands — Gõ một lệnh, AI tự làm hết
commands/
├── build.md
├── harden.md
├── monitoring.md
├── seo.md
├── spec.md
└── ssh-vps.mdĐây là phần nhiều người thấy “ảo” nhất nhưng thực ra rất thực tế. Bạn gõ /build, Claude Code không chỉ viết code — nó đọc file build.md, thực hiện toàn bộ quy trình từ lên kế hoạch đến viết code đến chạy test theo đúng thứ tự đã định.
Một số lệnh có sẵn trong bộ này:
/harden— Bảo mật VPS theo 6 quy tắc chuẩn/monitoring— Cài đặt Prometheus + Grafana tự động/ssh-vps— Thiết lập SSH, kết nối GitHub, deploy lên VPS/seo— Chạy checklist SEO cho dự án web
Lưu ý: Commands trong
.claude/commands/khác với lệnh slash mặc định của Claude Code. Đây là lệnh tùy chỉnh bạn định nghĩa — AI sẽ đọc file Markdown tương ứng và làm theo hướng dẫn trong đó.
4. Rules — Luật không được phá vỡ
rules/
├── naming-conventions.md
└── project-structure.mdRules là nơi bạn ghi xuống những quy tắc “không bàn cãi” của dự án. Cách đặt tên biến trong database, cách tổ chức folder Go, cách đặt tên biến môi trường — tất cả đều nằm ở đây.
Điểm khác biệt giữa Rules và Skills: Skills là “cách làm”, Rules là “phải làm thế này, không được làm khác”. Bất kỳ agent nào, bất kỳ task nào, đều phải tuân theo Rules trước tiên.
Theo tài liệu Claude Code, bạn nên giữ mỗi file trong rules/ ngắn gọn và cụ thể — lý tưởng nhất là dưới 80 dòng. Quá dài, AI bắt đầu bỏ qua phần cuối.
5. References — Thư viện kiến thức sâu
references/
├── RBAC.md
├── auth-flow.md
├── deploy-workflow.md
├── docker.md
├── domain-ssl-checklist.md
├── multi-app-infra.md
├── sepay-integration-playbook.md
└── backup/
├── push-backup-gdrive.md
└── pull-backup-gdrive.mdReferences là tầng sâu nhất — nơi chứa tài liệu kỹ thuật chi tiết mà AI kéo vào khi thực sự cần. Không phải lúc nào cũng tải hết vào ngữ cảnh, chỉ khi task yêu cầu.
Ví dụ, auth-flow.md giải thích toàn bộ luồng xác thực với JWT + Refresh Token + Redis Blacklist. RBAC.md mô tả hệ thống phân quyền. sepay-integration-playbook.md là playbook tích hợp thanh toán SePay/VietQR — thứ rất hữu ích cho dev Việt Nam xây sản phẩm có thanh toán nội địa.
Cách bắt đầu
Nếu bạn muốn dùng mô hình này, cách đơn giản nhất là:
Bước 1 — Tạo cấu trúc thư mục cơ bản
mkdir -p .claude/{agents,skills,commands,rules,references}Bước 2 — Viết file CLAUDE.md ở gốc dự án
File này là cửa vào — Claude Code đọc nó đầu tiên trong mỗi phiên. Ghi ngắn gọn: ngăn xếp kỹ thuật, các lệnh build/test, chỉ dẫn đến thư mục nào khi cần gì. Theo khuyến nghị từ cộng đồng Claude Code, giữ file này dưới 80 dòng để AI không bỏ qua phần cuối.
Bước 3 — Tạo từng file theo nhu cầu thực tế
Đừng cố tạo tất cả ngay lập tức. Bắt đầu với những thứ bạn hay phải giải thích lại nhất — có thể là quy tắc đặt tên, có thể là quy trình deploy. Viết thành file Markdown, đặt vào đúng thư mục.
Bước 4 — Thêm lệnh /build, /harden vào commands/
Tạo file commands/build.md với các bước quy trình xây dựng tính năng. Từ lần sau, thay vì giải thích từ đầu, bạn chỉ cần gõ /build và mô tả tính năng cần làm.
Mẹo nhỏ: Claude Code cũng hỗ trợ đặt file
CLAUDE.mdtrong từng thư mục con — ví dụsrc/auth/CLAUDE.mdchỉ được tải khi AI đang làm việc trong module xác thực. Dùng cách này để tránh nhồi nhét tất cả vào một file duy nhất.
Ai nên dùng mô hình này?
Nếu bạn chỉ dùng Claude Code thỉnh thoảng để hỏi vài câu nhanh, mô hình này có vẻ phức tạp hơn cần thiết. Nhưng nếu bạn đang:
- Làm dự án kéo dài nhiều tuần, nhiều tháng
- Dùng Claude Code mỗi ngày và chán phải nhắc lại cùng một quy tắc
- Muốn đồng đội (hoặc AI khác) làm việc nhất quán theo cùng một tiêu chuẩn
- Xây sản phẩm thực tế với deployment, thanh toán, bảo mật
…thì AI-Agent-Master đáng để đầu tư thời gian thiết lập từ đầu. Chi phí bỏ ra một lần, lợi ích gặt về mỗi ngày sau đó.
Cấu trúc .claude/ tốt không phải là thứ bạn tạo ra rồi quên — nó là một tài liệu sống, lớn dần theo dự án. Mỗi lần AI mắc lỗi một kiểu nào đó và bạn sửa lại, hãy ghi vào Rules. Mỗi lần phải giải thích một quy trình phức tạp, hãy đóng gói thành Skill. Dần dần, bạn sẽ có một “đội dev AI” hiểu dự án của mình hơn bất kỳ AI mới nào vừa được bật lên.
Thử bắt đầu với một file Commands đơn giản xem sao — chỉ mất 15 phút nhưng có thể tiết kiệm cho bạn hàng giờ giải thích về sau.
Để lại một bình luận