Appearance
Đặc tả cấu trúc thư mục
Version: 1.2
Date: 2026-11-20
Status: Working baseline
text
MINAP/ # local multi-root workspace
├── platform-ai/ # SHARED AI kit
│ ├── .cursor/agents|rules|skills
│ └── .minap/templates|schemas|config
├── platform-docs/ # SoT docs (VitePress; VI + thuật ngữ EN)
│ ├── framework/
│ ├── architecture/
│ └── …
├── platform-ui/ # example nested product/platform repo
│ ├── .specify/ # Spec Kit state for THIS repo
│ ├── specs/<feature>/ # spec.md / plan.md / tasks.md
│ ├── .minap/work-items/ # approvals, handoffs, evidence
│ ├── .minap/discovery/<slug>/ # optional BA Discovery fills
│ ├── .minap/config/framework.yaml
│ ├── docs/
│ └── …
├── platform-core/ …
└── …Chi tiết path: 12-workspace-topology.md.
Baseline tooling (ESLint/Prettier/Node/Docker) để nhân bản sang repo khác: 15-repo-tooling-baseline.md.
Repository đích (ví dụ: platform-ui/)
text
platform-ui/ # separate git remote
├── .specify/ # Spec Kit — repo này
├── specs/ # Feature SoT Gate
├── .minap/
│ ├── work-items/
│ ├── discovery/ # optional
│ ├── config/framework.yaml # repo pin + pointer tới platform-ai
│ └── schemas/ # optional sync từ platform-ai
├── docs/
├── packages/ / src/ …
└── README.mdKhông bắt buộc .cursor/ đầy đủ trên mỗi nested repo khi workspace đã gồm platform-ai.
Quy tắc đặt chỗ
- Mô hình workspace: multi-root;
platform-ai= kit dùng chung; artifact feature = repo đích. Xem12-workspace-topology.md. - Mỗi nested repo có
.specify/vàspecs/riêng — không sharefeature.json. - Work item / handoff / discovery fill không để lâu trong
platform-aitrừ khi việc thuộc về chính kit. - Folder
.cursor/.clauderỗng do IDE multi-root tạo ra — xóa/gitignore; không coi là SoT. - SoT tài liệu người đọc:
platform-docs(VitePress). Agent kit:platform-ai.