16.0 · Tổng quan khóa học

Tại sao bạn nên học khóa này?

• Paste lại cùng một đoạn instruction code review dài chục dòng mỗi lần bạn review PR
• Xem main context fill 30-40% chỉ để tìm "service nào handle refund"
• Nhắc Claude lại cùng convention của team vì session mới nó quên
• Dùng Claude review code nó vừa giúp bạn viết — nhận feedback "looks good" dù có vấn đề
• Copy prompt brand voice 200 dòng vào đầu mỗi copywriting session

Nếu bạn dành hơn 3 giờ/tuần cho những việc lặp lại trên, khóa này cho bạn một cơ chế cấu trúc để giải quyết triệt để: subagent.

Subagent là trợ lý chuyên biệt mà Claude Code delegate task đến — mỗi cái chạy trong context window riêng, trả về summary gọn gàng cho main thread. Nó giải quyết 3 vấn đề cùng lúc: context overflow, instruction repetition, và consistency across team.

Bạn sẽ học được gì?

Sau khi hoàn thành khóa học này, bạn sẽ có thể:

Về tư duy

• Phân biệt khi nào subagent là công cụ đúng, khi nào main thread tốt hơn
• Nhìn subagent trong context lớn hơn của multi-agent architecture
• Reasoning bằng "decision rule" thay vì copy pattern một cách mù quáng

Về kỹ năng

• Tạo subagent từ 0 bằng /agents slash command, cấu hình scope / tool / model đúng
• Viết description điều khiển được cả khi nào Claude gọi và cái gì được pass vào
• Thiết kế output format có cấu trúc — biến subagent "lan man" thành "report đúng 5 section"
• Áp dụng principle of least privilege cho tool access
• Audit subagent hiện có, nhận diện anti-pattern, redesign

Về thực hành

• Tạo được code-quality-reviewer production-ready cho team của bạn
• Có template description, output format, obstacle reporting để copy-paste
• Có framework audit để review toàn bộ subagent hiện có của project

Lộ trình 5 bài học (+ quiz)

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  MODULE: Introduction to Subagents                          │
│                                                             │
│  ├── Bài 16.0: Tổng quan khóa học (file này)                │
│  │                                                          │
│  ├── Bài 16.1: Tạo subagent đầu tiên                        │
│  │   /agents command, config file, tool/model/color         │
│  │                                                          │
│  ├── Bài 16.2: Thiết kế subagent hiệu quả                   │
│  │   Description shaping, output format, obstacle report    │
│  │                                                          │
│  ├── Bài 16.3: Dùng subagent đúng cách                      │
│  │   Decision rule, 3 anti-patterns phải tránh              │
│  │                                                          │
│  ├── Bài 16.4: Subagent là gì (mental model)                │
│  │   Context isolation, built-in, multi-agent architecture  │
│  │                                                          │
│  └── Bài 16.5: Quiz tổng kết + checklist thực hành          │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Tổng thời gian ước tính: 2-2.5 giờ đọc + 1-1.5 giờ thực hành = 3.5-4 giờ hoàn thành.

Lưu ý thứ tự

4 bài chính (16.1 → 16.4) được đánh số theo thứ tự ngày tạo source (cũ nhất = số nhỏ nhất). Điều này có nghĩa thứ tự là hands-on trước, khái niệm sau: bạn tạo subagent (16.1), tinh chỉnh nó (16.2), biết khi nào dùng (16.3), rồi mới quay lại build mental model đầy đủ (16.4).

Nếu bạn là người thích khái niệm trước, có thể đọc 16.4 trước — mỗi bài viết self-contained. Cả 2 thứ tự đều work.

Cách học tập hiệu quả nhất

Quy tắc 70/20/10 áp dụng cho khóa này

• 70% thực hành — tạo subagent thật trong project của bạn, test, fix, iterate
• 20% học từ team và case study — chia sẻ subagent với đồng nghiệp, nhận feedback
• 10% lý thuyết — phần mental model (16.4) và decision rule (16.3)

3 nhóm người đọc — 3 cách tiếp cận

Nếu bạn là developer đang dùng Claude Code hàng ngày:

• Đọc 16.1 → 16.2 → làm exercise tạo code-quality-reviewer cho project của bạn ngay
• Đọc 16.3 để audit subagent hiện có (nếu đã có)
• Đọc 16.4 khi rảnh để có big picture

Nếu bạn là tech lead / engineering manager:

• Đọc 16.3 trước — decision rule và anti-patterns để quy định "khi nào team tạo subagent"
• Đọc 16.2 để review design của subagent team đã tạo
• Dùng Bài 16.0 + 16.4 này làm material onboarding team mới

Nếu bạn là người mới với Claude Code:

• Đảm bảo bạn đã dùng Claude Code cơ bản trước (ít nhất đã làm quen với chat, tool calling, project setup)
• Bắt đầu với 16.4 (mental model) để hiểu pattern
• Sau đó 16.1 → 16.2 → 16.3 theo thứ tự

Những gì bạn cần chuẩn bị

Bắt buộc

• Claude Code đã cài đặt và hoạt động — desktop app, VS Code extension, hoặc CLI
• Một project repo (của bạn hoặc fork public repo) để thực hành
• 15-20 phút thời gian không gián đoạn cho mỗi bài

Nên có

• Kinh nghiệm cơ bản với Claude Code: / slash commands, chat với tool calling, basic file operations
• Đã từng dùng main thread review code hoặc research codebase (để thấy pain point subagent giải quyết)
• Hiểu cơ bản về YAML syntax

Không cần

• Không cần biết Anthropic API hay SDK (khóa này focus Claude Code, không phải API)
• Không cần kinh nghiệm multi-agent framework (LangGraph, CrewAI...) — subagent trong Claude Code là pattern riêng
• Không cần là senior developer — các ví dụ dùng được cho dev junior/mid/senior

Triết lý xuyên suốt khóa học

Có 4 nguyên tắc sẽ lặp lại trong các bài học. Hãy ghi nhớ từ đầu:

1. "Does the intermediate work matter?"

Đây là decision rule duy nhất cho việc có dùng subagent hay không. Nếu main thread cần thấy và react với từng step, giữ ở main. Nếu chỉ cần final result, delegate.

2. "Constrain, don't expand"

Subagent hiệu quả có scope hẹp + tool hạn chế + output format cứng. Reviewer không cần Edit. Research cần Read-only. Constraint là feature, không phải bug — nó làm subagent predictable và safe.

3. "Expert persona is not a capability"

"You are a Python expert" trong system prompt không add gì cho Claude — nó đã có kiến thức Python. Subagent xứng đáng tồn tại chỉ khi nó làm gì đó main thread không thể: custom prompt dài, workflow đặc biệt, context isolation.

4. "Obstacle reporting or rediscovery cost"

Mỗi lần subagent tìm ra workaround (flag đặc biệt, dependency quirk, env variable), nếu không report ra summary → người sau phải rediscover. Output format bắt buộc có "Obstacles Encountered" section.

Một lời khuyên từ kinh nghiệm thực tế

Sai lầm 1: Tạo subagent quá sớm, quá nhiều

Người mới thường tạo 10-15 subagent trong tuần đầu vì "thấy cool". Vài tuần sau hầu hết không được dùng, config rụng rạc, Claude confuse không biết gọi cái nào.

Tránh: Tạo subagent chỉ khi bạn đã làm task đó ≥ 10 lần và mỗi lần copy cùng instruction. Dưới ngưỡng đó, paste trực tiếp nhanh hơn.

Sai lầm 2: Không test, không audit

Subagent là code (config file). Cần review, cần test, cần maintain. Tạo xong quên đi là cách nhanh nhất để có subagent "ma" — vẫn được Claude gọi nhưng đã outdated criteria.

Tránh: Mỗi quý audit lại subagent list. Test subagent sau mỗi major edit. Archive/delete cái không dùng.

Sai lầm 3: Bỏ qua built-in, jump ngay vào custom

Claude Code có sẵn General purpose, Explore, Plan subagent. Nhiều task built-in đã giải quyết tốt. Tạo custom khi built-in thực sự không fit.

Tránh: Dùng built-in cho 1-2 tuần trước khi tạo custom đầu tiên. Bạn sẽ hiểu rõ hơn khi nào thực sự cần custom.

Bạn sẵn sàng chưa?

Hãy dành 5 phút ngay bây giờ để viết ra:

1. 3 task bạn làm lặp lại với Claude Code trong tuần qua (review code, research, copywriting, audit...)
2. Task nào chiếm nhiều context nhất mỗi lần (tức là, task nào làm main thread ngốn token nhất)
3. Task nào bạn paste cùng một instruction dài mỗi lần

Giữ list này trong đầu. Chúng sẽ là "sân tập" của bạn xuyên suốt khóa — sau khi học Bài 16.1, bạn sẽ biết nên tạo subagent cho task nào trước.

Bắt đầu nào

Bài 16.1 đưa bạn vào thực hành ngay: tạo subagent đầu tiên từ zero, với checklist cụ thể. Nếu bạn đang mở Claude Code, có thể làm theo từng bước song song với bài đọc — 25 phút sau bạn sẽ có code-quality-reviewer sẵn sàng review PR kế tiếp của team.

Tài liệu tham khảo tổng thể

• Claude Code Sub-agents Documentation — official reference
• Anthropic Research blog — multi-agent training, orchestrator-worker patterns
• Anthropic podcast "Building the future of agents with Claude" (2025-10-02)
• Claude Code release notes — updates về subagent feature

Phản hồi và hỗ trợ

• Gặp vấn đề kỹ thuật với Claude Code: support.anthropic.com
• Câu hỏi về khóa học: Anthropic Academy feedback channel
• Tài liệu tham khảo chuyên sâu về Claude API / Agent SDK: docs.claude.com