Dựng team AI agent trên Herdr: Builder, Reviewer, Tester làm việc chuẩn chỉ

Dựng team AI agent trên Herdr nghĩa là chia một dự án cho nhiều agent, mỗi agent một vai: Builder viết code, Reviewer soi lỗi, Tester chạy kiểm thử. Bạn đóng vai trưởng nhóm: giao việc, theo dõi trạng thái trên sidebar của Herdr và duyệt kết quả trước khi gộp code. Làm đúng thì chất lượng tăng rõ rệt; làm sai thì chỉ tốn thêm hạn mức và rối thêm.

Bài này là phần tiếp theo của Herdr là gì?, viết để trả lời câu hỏi nhiều người để lại dưới video hướng dẫn Herdr của kênh Holetex: «làm sao setup một team AI làm việc chuẩn chỉ?». Nếu bạn chưa cài Herdr, đọc bài kia trước.

Vì sao không để một agent làm hết?

Câu hỏi hay gặp: «sao không làm xong rồi review luôn trong một terminal?». Làm được, nhưng có ba vấn đề:

• Tự chấm bài của mình. Agent vừa viết code mang theo toàn bộ lý lẽ nó đã dùng để viết. Khi tự review, nó có xu hướng đồng ý với chính mình. Một agent khác với ngữ cảnh trắng chỉ thấy code và yêu cầu, nên dễ thấy chỗ sai hơn.
• Ngữ cảnh bị đầy. Phiên làm việc dài thì cửa sổ ngữ cảnh chứa đủ thứ: lỗi cũ, lệnh thử, log. Review trong phiên đó vừa chậm vừa dễ bị nhiễu.
• Khác model, khác điểm mù. Cho Claude Code viết và Codex review (hoặc ngược lại) giúp bắt được những lỗi mà một model hay bỏ sót.

Herdr không làm agent thông minh hơn. Nó chỉ làm cho việc chạy nhiều agent cùng lúc trở nên dễ quản lý: thấy ngay agent nào đang chờ bạn, và cho agent đọc kết quả của nhau.

Đội hình đề xuất: 3 vai + 1 người

Quy tắc quan trọng nhất là reviewer chỉ nhận xét, không sửa. Nếu cả hai cùng sửa, bạn sẽ không biết dòng nào do ai viết và vòng review mất ý nghĩa.

Bước 1: Bố cục Herdr cho một dự án

Mỗi repo một workspace. Trong workspace, tạo ba tab theo công việc:

• agents — chia ba pane: builder (trái, rộng nhất), reviewer và tester (phải).
• server — chạy ứng dụng ở chế độ dev.
• logs — theo dõi log ứng dụng hoặc kết quả test.

Bố cục một workspace với ba agent — Ảnh: Holetex.

Thao tác bằng chuột (chuột phải → Split Right / Split Down → Rename) hoặc phím tắt: bấm Ctrl+B rồi v để chia dọc, - để chia ngang. Đặt tên pane theo vai trò để danh sách agent dễ đọc. Herdr cũng có lệnh đặt tên cho agent:

herdr agent rename w1:p1 builder
herdr agent rename w1:p2 reviewer

w1:p1 là mã pane (workspace 1, pane 1). Cú pháp lấy theo tài liệu herdr.dev ở thời điểm viết; Herdr còn ở bản 0.x nên hãy kiểm tra lại bằng herdr --help nếu lệnh báo lỗi.

Bước 2: Viết «luật chơi» chung cho cả team

Agent không nhớ cuộc trò chuyện của nhau. Thứ duy nhất chúng chia sẻ là file trong repo. Vì vậy trước khi giao việc, chuẩn bị:

1. File hướng dẫn dự án (CLAUDE.md cho Claude Code, AGENTS.md cho Codex): lệnh chạy dev, test, typecheck; quy ước đặt tên; thư mục nào không được đụng.
2. File spec cho từng việc, ví dụ docs/spec/xuat-hoa-don.md: mục tiêu, màn hình, dữ liệu, điều kiện nghiệm thu. Reviewer sẽ so code với file này, nên spec càng cụ thể thì review càng có giá trị.
3. Định nghĩa «xong»: typecheck sạch, test liên quan chạy qua, reviewer không còn lỗi mức nghiêm trọng.

Với doanh nghiệp vừa và nhỏ, phần đáng đầu tư nhất không phải là có nhiều agent, mà là viết spec rõ. Một spec nửa trang mô tả đúng nghiệp vụ (ai duyệt phiếu, số tiền làm tròn thế nào) tiết kiệm nhiều vòng sửa hơn bất kỳ cách bố trí agent nào.

Bước 3: Cho các agent phối hợp

Cách nhàn: Herdr Skill + câu lệnh tự nhiên

Cài Herdr Skill (tìm «herdr» trên skills.sh, chạy lệnh cài ở một tab terminal thường), nạp lại skill trong phiên của builder. Sau đó giao việc bằng lời:

Làm tính năng theo docs/spec/xuat-hoa-don.md. Xong thì dùng Herdr gọi agent reviewer review diff so với spec. Sửa theo nhận xét, tối đa 3 lượt, cho tới khi reviewer kết luận OK. Sau đó gọi pane tester chạy typecheck và test, báo tôi kết quả. Không commit.

Ba chi tiết trong câu lệnh trên đều có lý do: «tối đa 3 lượt» chặn vòng lặp vô tận khi hai agent bất đồng; «so với spec» để reviewer có thước đo; «không commit» giữ quyền quyết định cuối cho bạn.

Cách tự chủ: lệnh CLI của Herdr

Khi cần kịch bản cố định (hoặc skill làm chưa đúng ý), dùng thẳng các lệnh mà Herdr cung cấp cho việc điều phối:

# chờ reviewer làm xong
herdr agent wait w1:p2 --until done

# đọc 150 dòng output gần nhất của reviewer
herdr pane read w1:p2 --source recent-unwrapped --lines 150

# gửi một dòng chữ sang pane khác
herdr pane send_text w1:p3 "chạy npm run typecheck và npm test"

Trong Claude Code, gõ dấu ! trước lệnh để chạy nó như lệnh shell; kết quả được đưa thẳng vào ngữ cảnh của builder.

Bước 4: Chạy nhiều builder song song mà không giẫm chân nhau

Hai builder cùng sửa một thư mục sớm muộn sẽ ghi đè file của nhau. Cách an toàn là mỗi builder một git worktree — một bản sao thư mục làm việc trên nhánh riêng, dùng chung lịch sử git:

git worktree add ../app-hoa-don -b tinh-nang/hoa-don
git worktree add ../app-bao-cao -b tinh-nang/bao-cao

Mỗi worktree mở thành một workspace (hoặc một tab) riêng trong Herdr. Builder làm xong trên nhánh của mình, reviewer review nhánh đó, bạn gộp từng nhánh sau khi duyệt. Nên bắt đầu với 2–3 builder; nhiều hơn thì thời gian bạn đọc và duyệt sẽ thành nút thắt, và hạn mức gói Claude/ChatGPT cạn rất nhanh.

Bước 5: Đưa team lên VPS để chạy liên tục

Việc dài (refactor lớn, viết test cho cả module) nên chạy trên VPS để laptop ngủ không làm gián đoạn. Cài Herdr trên VPS, rồi từ máy cá nhân:

herdr machine add ten-vps --label "VPS"

Workspace trên VPS sẽ nằm chung sidebar với workspace local. Herdr dùng SSH sẵn có của bạn và không lưu mật khẩu hay khoá riêng. Trước khi để agent chạy một mình trên server, đọc thêm phần an toàn ở cuối bài.

Năm lỗi hay gặp khi dựng team AI

1. Không có spec — reviewer không có thước đo, chỉ góp ý chung chung về «code sạch».
2. Reviewer được quyền sửa — hai agent cùng sửa, vòng review thành vòng cãi nhau.
3. Không giới hạn số lượt — builder và reviewer có thể đẩy qua lại rất lâu vì một chi tiết nhỏ.
4. Bỏ qua chấm đỏ blocked — agent đứng chờ cấp quyền cả tiếng trong khi bạn tưởng nó đang làm.
5. Để agent tự gộp vào nhánh chính — mọi lớp review mất tác dụng nếu bước cuối không có người.

Lưu ý an toàn khi nhiều agent cùng chạy

Càng nhiều agent, càng nhiều lệnh chạy mà bạn không nhìn từng dòng. Tối thiểu nên: bật sandbox cho lệnh shell của Claude Code (lệnh /sandbox), không để file .env chứa khoá production trong thư mục agent làm việc, không cho agent kết nối cơ sở dữ liệu thật khi đang thử nghiệm, và chạy agent trên VPS bằng user riêng thay vì root.

Checklist dựng team

• Mỗi repo một workspace; tab agents / server / logs.
• Pane đặt tên theo vai: builder, reviewer, tester.
• Có CLAUDE.md / AGENTS.md và file spec cho từng việc.
• Reviewer chỉ nhận xét; tối đa 3 lượt review.
• Mỗi builder một git worktree, một nhánh.
• Người thật duyệt và gộp ở bước cuối.

Muốn tự làm web app cho công việc của mình bằng Claude Code một cách bài bản, tham khảo các khoá học tại 5F Edu. Doanh nghiệp cần một hệ thống làm sẵn theo quy trình riêng có thể gửi yêu cầu tư vấn báo giá.