Dàn nhạc Giao hưởng và Chiếc Gậy của Nhạc trưởng: Làm chủ Claude Code

⚡ TLDR

Giải quyết vấn đề gì: Tình trạng “trông trẻ AI” - khi Agent cứ làm sai ý, quên luật dự án, hoặc tự ý refactor búa xua khiến bạn mệt mỏi.
Tại sao nó quan trọng: Nếu không có hệ thống điều phối, bạn không phải đang lập trình; bạn đang “thương lượng” với một cái máy. Bạn sẽ tốn 80% thời gian để gõ “yes” và “no”.
Dành cho ai: Những dev đã chán việc chat dạo và muốn xây dựng những hệ thống Agent tự vận hành (Agentic Workflows) thực thụ trong terminal.
Điểm khác biệt: Nó hệ thống hóa lại toàn bộ cách mà chính đội ngũ Anthropic đang dùng để build Claude Code, tập trung vào mô hình Command → Agent → Skill.
Ví dụ thực tế: Một lệnh /deploy không chỉ chạy script, mà nó sẽ tự đẻ ra một “Trợ lý con” để check lỗi, sau đó mới dùng một “Kỹ năng” riêng để đẩy code lên cloud.

Hồi mới xài Claude Code tuần đầu, tôi cứ ngỡ mình đang thuê được một thiên tài về làm việc cho mình.

Nhưng sau vài ngày, tôi mới nhận ra: không phải tôi thuê thiên tài, mà là tôi đang đi làm… bảo mẫu cho thiên tài.

Tôi nhờ nó sửa cái nút Search. Nó sửa xong, xong nó hỏi: “Chạy test nha anh?”. Tôi bấm Yes. Xong nó lại hỏi: “Cho em quyền đọc file logs nha?”. Tôi lại Yes. Loay hoay một hồi, cái PR cũng xong, nhưng tôi thấy mình tốn thời gian gõ chữ “Yes” với check terminal còn nhiều hơn là lúc ngồi thiết kế tính năng.

Tôi cứ tưởng mình đang làm việc nhanh. Hóa ra tôi chỉ đang làm một anh thư ký mẫn cán cho cái terminal của chính mình.

Cho đến khi tôi va phải cái repo Claude Code Best Practice của ông shanraisshan.

Kim chỉ nam của dự án

Về mặt vật lý, cái repo này là một mớ các file Markdown hướng dẫn, các file JSON cấu hình và mấy cái sơ đồ ASCII nhìn phát là hiểu ngay. Nó không phải là một thư viện để bạn cài vào máy; nó là một Ngôn ngữ Thiết kế cho Agent.

Nó chính là “Kinh thánh” cho những ai đang muốn theo đuổi ngành Agentic Engineering (Kỹ nghệ Agent).

Dành cho những ai chưa biết, Claude Code không chỉ là cái chatbot. Nó là một Môi trường Thực thi (Runtime). Và cái repo này dạy bạn cách biến nó từ một đứa trẻ ham học thành một đội đặc nhiệm tinh nhuệ.

Mô hình ذهني: Nhạc trưởng và Bản giao hưởng

Hãy tưởng tượng một dàn nhạc giao hưởng. Bạn có đàn dây, kèn, trống… Mỗi nhạc công đều rất giỏi. Nhưng nếu không có một bản nhạc chung - cái tệp giấy nằm trên giá nhạc để bảo ai chơi lúc nào - thì cái dàn nhạc đó chỉ là một mớ âm thanh hỗn độn.

Claude Code chính là cái dàn nhạc đó. Những Sub-agent (trợ lý con), Command (lệnh bài), và Skill (kỹ năng chuyên biệt) chính là các nhạc cụ.

Và cái repo này chính là Bản Tổng phổ (Total Score).

Nó giới thiệu cho bạn mô hình Command → Agent → Skill. Ở mô hình này, bạn không chỉ “prompt” (nhắc nhở) Agent một cách vu vơ. Bạn dùng một cái Lệnh (chiếc gậy nhạc trưởng) để điều phối các Agent (các chuyên gia), rồi các Agent này sẽ dùng Skill (nhạc cụ) để tạo ra bản nhạc (code).

Khoảnh khắc “À há!”: /weather-orchestrator

Tôi cứ tưởng cái repo này chỉ dạy cách viết prompt sao cho hay. Nhưng không, cái làm tôi “té ghế” là tệp Orchestration Workflow.

Nó dùng ví dụ lấy dữ liệu thời tiết để chỉ cho mình một cách làm cực kỳ tinh tế: Một cái lệnh /weather-orchestrator duy nhất có thể điều phối cả một hệ thống. Đầu tiên, nó hỏi bạn thích độ C hay độ F. Sau đó, nó tự đẻ ra một “ông Sonnet” (mô hình mạnh nhất) có sẵn kỹ năng fetching để đi lấy data. Lấy xong, nó lại đưa data đó cho một “ông Haiku” (mô hình rẻ, nhanh) để vẽ cái card SVG thời tiết.

Nó là sự phân công lao động cực kỳ logic giữa các Agent.

Tình huống	Cách xài “bình dân”	Cách xài “nhạc trưởng”
Thêm tính năng	”Viết cho mình cái login page” + 4 câu chat giải thích	Dùng lệnh `/plan` (nó sẽ phỏng vấn bạn ngược lại) → `/execute` (nó tự chạy TDD)
Fix bug	Dán lỗi vào rồi cầu nguyện	Dùng lệnh `/debug` (nó tự đẻ ra Agent QA để tìm nguyên nhân gốc rễ)
Review PR	Bạn ngồi đọc lòi mắt	Tag `@claude` vào PR để nó tự cập nhật luật vào file `CLAUDE.md`

Ví dụ “quốc dân”: File CLAUDE.md chuyên nghiệp

Hầu hết file CLAUDE.md của anh em mình là một mớ hỗn độn những quy tắc cũ kỹ. Cái repo này dạy bạn cách coi nó như một Hiến pháp Sống.

Thay vì dặn Claude “Nhớ dùng Tailwind nha”, bạn định nghĩa hẳn một giao thức:

<!-- Trích từ repo Best Practice -->
<important>
Nếu có thay đổi giao diện (UI): 
1. Phải gọi agent `ui-specialist` qua lệnh `Agent(agent: "ui-specialist")`
2. Đảm bảo hook `PostToolUse` chạy lệnh `npm run lint:css`
3. Tuyệt đối không được bỏ qua skill `/verify-styles`.
</important>

Nó biến một lời dặn dò vu vơ thành một bước kiểm tra mang tính định mệnh của cái máy.

13 bí kíp của Boris: Học cách nhìn như một Agent

Cái “kho báu” nằm sâu trong repo này là tuyển tập 13 bí kíp từ Boris Cherny, cha đẻ của Claude Code.

Bí kíp tôi thích nhất? “Chạy 5 cái Claude song song.”

Nghe có vẻ điên rồ, nhưng mà xài rồi mới thấy nó sướng. Bạn đánh số tab terminal từ 1 tới 5. Tab 1 đang chạy migration tốn 10 phút, tab 2 đang đi nghiên cứu API của thư viện mới, tab 3 thì đang ngồi code giao diện. Bạn không bao giờ phải ngồi đợi cái máy nữa. Cái máy mới là đứa phải đợi bạn.

Chẩn đoán: Thay đổi tư duy trong thực tế

Khi bắt đầu áp dụng những bộ khung này, tư thế ngồi làm việc của bạn sẽ khác hẳn:

Bạn bớt “trông trẻ”: Bạn không ngồi dòm terminal nó chạy nữa. Bạn cài mấy cái hook (như PostToolUse trong repo) để nó tự format code, tự chạy test xong xuôi hết đi rồi mình mới vào coi.
Bạn nhân bản được chất xám: Bạn dùng Subagents cho những bài toán khó mà một khung context không chứa nổi. Bạn đẩy việc “linting” hay “research” cho các agent riêng biệt để Agent chính của bạn luôn giữ được sự tỉnh táo.
Bạn xây dựng “Bản năng”: Mỗi lần thấy Agent làm sai cái gì, bạn không chỉ sửa rồi thôi. Bạn cập nhật file CLAUDE.md dùng chung cho cả team. Bạn đang dạy cho cái máy “cái gu” code của chính bạn.

Lưu ý thực tế: Cái giá của sự cầu kỳ

Cái gì cũng có cái giá của nó. Nếu bạn dành ra 3 ngày để code một cái lệnh /deploy-cực-ngầu với 5 agent con chỉ để deploy một cái web tĩnh… thì thôi rồi, bạn đang tự làm khổ mình đó.

Chính Boris cũng nói setup của ổng “surprisingly vanilla” (cực kỳ đơn giản). Ổng không ham làm quá. Ổng chỉ xài những cái gì thực sự hiệu quả.

Cái repo này giống như một cái menu trong nhà hàng 5 sao. Bạn chỉ nên gọi món khi dự án của bạn đã đủ lớn, hoặc khi bạn bắt đầu làm việc theo team. Đừng để mình bị cuốn vào việc “thiết kế hệ thống điều phối” mà quên mất việc chính là ship code.

Lời kết

Kỷ nguyên Agent không phải là việc chúng ta có một cái máy tính thông minh hơn. Đó là việc chúng ta có một bản nhạc hay hơn cho dàn nhạc của mình.

Claude Code Best Practice chính là bản nhạc đó. Nó là sự khác biệt giữa việc ngồi nghe một tiếng kèn lẻ loi và việc được thưởng thức cả một bản giao hưởng hùng tráng.