Appearance
Lộ trình phát triển MINAP và kickoff Cursor
Version: 1.0
Date: 2026-11-12
Status: Working baseline
1. Thứ tự triển khai khuyến nghị
Mục tiêu: xây lát cắt dọc nhỏ nhất còn hữu ích, đồng thời giữ mô hình nền tảng đã thống nhất. Không triển khai mọi năng lực dùng chung trước khi xác nhận một Application.
| Thứ tự | Workstream | Vì sao làm ngay | Kết quả đầu ra |
|---|---|---|---|
| 0 | Nền tảng repository và governance | Tránh AI và người đi lệch nhau | Git baseline, MINAP AI Agent Team, Spec Kit cài/pin, Superpowers cài/pin cho implement (D-019), approval records |
| 1 | Platform Core — Account + Workspace + Membership | Mọi Application nghiệp vụ phụ thuộc identity và tenancy | Login, Personal/Organization Workspace, invite/join, ủy quyền membership |
| 2 | Hợp đồng tích hợp Application + shell | Chứng minh Application launch được trong MINAP | Đăng ký Application, navigation, ngữ cảnh account/workspace |
| 3 | Application A — lát cắt dọc Salon | Xác nhận giá trị khách hàng sớm | Staff/service/customer/visit/payment-record/history/báo cáo cơ bản |
| 4 | Subscription + entitlement tối thiểu | Kiểm soát truy cập và monetization sau | Check entitlement account/workspace và giới hạn plan |
| 5 | File Service tối thiểu | Cần khi Application upload/đính kèm | Upload/download, authorization, metadata, hook quota |
| 6 | Payment Integration tối thiểu | Thu tự động subscription hoặc Application | Một đường provider đã xác minh, webhook idempotent, đối soát |
| 7 | Invoice Integration | Tách độ phức tạp pháp lý/provider | Một connector đã xác nhận chỉ khi pilot cần |
| 8 | Tích hợp Chat | Năng lực toàn nền tảng, chưa bắt buộc để xác nhận lõi Salon | Map Matrix account, membership room, UI tùy chỉnh và đường đính kèm File Service |
| 9 | Năng lực nền tảng nâng cao | Chỉ thêm khi có bằng chứng | Custom fields, label override, Business Chat, storage riêng, call, analytics |
Thứ tự này là khuyến nghị. Nếu Owner chọn Application đầu khác hoặc nhu cầu khách đã xác nhận đổi ưu tiên, cập nhật lộ trình qua sổ quyết định.
2. Phase 0 — Chuẩn bị repository
- Topology repository đã DECIDED: các git repo độc lập lồng dưới workspace MINAP (xem
docs/framework/12-workspace-topology.md). - Commit trạng thái hub và kiểm tra
.cursor/,.specify/,specs/,.minap/,governance/,docs/framework/,docs/architecture/và stub đường dẫn nested (platform-core/,platform-api/,platform-sdk/,platform-file-service/,platform-infra/,application-a/b/c/). - Dùng framework Version 1.0 dưới
docs/framework/và kiến trúc dướidocs/architecture/. - Cài tích hợp Spec Kit Cursor chính thức theo đường existing-project đã ghi.
- Cài và pin Superpowers cho giai đoạn implement (D-019); không ghi đè skill Spec Kit.
- Pin phiên bản Spec Kit CLI và Superpowers đã thử trong
.minap/config/framework.yaml; không chạy force initialization mù quáng lên repo đang có. - Rà soát skill và hook được sinh trước khi commit.
- Giữ baseline kiến trúc dưới
docs/architecture/; tránh nhiều bản chỉnh sửa song song. - Tạo remote cho nested repo và ghi URL vào
.minap/config/repos.yamltrước khi push triển khai. - Lên kế hoạch Infisical (D-016) cho secrets/ENV trước service deployable đầu: layout project/environment, role truy cập, và đường inject CI/Swarm.
3. Ứng viên feature đầu
Tạo việc Spec Kit theo thứ tự:
platform-account-workspace-foundationplatform-application-integration-contractapplication-a-salon-core-workflow
Mỗi feature phải có:
spec.mdvới user journey, yêu cầu và AC đo được;plan.mdvới kiến trúc, data model, bảo mật và hợp đồng API;tasks.mdvới phụ thuộc và truy vết yêu cầu;- test và bằng chứng QA;
- approval records trong
.minap/work-items/<id>/.
4. Human Approval Gates
Giữ governance của Agent Framework:
- Gate 1A: Duyệt yêu cầu.
- Gate 1B: Duyệt kiến trúc.
- Gate 1C: Ủy quyền triển khai.
- Gate 4: QA độc lập PASS.
- Owner acceptance.
- Gate 5: Duyệt release production.
Không Developer nào bắt đầu implement feature trước Gate 1C. QA PASS không tự động ủy quyền deploy production.
5. Prompt kickoff Cursor
Dùng làm chỉ thị Orchestrator đầu tiên sau khi mở repository MINAP:
You are the Central Orchestrator for this platform. Read the Version 1.0 AI Agent Team Framework (
docs/framework/), the Platform Constitution (governance/), and the architecture baseline (docs/architecture/) before proposing implementation.First perform a repository and documentation audit. Do not modify application code. Identify existing repositories, directory structure,
.cursor/agents/,.cursor/rules/,.cursor/skills/,.specify/,specs/,.minap/,governance/,docs/framework/,docs/architecture/and nested checkout pathsplatform-core/,platform-api/,platform-sdk/,platform-file-service/,platform-infra/,application-a/b/c/. Report conflicts, missing files, duplicate sources of truth and current tool versions.Treat DECIDED items in
02-master-index-and-decisions.mdas constraints. Do not silently promote PROPOSED or OPEN items to decisions. Preserve the one-MINAP-Account identity model, Personal + Organization Workspace model, Application A/B/C terminology, Platform Core/Application boundaries, dual ingress (Flow 1 Nginx→Swarm default; Flow 2 Nginx→Traefik→Swarm for important end-user UX), Blue-Green on Flow 2, Infisical for secrets/ENV (D-016), prefixed NanoID business IDs (D-017), and Platform API credentials for SDK/API calls (app_…+ token, D-018).Use the seven existing specialist roles. GitHub Spec Kit is the SDD artifact engine (constitution through tasks + converge), not the Orchestrator. After Gate 1C prefer Superpowers to execute approved tasks.md (D-019); do not replace Spec Kit SoT or MINAP gates. Use official installed skills and inspect their actual names. Do not create duplicate skills or overwrite existing Cursor configuration.
Deliver an audit report and a proposed Phase 0/Phase 1 implementation plan. Stop for Owner approval before changing files or implementing code.
6. Điều kiện sẵn sàng triển khai (Definition of ready)
Một feature sẵn sàng chỉ khi:
- yêu cầu và non-goals rõ;
- AC kiểm thử được;
- Application và hợp đồng bị ảnh hưởng đã xác định;
- sở hữu dữ liệu và ủy quyền workspace đã định nghĩa;
- hệ quả bảo mật/quyền riêng tư đã rà;
- nhu cầu migration, rollback và observability đã cân nhắc;
- phê duyệt Gate 1A, 1B và 1C đã ghi nhận.
7. Không bắt đầu bằng
- Xây mọi Application cùng lúc.
- Triển khai mọi payment provider.
- Xây hệ kế toán đầy đủ.
- Tạo cụm storage riêng cho mọi khách trước khi có yêu cầu thật.
- Xây Business Chat trước khi General Chat được xác nhận.
- Triển khai engine custom-field generic trước khi một Application chứng minh điểm mở rộng.
- Tự động hóa mọi workflow Agent trước khi pilot Spec Kit thủ công chạy ổn.