Kiến trúc Ecosystem (v1.6.0)

PARA Workspace v1.6.0 giới thiệu Ecosystem Projects — meta-project điều phối nhiều satellite project mà không sở hữu source code. Cho phép quản lý đa dự án trong cấu trúc PARA chuẩn.

Mô hình Ecosystem

┌───────────────────────────────────────────────────────┐
│                       Projects/                       │
│                                                       │
│  ┌────────────────────────────┐                       │
│  │     my-ecosystem/          │  ECOSYSTEM            │
│  │  ├─ project.md             │  type: ecosystem      │
│  │  ├─ artifacts/plans/  ─────┼── Shared plans        │
│  │  └─ docs/strategy.md       │  No repo/             │
│  └─────────────┬──────────────┘                       │
│                │                                      │
│                │  @my-ecosystem/ prefix               │
│                │  (cross-project plan resolution)     │
│                │                                      │
│      ┌─────────┼─────────┬──────────┐                 │
│      ▼         ▼         ▼          ▼                 │
│  ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐              │
│  │ app-a │ │ app-b │ │ lib-c │ │ lib-d │ SATELLITES   │
│  │ repo/ │ │ repo/ │ │ repo/ │ │ repo/ │              │
│  └───────┘ └───────┘ └───────┘ └───────┘              │
│                                                       │
│  ┌────────────────────────────┐                       │
│  │     standalone-project/    │  STANDARD             │
│  │  └─ repo/                  │  type: standard       │
│  └────────────────────────────┘                       │
└───────────────────────────────────────────────────────┘

Ecosystem project (type: ecosystem) không có thư mục repo/ — chỉ chứa tài liệu chiến lược, plan, và backlog. Source code nằm trong các satellite project riêng lẻ.

Schema

Các trường tùy chọn mới trong project.md frontmatter (v1.6.0+):

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ợ cú pháp `@{eco}/path`

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

Phân giải @Prefix

Satellite tham chiếu plan chung từ ecosystem project:

# my-app/project.md
active_plan: "@my-ecosystem/plans/shared-roadmap.md"

Phân giải: @{name}/path → Projects/{name}/artifacts/path

Chỉ đọc: satellite không thể sửa file trong ecosystem
Được xác thực: workflow kiểm tra file tham chiếu có tồn tại

Workflow thích ứng

Workflow	Phiên bản	Hành vi với Ecosystem
`/open`	1.3.0	Bỏ qua git, liệt kê satellite, phân giải @
`/end`	1.4.0	Bỏ qua đề xuất git, phân giải @
`/plan`	1.3.0	Kích hoạt plan liên dự án qua @prefix
`/new-project`	1.1.0	Tùy chọn `--meta` để tạo ecosystem trực tiếp
`/para-audit`	1.2.0	Xác thực tính nhất quán hai chiều

Kiểm tra tính nhất quán

/para-audit xác thực sức khỏe ecosystem:

Kiểm tra	Mô tả	Mức độ
Tham chiếu hai chiều	Ecosystem ↔ satellite phải tham chiếu lẫn nhau	⚠️ Cảnh báo
File @prefix tồn tại	File plan tham chiếu phải tồn tại tại đường dẫn	🔴 Lỗi
Ecosystem không có `repo/`	Meta-project không nên chứa source code	⚠️ Cảnh báo

Quản trị

Các quy ước ecosystem được quản lý bởi Heuristic H7 (Cross-Project References) trong kernel. Đây là hướng dẫn cấp SHOULD, dự kiến nâng cấp lên invariant khi đạt v2.0.0 sau khi ổn định.

Thêm vào v1.6.0. Xem thêm: Hướng dẫn Meta-Project · Kiến trúc Kernel

→ Tìm hiểu: Hướng dẫn Meta-Project → Tìm hiểu: Strategy → Plan Flow → Tìm hiểu: Kiến trúc Kernel