Appearance
Platform AI Agent Team Framework — Tổng quan
Version: 1.1
Date: 2026-11-19
Status: Working baseline
Mục đích
Framework này kết hợp AI Agent Team với GitHub Spec Kit SDD và Superpowers cho kỷ luật implement: ai làm việc gì, theo thứ tự nào, với quyền và phê duyệt nào. Spec Kit sở hữu artifact “làm gì” tới tasks.md; Superpowers là engine “làm thế nào” ưu tiên sau Gate 1C (Implementation authorization); nền tảng giữ governance, gates và ownership.
Kiến trúc
Thẩm quyền: Project Owner quyết định. Orchestrator điều phối. Các chuyên gia tạo deliverable trong phạm vi. Spec Kit dẫn dắt artifact SDD. Superpowers dẫn dắt thực thi implement. Git/CI bảo toàn truy vết.
Cuộc hội thoại Cursor Agent chính là Orchestrator. .cursor/agents/*.md định nghĩa các subagent chuyên môn. Không tạo Orchestrator subagent để điều khiển parent của nó.
Vai trò (tóm tắt)
| Vai trò | Sở hữu | Không được |
|---|---|---|
| Orchestrator | Workflow, handoff, đóng gói phê duyệt | Phê duyệt thay Owner; sửa thầm artifact BA/SA đã phê duyệt |
| BA Discovery | Gói discovery + handoff prompt (chat riêng, trước SDD) | Gọi BA Requirements / Spec Kit / code; thay spec.md |
| BA Requirements | spec.md, clarify, AC trong pipeline Orchestrator | Quyết định kiến trúc / phê duyệt phạm vi; làm thay BA Discovery |
| SA | plan.md, ADR, contracts | Đổi kiến trúc đã phê duyệt mà không qua change control |
| PM | tasks.md, sắp thứ tự | Đổi ý nghĩa yêu cầu hoặc thiết kế |
| Developers | Code/tests được giao qua Superpowers (ưu tiên) theo tasks.md đã duyệt | Đổi yêu cầu/kiến trúc đã phê duyệt; invent scope ngoài tasks |
| QA | Tests, bằng chứng Analyze/Converge | Viết lại yêu cầu để code “pass” |
BA Discovery và BA Requirements cùng họ BA — không thêm role thứ 8 ngoài bảy chuyên gia + Orchestrator. Chi tiết: 03-agent-responsibility-matrix.md.
Vòng đời
(Tùy chọn) BA Discovery → Owner paste handoff → Intake → Specify → Clarify? → Gate 1A (Requirements approval) → Plan → Gate 1B (Architecture approval) → Tasks → Analyze → Gate 1C (Implementation authorization) → Implement (Superpowers) → Review → Test → Converge → Gate 4 (QA verification) → Owner acceptance → Gate 5 (Production release approval) → Deploy.
Một Spec Kit hoặc Superpowers skill hoàn thành không phải là phê duyệt. Chi tiết: 04-sdd-workflow.md, 05-human-approval-gates.md. Quy tắc hybrid: D-019 (Decision 019 — Superpowers ưu tiên sau Gate 1C). Chú giải mã Gate/Decision: 14-end-to-end-usage-guide.md §1.1.
Cách chạy một yêu cầu đầu–cuối (prompt Human + thứ tự agent): 14-end-to-end-usage-guide.md.
Nguyên tắc governance
Quyền tối thiểu (least privilege), handoff tường minh, QA độc lập, song song có kiểm soát, Git là nguồn chân lý, thẩm quyền con người với quyết định trọng yếu. Thay đổi trọng yếu làm mất hiệu lực các Gate liên quan.
Ngoài phạm vi (Non-goals)
- Không thêm vai trò Agent ngoài bảy chuyên gia + Orchestrator (BA Discovery là mode của BA, không phải role mới).
- Không fork Spec Kit; Superpowers không thay artifact Spec Kit hay Gate của con người.
- Không tự động deploy production; không bắt buộc monorepo.
- Không phải mọi thay đổi nhỏ đều cần full SDD (xem work-type profiles trong
04-sdd-workflow.md).
Đọc thêm
| Tài liệu | Khi nào dùng |
|---|---|
14-end-to-end-usage-guide.md | Lần đầu chạy feature với team |
02-spec-kit-integration.md / SOURCES.md | Cài Spec Kit và Superpowers |
05-human-approval-gates.md | Gói Gate và bản ghi phê duyệt; chat Owner = VI một câu mỗi lượt |
12-workspace-topology.md | Hub vs nested repo |
13-documentation-language.md | SoT duy nhất dưới docs/ (VI + thuật ngữ EN); quy tắc chat Gate/QA với Owner |