Skip to content

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ụcQuy ước
AgentBA Discovery ba-discovery
Skillsdiscovery-idea … discovery-review
Artifacts.minap/discovery/<slug>/ từ .minap/templates/discovery/
Kết thúcGói docs + Handoff prompt for Orchestrator; BA Discovery dừng (không gọi BA Requirements)
ApprovalKhông bắt buộc record dưới work-items/.../approvals/
Tiếp theoOwner 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ạnEngineGhi chú
Constitution → Specify → Clarify → Plan → Tasks → AnalyzeSpec KitArtifact 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 → DeploySpec 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 ​

  1. Spec Kit sinh và Gate duyệt specs/<feature>/{spec,plan,tasks}.md tới Gate 1C.
  2. Orchestrator đóng gói handoff: đường feature, hash commit tasks.md chính xác, path được phép, Definition of Done, lệnh test.
  3. 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).
  4. Nguồn đúng vẫn là tasks.md (và spec/plan đã duyệt). Superpowers không được invent scope ngoài các artifact đó.
  5. Sau khi code vào repo, chạy Spec Kit /speckit-converge và 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ạnSkill (xác minh tên đã cài)Agent sở hữu
Constitution/speckit-constitutionSA đề xuất; Owner phê duyệt
Requirements/speckit-specify / clarifyBA Requirements ba-requirements
Plan/speckit-planSA
Checklist / Tasks/speckit-checklist / tasksBA / PM
Analyze/speckit-analyzeOrchestrator / QA hỗ trợ
ImplementSuperpowers (ưu tiên); /speckit-implement fallbackFrontend / Backend / Infra Developers
Converge/speckit-convergeQA 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ệcTối thiểuGhi chú
Feature mới / trọng yếuFull SDD + gates; Superpowers cho implementMặc định
Docs rủi ro thấpTask nhẹ + reviewCó thể bỏ architecture gate nếu không impact; Superpowers tùy chọn
BugHybrid: 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 hotfixNén + audit; vẫn giữ evidence assess/fix/test nếu kịpBắ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.md trước).
  • Orchestrator phải gọi skill Superpowers theo tên hay lệnh bridge đã tài liệu hóa.

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