Hướng dẫn Meta-Project & Ecosystem (v1.6.0)

Meta-Project là dự án điều phối quản lý chiến lược, roadmap, và plan liên dự án cho một nhóm dự án liên quan (ecosystem). Meta-Project không có source code — chỉ chứa tài liệu và plan.

Tình huống	Giải pháp
Sản phẩm đơn, một repo	Dự án chuẩn (`type: standard`)
Sản phẩm đơn, nhiều repo	Meta-Project (`type: ecosystem`)
Các sản phẩm không liên quan	Không cần — mỗi dự án độc lập

Tạo Ecosystem

Dùng `/new-project --meta`

/new-project my-ecosystem --meta

Tạo scaffold dự án ecosystem (không có thư mục repo/):

Projects/my-ecosystem/
├── project.md            ← type: ecosystem, satellites: []
├── artifacts/
│   ├── tasks/backlog.md  ← Backlog cấp ecosystem
│   └── plans/            ← Plan liên dự án
├── docs/                 ← Tài liệu chiến lược, kiến trúc
└── sessions/             ← Nhật ký phiên

Thiết lập thủ công

# Projects/my-ecosystem/project.md
---
goal: "Điều phối ecosystem sản phẩm"
status: "active"
type: "ecosystem"
satellites:
  - my-app
  - my-lib
  - my-docs
---

Liên kết Satellite

Mỗi satellite project khai báo ecosystem cha:

# Projects/my-app/project.md
---
ecosystem: "my-ecosystem"
---

/para-audit xác thực tính nhất quán hai chiều — cả hai bên phải tham chiếu lẫn nhau.

Plan liên dự án

Tạo plan chung

Đặt plan trong thư mục artifacts/plans/ của ecosystem:

Projects/my-ecosystem/artifacts/plans/
└── feature-rollout.md

Tham chiếu từ satellite

Dùng prefix @{ecosystem}/ trong active_plan:

# Projects/my-app/project.md
active_plan: "@my-ecosystem/plans/feature-rollout.md"

Phân giải: @my-ecosystem/plans/feature-rollout.md → Projects/my-ecosystem/artifacts/plans/feature-rollout.md

Quy tắc:

@{name}/ phân giải thành Projects/{name}/artifacts/
Chỉ đọc — satellite không thể sửa file trong ecosystem
Workflow xác thực file tham chiếu tồn tại

Khác biệt Workflow

Bước	Dự án Chuẩn	Dự án Ecosystem
Git status	✅ Chạy	⏭️ Bỏ qua (không có repo/)
Git log	✅ Chạy	⏭️ Bỏ qua
Danh sách satellite	❌ N/A	✅ Hiển thị
Backlog	✅ Đọc	✅ Đọc (cấp ecosystem)
Active plan	✅ Đọc	✅ Đọc

Tham chiếu Schema

Trường	Kiểu	Mặc định	Mô tả
`type`	`"standard"` \| `"ecosystem"`	`"standard"`	Loại dự án
`ecosystem`	`string` \| `null`	`null`	Ecosystem cha (cho satellite)
`satellites`	`string[]` \| `null`	`null`	Danh sách ID satellite
`active_plan`	`string`	`""`	Hỗ trợ `@{ecosystem}/path`

Tất cả trường đều tùy chọn — các dự án hiện tại hoạt động bình thường.

Câu hỏi thường gặp

Ecosystem project có Git repo không? Không. Ecosystem project không có repo/ — chỉ chứa tài liệu chiến lược, plan, và backlog. Source code nằm trong satellite.

Satellite có thể thuộc nhiều ecosystem không? Hiện tại không. Trường ecosystem chỉ nhận một giá trị.

Tôi cần ecosystem cho một dự án đơn lẻ không? Không. Ecosystem chỉ hữu ích khi bạn có ≥2 dự án liên quan cần điều phối.

Thêm vào v1.6.0. Xem thêm: Kiến trúc Ecosystem · Kiến trúc Kernel

→ Tìm hiểu: Kiến trúc Ecosystem → Tìm hiểu: Strategy → Plan Flow → Tìm hiểu: Planning & Backlog