Skip to content

Đặ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.md

Khô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. Xem 12-workspace-topology.md.
  • Mỗi nested repo có .specify/ và specs/ riêng — không share feature.json.
  • Work item / handoff / discovery fill không để lâu trong platform-ai trừ khi việc thuộc về chính kit.
  • Folder .cursor/.claude rỗ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.

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