HHerdr HandbookUbuntu
HERDR HANDBOOK · VI

Multi-Agent với Herdr

Dùng agent name, start/prompt/wait/read để điều phối Codex theo vai trò rõ ràng.

1. Phân vai agent

Architect / Main ├─ Frontend Agent ├─ Backend Agent ├─ Reviewer Agent └─ Tester Agent

Không nhất thiết lúc nào cũng cần 5 agent. Bắt đầu với Implementer + Reviewer là đủ để học.

2. Start agent trong pane có sẵn

# Pane phải đang ở shell prompt rảnh
herdr agent start reviewer --kind codex --pane w1:p2

# Có thể truyền args của agent sau --
herdr agent start reviewer --kind codex --pane w1:p2 -- -m gpt-5.4

agent start không tạo pane. Bạn phải tạo/split pane trước.

3. Gửi prompt

herdr agent prompt reviewer "Review the current git diff"

herdr agent prompt reviewer   "Review the current git diff. Focus on bugs and maintainability."   --wait   --timeout 120000

4. Wait và đọc kết quả

herdr agent wait reviewer --until blocked --timeout 120000
herdr agent read reviewer --source recent-unwrapped --lines 120
herdr agent send-keys reviewer esc

5. Pipeline nên dùng

  1. Implementer sửa feature trong worktree riêng.
  2. Reviewer đọc diff và trả issues.
  3. Implementer fix.
  4. Tester chạy test/linters.
  5. Chỉ merge khi branch sạch và checks pass.

6. Đừng orchestration quá sớm

Chi phí context
Nhiều agent không tự động tốt hơn. Nếu task nhỏ, một Codex + một reviewer thường hiệu quả hơn 5 agents giao tiếp chồng chéo.