Task Master: turn a PRD into dependency-aware tasks for Claude Code

Giao cho Claude cả một dự án trong một prompt thường kết thúc theo cùng một kiểu: làm được 60% thì context đầy, agent quên phần đã thống nhất, bắt đầu làm lại thứ đã xong hoặc nhảy sang việc chưa đủ điều kiện. Thứ còn thiếu là một danh sách việc có thứ tự và phụ thuộc nằm ngoài đầu của model. Task Master (repo eyaltoledano/claude-task-master, khoảng 28 nghìn sao) đọc PRD của bạn, biến nó thành task có phụ thuộc, rồi cho agent hỏi "việc tiếp theo là gì?" sau mỗi bước.

GitHub: https://github.com/eyaltoledano/claude-task-master · khoảng 28 nghìn sao · JavaScript (npm task-master-ai) · MIT + Commons Clause

Cơ chế hoạt động

1. Viết PRD tại .taskmaster/docs/prd.txt (sau khi init có template mẫu ở .taskmaster/templates/example_prd.txt). README nhấn mạnh: PRD càng chi tiết, task sinh ra càng tốt.
2. Parse PRD: model chia PRD thành task có ID, mô tả, trạng thái và phụ thuộc.
3. Phân tích độ phức tạp và expand task lớn thành subtask.
4. Vòng làm việc: next → agent làm task → cập nhật trạng thái/ghi chú subtask → next. Danh sách nằm trong file của dự án, nên phiên mới hay context bị nén vẫn không mất tiến độ.

Task Master cho phép đặt ba vai model: main (sinh/sửa task), research (tra thông tin mới, tuỳ chọn nhưng được khuyến nghị) và fallback (dự phòng khi hai model kia lỗi). Ngoài ra có tag để tách nhiều luồng việc (backlog, in-progress…) và di chuyển task giữa các tag.

Cài vào Claude Code

Cách nhanh nhất là chạy như MCP server:

claude mcp add task-master-ai --scope user \
  --env TASK_MASTER_TOOLS="core" \
  -- npx -y task-master-ai@latest

Rồi nói trong chat: "Initialize taskmaster-ai in my project", "Parse my PRD at .taskmaster/docs/prd.txt", "What's the next task?", "Help me implement task 3".

Không cần API key riêng: Task Master có provider claude-code dùng chính Claude Code CLI đã đăng nhập. Trong .taskmaster/config.json, đặt provider của main/research/fallback là claude-code với model sonnet hoặc opus, hoặc nói "Change the main model to claude-code/sonnet". Tài liệu ghi cần cài thêm gói tuỳ chọn @anthropic-ai/claude-code khi bật provider này. Nếu muốn dùng nhà cung cấp khác (OpenAI, Gemini, Perplexity, OpenRouter…), thêm key tương ứng vào .env hoặc phần env của cấu hình MCP.

Chọn bộ tool để tiết kiệm context

Đây là chi tiết nhiều người bỏ qua. Mặc định Task Master nạp toàn bộ tool, chiếm khá nhiều context chỉ để mô tả tool:

Bộ core gồm get_tasks, next_task, get_task, set_task_status, update_subtask, parse_prd, expand_task, đủ cho vòng làm việc chính.

Dùng bằng CLI

npm install -g task-master-ai
task-master init
task-master parse-prd .taskmaster/docs/prd.txt
task-master list
task-master next
task-master show 1,3,5
task-master research "Best practice JWT cho Node.js hiện nay?"
task-master move --from=5 --from-tag=backlog --to-tag=in-progress

CLI hữu ích khi bạn muốn tự xem và chỉnh danh sách task ngoài phiên agent.

Rủi ro và lưu ý

• License không phải MIT thuần: MIT kèm Commons Clause. Được dùng (kể cả thương mại), sửa, phân phối, xây sản phẩm bằng Task Master; không được bán chính Task Master, cung cấp nó dưới dạng dịch vụ host, hay làm sản phẩm cạnh tranh dựa trên nó.
• Nhịp phát triển chậm lại: vào thời điểm viết, release mới nhất là 0.43.1 (cuối tháng 3/2026) và commit gần nhất cuối tháng 4/2026; tài liệu chính thức đã chuyển sang trang tryhamster.com. Kiểm tra lại hoạt động của repo trước khi chuẩn hoá cho cả team.
• Tốn token ở bước parse/expand: các lệnh này gọi model; với provider API là tiền thật, với provider claude-code thì trừ vào hạn mức gói của bạn.
• Task tự sinh vẫn cần người duyệt: model có thể chia sai phụ thuộc hoặc bỏ sót yêu cầu phi chức năng. Review danh sách sau khi parse, trước khi cho agent chạy.
• Trùng vai với công cụ khác: Claude Code đã có plan mode và todo list nội bộ; Spec Kit cũng có bước tasks. Đừng chồng ba lớp quản lý task lên nhau.

Áp dụng thế nào?

• Dev: Dùng cho dự án mới từ vài ngày công trở lên. Bật chế độ core, dùng provider claude-code để khỏi quản lý key, và luôn bắt đầu phiên bằng "next task".
• Tech Lead: Commit thư mục .taskmaster/ vào repo để cả team thấy tiến độ agent. Quy định review danh sách task sau mỗi lần parse PRD.
• PM: Đây là công cụ biến PRD của bạn thành đầu vào trực tiếp cho agent. Viết PRD rõ phạm vi, tiêu chí chấp nhận và ràng buộc; chất lượng PRD quyết định chất lượng task.