Appearance
Workflow SDD
Version: 1.1
Date: 2026-11-19
Status: Working baseline
Luồng feature
Product Discovery (BA Discovery) — trước Intake
Tùy chọn, chat riêng với agent ba-discovery. Không nằm trong Spec Kit engine.
| Mục | Quy ước |
|---|---|
| Agent | BA Discovery ba-discovery |
| Skills | discovery-idea … discovery-review |
| Artifacts | .minap/discovery/<slug>/ từ .minap/templates/discovery/ |
| Kết thúc | Gói docs + Handoff prompt for Orchestrator; BA Discovery dừng (không gọi BA Requirements) |
| Approval | Không bắt buộc record dưới work-items/.../approvals/ |
| Tiếp theo | Owner mở chat Orchestrator mới, paste prompt → Intake bình thường |
Discovery markdown không thay spec.md. Gate platform vẫn bắt đầu từ Gate 1A.
Tách engine (D-019)
| Giai đoạn | Engine | Ghi chú |
|---|---|---|
| Constitution → Specify → Clarify → Plan → Tasks → Analyze | Spec Kit | Artifact bền: constitution, spec.md, plan.md, tasks.md; cổng clarify/analyze/checklist |
| Implement (sau Gate 1C) | Superpowers (ưu tiên) | Cách xây: TDD, subagent-driven (hoặc executing-plans), review giữa task, đóng worktree/branch |
| Converge → QA Gate 4 → Owner → Gate 5 → Deploy | Spec Kit Converge + Gate MINAP | Đối chiếu code với artifact; evidence QA độc lập; con người phát hành |
Không thay Spec Kit cho SoT yêu cầu/kiến trúc/task. Không dùng design/plan của Superpowers thay spec.md / plan.md / tasks.md đã duyệt.
Hướng dẫn theo góc Human (ví dụ prompt): 14-end-to-end-usage-guide.md.
Handoff Spec Kit → Superpowers
- Spec Kit sinh và Gate duyệt
specs/<feature>/{spec,plan,tasks}.mdtới Gate 1C. - Orchestrator đóng gói handoff: đường feature, hash commit
tasks.mdchính xác, path được phép, Definition of Done, lệnh test. - Developer thực thi bằng skill Superpowers (điển hình: writing-plans chỉ để tinh bước execution từ tasks đã duyệt nếu cần → subagent-driven-development / executing-plans → test-driven-development → requesting-code-review → finishing-a-development-branch).
- Nguồn đúng vẫn là
tasks.md(và spec/plan đã duyệt). Superpowers không được invent scope ngoài các artifact đó. - Sau khi code vào repo, chạy Spec Kit
/speckit-convergevà QA MINAP; khoảng trống được append vào tasks (PM reconcile) — rồi Superpowers lại cho phần còn lại nếu được ủy quyền.
Fallback: /speckit-implement cho slice rủi ro thấp / rất nhỏ khi Superpowers chưa có hoặc quá nặng; ghi engine đã dùng trong work item.
Ánh xạ Spec Kit
| Giai đoạn | Skill (xác minh tên đã cài) | Agent sở hữu |
|---|---|---|
| Constitution | /speckit-constitution | SA đề xuất; Owner phê duyệt |
| Requirements | /speckit-specify / clarify | BA Requirements ba-requirements |
| Plan | /speckit-plan | SA |
| Checklist / Tasks | /speckit-checklist / tasks | BA / PM |
| Analyze | /speckit-analyze | Orchestrator / QA hỗ trợ |
| Implement | Superpowers (ưu tiên); /speckit-implement fallback | Frontend / Backend / Infra Developers |
| Converge | /speckit-converge | QA hoặc Orchestrator gọi; PM reconcile tasks.md |
Bản chất các Gate
- Gate 1A Requirements · Gate 1B Architecture · Gate 1C ủy quyền Implementation
- Gate 4 QA PASS + Owner acceptance · Gate 5 Production release
Superpowers hoàn thành một branch không phải Gate 4 hay Gate 5.
State machine
Chỉ Orchestrator cập nhật state work-item chuẩn sau khi kiểm evidence. Trạng thái chạy Spec Kit hay Superpowers không thay state machine này. Thay đổi trọng yếu làm mất hiệu lực phê duyệt downstream.
Hồ sơ theo loại việc
| Việc | Tối thiểu | Ghi chú |
|---|---|---|
| Feature mới / trọng yếu | Full SDD + gates; Superpowers cho implement | Mặc định |
| Docs rủi ro thấp | Task nhẹ + review | Có thể bỏ architecture gate nếu không impact; Superpowers tùy chọn |
| Bug | Hybrid: Spec Kit /speckit-bug-assess → Owner review → /speckit-bug-fix + Superpowers TDD → /speckit-bug-test + verification-before-completion; work item work_type: bug; artifact <target-repo>/.specify/bugs/<slug>/ | Không Discovery / không full Specify→Plan trừ khi đổi scope/AC/architecture (change control). Prompt: platform-ai/.minap/templates/orchestrator/bug-startup-prompt.md |
| Emergency hotfix | Nén + audit; vẫn giữ evidence assess/fix/test nếu kịp | Bắt buộc retrospective |
Change control
Thay đổi trọng yếu về intent, AC, architecture, contracts, security, data, migration hoặc rollout: dừng → change request → cập nhật artifact → duyệt lại. Không vá code rồi mới vá spec.
Mục mở cho hybrid này
- Pin cách cài/version Superpowers trên Cursor (và bridge với Spec Kit nếu có).
- Mặc định: luôn Superpowers sau 1C, hay rule fallback theo kích thước.
- TDD skill khi repo chưa có test harness (bootstrap task trong
tasks.mdtrước). - Orchestrator phải gọi skill Superpowers theo tên hay lệnh bridge đã tài liệu hóa.