Điều phối AI agent từ task đến merged PR

TL;DR

Bài này giới thiệu một hệ thống orchestration cho AI coding agents. Thay vì ngồi theo dõi từng bước, bạn gửi task vào — hệ thống tự provision môi trường, chạy agent, mở PR, monitor CI, tự fix lỗi, và merge khi xong.

Nói đơn giản: Tool quản lý AI agent viết code giúp bạn — từ lúc nhận task đến lúc code lên main, không cần ngồi canh.

Bài này dành cho ai?

1. Team muốn AI agent tự hoàn thành task mà không cần canh

Vấn đề: Agent chạy xong rồi fail CI, dev phải ngồi theo dõi và fix lại thủ công Khi nào cần: Khi muốn nhiều task chạy song song, mà không muốn người ngồi canh từng cái Được gì: Agent tự resume khi CI fail, tự fix theo feedback, tự merge khi pass hết

2. Dev muốn build hệ thống orchestration cho AI coding agents

Vấnề: Không biết bắt đầu từ đâu, thiếu reference architecture Khi nào cần: Khi cần tự build hoặc customize tool quản lý AI agent trong team Được gì: Reference architecture đầy đủ với Kubernetes, queue system, feedback loop

3. Team muốn quản lý nhiều repo cùng lúc

Vấn đề: Mỗi repo cần config riêng, muốn scale không cần setup nhiều Khi nào cần: Khi có trên 5 repo cần chạy task tự động Được gì: Pod-per-repo architecture, mỗi repo có pod riêng, worktree isolation

Các điểm chính

1. Feedback loop là cốt lõi Khi CI fail, agent tự resume với context lỗi. Khi reviewer feedback, agent nhận comment rồi push fix. Không cần người canh. → Nghĩ cách implement feedback mechanism trong workflow của mình, đây là thứ giá trị nhất.

2. Pod-per-repo, worktree isolation Mỗi repo chạy trong Kubernetes pod riêng. Mỗi task tạo git worktree mới — không conflict với nhau. Pod idle thì cleanup tự động. → Nếu mình đang chạy agent trực tiếp trên máy, cách này giúp scale và tránh conflict.

3. Task intake linh hoạt Nhận task từ web UI, GitHub Issues, hoặc Linear tickets. Cấu hình model, prompt, container image riêng cho từng repo. → Không cần chọn 1 tool duy nhất — integrate được với workflow hiện tại.

4. Code review agent là subtask riêng Agent review chạy với prompt và model riêng. Tách biệt khỏi agent viết code — không dùng chung context. → Review agent có thể dùng model rẻ hơn, tiết kiệm chi phí.

5. Real-time dashboard theo dõi toàn bộ Stream log live, xem pipeline progress, cost analytics, cluster health. Mọi thứ trong 1 chỗ. → Không cần SSH vào server để xem agent đang làm gì.

6. Đợi PR status mỗi 30 giây Sau khi agent mở PR, hệ thống poll CI status và review state liên tục. 30 giây là khoảng hợp lý — đủ nhanh mà không spam API. → Nếu mình tự implement, đây là con số benchmark tốt.

Quick Start

1. Clone và chạy setup script — ./scripts/setup-local.sh sẽ cài toàn bộ stack lên Kubernetes local qua Helm
2. Mở web UI — http://localhost:30310, wizard sẽ hướng dẫn config GitHub access và thêm repo đầu tiên