Mô hình lập chiến lược và kế hoạch (v1.6.1)

v1.6.1 thêm mô hình lập kế hoạch 3 tầng vào 4 workflow (/docs, /plan, /open, /end). Trong v1.6.3, hệ thống này được quản lý chặt chẽ bởi kiến trúc Central Gate, trong đó mọi tầng đều phải khai báo qua các field trong project.md thay vì dò quét filesystem.

Mô hình 3 tầng

┌─────────────────────────────────────────────────────────────┐
│ Tầng 1: docs/strategy/         TẠI SAO + CÁI GÌ (opt-in)  │
│         ├── strategy.md         Chiến lược tổng thể         │
│         └── strategy-*.md       Chiến lược nhánh             │
├─────────────────────────────────────────────────────────────┤
│ Tầng 2: plans/*-roadmap.md     LÀM SAO (tổng quan) (opt-in)│
│         Index sống — pha → liên kết đến detail plan          │
│         Không bao giờ archive, không set active_plan         │
├─────────────────────────────────────────────────────────────┤
│ Tầng 3: plans/*.md             LÀM SAO (chi tiết) (luôn có)│
│         Pha cấp task — LÀ active_plan                        │
│         Archive vào plans/done/ khi hoàn thành                │
└─────────────────────────────────────────────────────────────┘

Dùng bao nhiêu tầng tùy nhu cầu:

Quy mô dự án	Tầng 1 (Strategy)	Tầng 2 (Roadmap)	Tầng 3 (Detail)
Nhỏ (1-2 tính năng)	—	—	1 plan
Trung bình (CLI, app)	tùy chọn	✅	nhiều plan
Ecosystem (meta)	✅	✅	mỗi satellite

Luồng đầu-cuối

/brainstorm  ──▶  /docs new     ──▶  /plan create  ──▶  /open & /end
(ý tưởng)         (strategy/)        (roadmap/plan)     (context + sync)

Từng bước

Brainstorm (/brainstorm) — Option D tự động chuyển sang /docs để tạo strategy.
Tạo Strategy (/docs new) — Step 3.5 phát hiện docs/strategy/ hoặc đề xuất tạo.
Tạo Roadmap (/plan create) — Step 2.8 hỏi: Roadmap hay Detail Plan? Chọn 🗺️ Roadmap.
Tạo Detail Plan (/plan create) — Step 2.8 phát hiện roadmap hiện có → đề xuất pha tiếp theo. Step 2.9 load context từ strategy + roadmap.
Dev hàng ngày (/open) — Load tóm tắt strategy (~30 token), tổng quan roadmap (~40 token), brainstorm pending (~20 token). Cảnh báo cascade (D10) nếu strategy mới hơn roadmap.
Kết thúc phiên (/end) — Step 3.2 phát hiện thay đổi strategy/roadmap → tạo mục SYNC. Step 3.3 đề xuất next step cho brainstorm mới. Step 4.5 tự động cập nhật trạng thái pha roadmap.
Plan hoàn thành (/plan review) — Archive detail plan, cập nhật pha roadmap → ✅ Done, đề xuất tạo detail plan cho pha tiếp theo.

Quyết định chính

#	Quyết định	Giải pháp
D7	Ưu tiên Brainstorm vs Strategy	Strategy thắng — bỏ qua brainstorm cũ
D10	Cascade thay đổi Strategy	So sánh ngày → cảnh báo nếu roadmap lỗi thời
D4	Phạm vi `active_plan`	Chỉ detail plan, không bao giờ roadmap
D6	`/brainstorm` Option F “Strategy”?	Không — smart routing qua Option D

Phát hiện Filesystem

Kể từ v1.6.3, hệ thống sử dụng cơ chế đọc field-gated thông qua Central Gate:

Tầng	Field trong `project.md`	Dùng bởi
Strategy	`strategy: "docs/strategy/..."`	`/docs`, `/plan`, `/open`, `/end`
Roadmap	`roadmap: "plans/...-roadmap.md"`	`/plan`, `/open`, `/end`
Detail	`active_plan: "plans/*.md"`	Tất cả (qua `active_plan`)

Quy tắc Roadmap

Đặt tên: [scope]-roadmap.md (ví dụ: ecosystem-roadmap.md)
Không bao giờ set làm active_plan
Không bao giờ archive vào done/
Tự động cập nhật khi detail plan được kích hoạt hoặc hoàn thành

Thêm vào v1.6.1. Xem thêm: Hướng dẫn Meta-Project · Kiến trúc Ecosystem · Planning & Backlog

→ Tìm hiểu: Hướng dẫn Meta-Project → Tìm hiểu: Kiến trúc Ecosystem → Tìm hiểu: Planning & Backlog