Skip to content

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ữuKhông được
OrchestratorWorkflow, handoff, đóng gói phê duyệtPhê duyệt thay Owner; sửa thầm artifact BA/SA đã phê duyệt
BA DiscoveryGói discovery + handoff prompt (chat riêng, trước SDD)Gọi BA Requirements / Spec Kit / code; thay spec.md
BA Requirementsspec.md, clarify, AC trong pipeline OrchestratorQuyết định kiến trúc / phê duyệt phạm vi; làm thay BA Discovery
SAplan.md, ADR, contractsĐổi kiến trúc đã phê duyệt mà không qua change control
PMtasks.md, sắp thứ tựĐổi ý nghĩa yêu cầu hoặc thiết kế
DevelopersCode/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
QATests, bằng chứng Analyze/ConvergeViế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ệuKhi nào dùng
14-end-to-end-usage-guide.mdLần đầu chạy feature với team
02-spec-kit-integration.md / SOURCES.mdCài Spec Kit và Superpowers
05-human-approval-gates.mdGói Gate và bản ghi phê duyệt; chat Owner = VI một câu mỗi lượt
12-workspace-topology.mdHub vs nested repo
13-documentation-language.mdSoT duy nhất dưới docs/ (VI + thuật ngữ EN); quy tắc chat Gate/QA với Owner

docs/ = SoT duy nhất · văn xuôi tiếng Việt + thuật ngữ chuyên ngành English