Claude Code thông minh nhưng đôi khi lạc lối do thiếu ngữ cảnh, và bạn muốn AI tự động tuân thủ quy tắc, chạy test, review code mà không cần nhắc? Bài này giới thiệu 6 tầng tổ chức Claude Code chuyên nghiệp.
1️⃣ LAYER 1 – CLAUDE.md: "HIẾN PHÁP" CỦA DỰ ÁN Đây là file được load mỗi phiên làm việc, chứa:
- Quy tắc kiến trúc (architecture rules)
- Quy ước đặt tên (naming conventions)
- Chuẩn code (coding standards)
- Kỳ vọng về test (test expectations)
- Bản đồ repo & ngữ cảnh (repo map & context)
📌 Mẹo: Hãy viết CLAUDE.md trước khi code. Nó giống như "bản thiết kế" để Claude không lạc hướng.
2️⃣ LAYER 2 – SKILLS: "KỸ NĂNG" CẤP THEO YÊU CẦU Skills là những module kiến thức chuyên sâu, không load hết mà chỉ kích hoạt khi cần (on‑demand). Ví dụ:
- Mô tả khớp (description matching) → AI tự chọn skill phù hợp.
- Auto‑invoked hoặc gọi thủ công.
Lợi ích: Giữ context gọn nhẹ, không "loãng" thông tin. Giống như bạn chỉ lấy đúng cuốn sách mình cần trên giá, chứ không khiêng cả tủ sách ra.
3️⃣ LAYER 3 – HOOKS: "BẪY" SỰ KIỆN ĐỂ TỰ ĐỘNG HÓA Hooks chạy các script tại những thời điểm quan trọng:
- PreToolUse (trước khi dùng tool) – tự động chạy linter, block lệnh rm -rf.
- PostToolUse (sau khi dùng tool) – gửi thông báo, log kết quả.
- SessionStart / Stop / SubagentStop – khởi tạo hoặc dọn dẹp.
📌 Ví dụ thực tế: Mỗi lần Claude ghi file, hook tự động format code và chạy test. Bạn không cần nhắc.
4️⃣ LAYER 4 – SUBAGENTS: "CHUYÊN GIA" ĐƯỢC ỦY QUYỀN Subagents là những AI nhỏ, chuyên làm một việc cụ thể trong môi trường cô lập:
- code-reviewer – chỉ review code.
- test-runner – chỉ chạy test.
- explorer – khám phá codebase.
- security-auditor – quét bảo mật.
Lợi ích: Giữ cho main agent không bị "quá tải" context. Bạn giao việc, subagent làm xong trả kết quả.
5️⃣ LAYER 5 – PLUGINS: "KHO TIỆN ÍCH" DÙNG CHUNG Plugin đóng gói skills, agents, hooks, commands thành một gói cài đặt được, chia sẻ qua marketplace hoặc trong team.
Tiết kiệm thời gian: Không phải tự viết lại những thứ đã có.
6️⃣ THE MEMORY LAYER + KNOWLEDGE LAYER + GUARDIAN LAYER + DISTRIBUTION LAYER Memory Layer: ~/.claude/CLAUDE.md (global) + CLAUDE.md (project). Luôn được load, là "hiến pháp" bất biến.
Knowledge Layer: Reference docs, scripts, templates, playbooks – cung cấp context cho subagent.
Guardian Layer: Hooks chặn lệnh nguy hiểm, gửi thông báo Slack, tự động bảo vệ.
Distribution Layer: Đóng gói và cài đặt qua marketplace, mỗi plugin có context window, tools, permissions riêng – cách ly an toàn.
II. ADVANCED PATTERNS (Cái này hơi nâng cao tý)
- Spec‑to‑Prod Pipeline: Dùng Skills + Subagents để đi từ spec → code → test → deploy.
- Multi‑Repo Orchestration: Phối hợp thay đổi trên nhiều repo bằng subagents và hooks.
- Self‑Improving Docs: Hooks tự động cập nhật docs, diagrams, changelog.
- Security by Default: PreToolUse hooks chặn lệnh nguy hiểm và secret.
Knowledge Graph Memory: Kết hợp Skills với vector stores để có trí nhớ dài hạn.
III. LỜI KHUYÊN CHO CỦA TÔI
- Design với CLAUDE.md trước – Xác định kiến trúc, ranh giới, tiêu chuẩn ngay từ đầu.
- Giữ context modular – Dùng Skills cho kiến thức chuyên sâu, chỉ load khi cần.
- Tự động hóa quality với Hooks – Linter, test, security scan chạy ngầm.
- Ủy quyền thông minh – Dùng Subagents cho các tác vụ cô lập, giữ main context sạch sẽ.
- Đóng gói & chia sẻ – Biến skills, hooks, agents thành plugin, dùng chung trong team.
- Liên tục cải tiến – Theo dõi cái gì hoạt động tốt, tinh chỉnh rules, skills, automation.
#ClaudeCode #AIAgent #VibeCoding #DevVietNam #SinhVienIT #Automation #BackendDevelopment #AIWorkflow
