1 agent hoạt động tốt. Nhưng khi bạn thêm agent thứ 2, thứ 3, thứ 10 — ai report cho ai? Ai có quyền approve code? Ai bị giới hạn budget? Đây là lúc org chart — sơ đồ tổ chức cho AI team — trở nên quan trọng. Và cũng là lúc Paperclip cho thấy nó khác biệt so với việc chạy AI agents rời rạc trên từng terminal.
Nếu bạn chưa biết Paperclip là gì, hãy đọc bài giới thiệu tổng quan. Nếu bạn đã cài đặt và chạy agent đầu tiên, bài này là bước tiếp theo: từ 1 agent lên team.
1 agent thì dễ — 10 agents thì chaos
Bạn có 1 CEO agent. Bạn giao task, agent làm, xong. Đơn giản.
Rồi bạn thêm 1 Engineer. Engineer code nhanh, nhưng không ai review. Bạn thêm 1 QA. QA test, nhưng test feature nào trước? Bạn thêm 1 CMO. CMO viết bài, nhưng ai duyệt trước khi publish?
Đột nhiên bạn có 5 agents, 15 tasks, và không ai biết ai đang làm gì. Engineer commit code mà CTO chưa đọc. QA test feature cũ vì chưa biết Engineer đã fix. CMO publish bài có thông tin sai vì không ai verify.
Đây chính là vấn đề “mất kiểm soát” mà bài đầu tiên trong series đã mô tả. 1 agent bạn kiểm soát bằng mắt. 10 agents bạn cần hệ thống.
Paperclip giải quyết bằng cách mượn thứ mà mọi công ty đã dùng hàng trăm năm: sơ đồ tổ chức.
Thiết kế hierarchy — “Ai quản lý ai?”
Org chart trong Paperclip không phải metaphor. Nó là cấu trúc dữ liệu thật, enforce ở tầng API.
Cấu trúc cơ bản:
Board (con người)
└── CEO
├── CTO
│ ├── Backend Engineer
│ ├── Frontend Engineer
│ └── DevOps
├── QA
└── CMO
Mỗi agent có một field reportsTo — trỏ đến manager trực tiếp. CEO report cho Board (con người). CTO report cho CEO. Engineer report cho CTO. Đường dây rõ ràng, không mập mờ.
Tại sao hierarchy chứ không phải flat? Vì 10 agents cùng report cho 1 người = bottleneck. CEO không thể review code, test, viết bài, và quản lý budget cùng lúc. Middle management — CTO cho engineering, QA lead cho testing — giảm tải cho CEO. Giống hệt công ty thật, vì bạn đang xây một “công ty AI” thật.
Bạn thiết kế hierarchy khi tạo agent. Chọn reportsTo cho mỗi agent, Paperclip tự xây chain of command từ đó.
Roles — mỗi vai trò có scope riêng
Không phải agent nào cũng nên làm mọi thứ. Trong Paperclip, role định nghĩa scope:
CEO — phân công, theo dõi tiến độ, escalate lên Board. CEO không code. CEO nhìn toàn cảnh: ai đang làm gì, task nào bị stuck, budget còn bao nhiêu.
CTO — code review, architectural decisions, giao task cho Engineers. CTO đọc code, approve code, và can thiệp khi Engineer bị stuck. Có thể code khi cần, nhưng vai trò chính là review và quyết định kỹ thuật.
Engineer — viết code, fix bugs, implement features. Follow instructions từ CTO, commit code, report kết quả. Không có quyền tạo agent mới hay approve code.
QA — test, report bugs, verify fixes. QA không tự fix bugs — report lên CTO, CTO giao lại cho Engineer sửa.
CMO — content marketing, blog, company documents. CMO không access source code, không review pull requests. Scope hoàn toàn tách biệt khỏi engineering.
Mỗi role đi kèm permissions. CEO và CTO có quyền tạo agent mới (canCreateAgents). Engineer thì không — Engineer chỉ code, không hire. QA có quyền tạo test report, nhưng không approve code. Separation of concerns — giống con người, nhưng Paperclip enforce bằng API chứ không bằng “trust.”
Chain of command — khi agent bị stuck, chuyện gì xảy ra?
Đây là lúc org chart phát huy tác dụng thực sự.
Engineer đang code, gặp bug không biết fix. Nếu chạy agent rời rạc — agent sẽ loop, thử đi thử lại, tốn token, rồi timeout. Không ai biết.
Trong Paperclip, flow khác hoàn toàn:
- Engineer bị stuck → comment mô tả blocker → set status
blocked - CTO nhận heartbeat tiếp theo → đọc comment → xử lý (fix hoặc giao lại)
- Nếu CTO cũng bị stuck → escalate lên CEO
- CEO escalate lên Board nếu cần quyết định của con người
Mỗi bước có comment, có audit trail, có timestamp. Task không bao giờ “biến mất” trong hệ thống. Quy tắc bắt buộc: agent phải comment trước khi exit heartbeat — không bao giờ bị stuck im lặng.
Chain of command hoạt động vì mỗi agent biết chính xác ai là manager. Thông tin này nằm trong chainOfCommand — Paperclip cung cấp tự động khi agent xác nhận danh tính qua API. Agent không cần nhớ, không cần đoán.
Budget — mỗi agent có ngân sách riêng
Khi bạn chạy 10 agents, chi phí LLM API tăng nhanh. Không kiểm soát = hóa đơn bất ngờ cuối tháng.
Paperclip giải quyết bằng budget allocation per agent — ngân sách riêng cho từng agent. Ví dụ:
| Agent | Budget/tháng |
|---|---|
| CEO | $40 |
| CTO | $50 |
| Engineer | $40 |
| QA | $30 |
| CMO | $30 |
Khi agent tiêu đến 80% budget → hệ thống cảnh báo CEO. Đến 100% → Paperclip tự động tạm dừng agent. Không phải cảnh báo rồi chờ người can thiệp — tạm dừng thật, agent không chạy heartbeat nữa cho đến khi Board tăng budget hoặc tháng mới bắt đầu.
Dashboard hiển thị chi phí theo agent, theo task, theo khoảng thời gian. Bạn biết chính xác $3.50 đó đi vào task nào, agent nào chạy, lúc mấy giờ.
Governance gates — 3 cổng kiểm soát chất lượng
Code xong chưa phải là “done.” Trong Paperclip, một task phải qua 3 gates trước khi được đóng:
Gate 1 — Implementation (CTO): – Code review: approved – Không có AI markers trong code, comments, commits – Tests pass
Gate 2 — QA: – Test report đã tạo – Pass rate ≥ 90% – Không có critical bugs
Gate 3 — CEO: – QA report đã verify – Chi phí thực tế vs ước lượng đã document – Board đã nhận summary
Ngoài 3 gates, Paperclip còn có approval workflow cho hành động high-impact: hire agent mới, thay đổi kiến trúc, publish content, deliver output cho client — tất cả cần Board approve trước khi thực hiện.
Governance gates không làm chậm hệ thống — chúng chạy tự động qua heartbeat. CTO nhận heartbeat → review code → approve hoặc reject. QA nhận heartbeat → chạy test → report. Mỗi gate mất 1 heartbeat cycle, không cần con người can thiệp trừ khi vấn đề cần Board quyết định.
Đây là cách bạn giữ chất lượng khi scale — không phải kiểm soát từng dòng code, mà đặt checkpoint đúng chỗ.
3 mẫu org chart cho 3 tình huống
Không có org chart “đúng.” Có org chart “phù hợp” với giai đoạn hiện tại.
Mẫu 1 — Bắt đầu (3 agents)
Board
└── CEO
├── Engineer
└── QA
Lean nhất có thể. CEO trực tiếp review code (kiêm CTO). Phù hợp khi bạn mới bắt đầu, task ít, scope nhỏ. Budget tổng: khoảng $110/tháng.
Mẫu 2 — Team đang phát triển (7 agents)
Board
└── CEO
├── CTO
│ ├── Backend Engineer
│ ├── Frontend Engineer
│ └── DevOps
├── QA
└── CMO
Middle management xuất hiện. CTO quản lý engineering, giảm tải cho CEO. CMO handle marketing song song với development. Phù hợp khi product đã stable, cần cả code lẫn content. Budget tổng: khoảng $275/tháng.
Mẫu 3 — Full org (10+ agents)
Board
└── CEO
├── CTO
│ ├── Backend Engineer x2
│ ├── Frontend Engineer
│ └── DevOps
├── QA Lead
│ └── QA Engineer
├── CMO
└── Data/AI Lead
└── Data Engineer
Governance gates đầy đủ. Mỗi lead quản lý sub-team. Approval workflow enforce. Phù hợp cho outsource team hoặc agency chạy nhiều projects song song. Budget tổng: khoảng $400/tháng.
Bắt đầu với Mẫu 1. Scale lên khi workload đòi hỏi. Paperclip không yêu cầu bạn xây org chart 10 agents ngay từ đầu — thêm từng agent, thiết kế lại hierarchy khi cần.
Tiếp theo: giao việc cho AI team
Bạn đã có org chart. Agents biết ai quản lý ai, ai có quyền gì, budget bao nhiêu. Nhưng trong một ngày làm việc, 5 agents cần handle 20 tasks — ai làm task nào trước? Chuyện gì xảy ra khi 2 agents cùng muốn pick 1 task? Trong bài tiếp theo, bạn sẽ hiểu task lifecycle, atomic checkout, và conflict resolution — cách Paperclip đảm bảo không ai làm trùng việc.
