Kiến trúc Central Gate (v1.6.3)

Được giới thiệu trong v1.6.3, Central Gate là sự chuyển dịch mô hình kiến trúc then chốt, biến project.md thành nguồn chân lý duy nhất (single source of truth) cho mọi thao tác tải ngữ cảnh của workflow, chính thức chấm dứt kỷ nguyên dò quét cây tệp vô tội vạ (filesystem globbing).

🔒 Vấn đề của Dò quét Filesystem

Ở v1.6.1, agent tìm kiếm tài liệu Strategy và Roadmap bằng cách dò cây thư mục (quét docs/strategy/ hoặc plans/*-roadmap.md). Khi workspace mở rộng, cách tiếp cận này lộ ra 3 tử huyệt:

Không thể dự đoán: Quét tệp dễ dẫn tới việc bốc sai tệp rác, gây nổ token limit.
Kiến trúc Dễ vỡ: Đổi tên một file có thể phá vỡ toàn bộ chain đọc context trừ khi workflow nhét đầy regex phức tạp.
Ghost Loading: Các tính năng tự động kích hoạt ngầm dẫn tới các side-effect ma quái ngoài kiểm soát của dev.

🗝️ Mô hình Central Gate

Central Gate giải quyết bài toán trên bằng cơ chế field-gated (chốt cổng bằng tham số). Các workflow không còn được phép tự tiện soi mói thư mục hệ thống.

Thay vào đó, tất cả luồng load context buộc phải đi qua “Cổng Trung tâm”: project.md.

Nếu một tính năng (như Strategy hay Roadmap) muốn hoạt động, nó bắt buộc phải được khai báo rõ ràng thông qua một field trong hợp đồng dự án.

Ưu điểm

Mục đích Hiện hình: Agent chỉ load những gì user cung cấp một cách công khai.
Tốc độ Tối đa: O(1) đọc file trực tiếp đè bẹp O(N) tìm kiếm đệ quy.
Khả năng Bắt cầu Liên dự án: Bằng cách khai báo tường minh, các dự án có thể chia sẻ context cho nhau không giới hạn.

🌐 Quy Ước Path Resolution

Nhờ Central Gate, mọi workflow hiện nay đều tuân thủ Path Resolution Convention thống nhất dành cho các contextual fields (strategy, roadmap, active_plan).

Phân giải Tiêu chuẩn

Nếu không có tiền tố, hệ thống phân giải đường dẫn cục bộ tính từ gốc dự án hiện thời:

# project.md
strategy: "docs/strategy/frontend-strategy.md"

Kết quả: Projects/[current-project]/docs/strategy/frontend-strategy.md

Phân giải Ecosystem (Tiền tố `@`)

Dành cho mô hình Meta-Project, Central Gate giới thiệu tiền tố @ để phân giải an toàn xuyên ranh giới dự án:

# project.md (trong 1 dự án satellite vệ tinh)
strategy: "@my-ecosystem/docs/strategy/master-strategy.md"

Kết quả: Projects/my-ecosystem/docs/strategy/master-strategy.md

Cơ chế này giúp một đội quân dự án vệ tinh có thể chia sẻ chung một bộ não Strategy / Roadmap khổng lồ ở dự án mẹ mà không hề phung phí thêm 1 token nào cho sự dư thừa.

🛡️ Triển khai trong Workflow

/open: Step 2 và 5.5 áp dụng load field-gated cho Strategy và Roadmap. Xóa bỏ hoàn toàn mã mỏ filesystem.
/plan: Load context, lựa chọn Plan Type, và cơ chế Auto-update đều vận hành xoay quanh các field trong project.md.
/docs: Tự động chích đường dẫn vào field strategy trong project.md ngay khi người dùng khởi tạo xong tài liệu chiến lược.
/end: Dùng chính xác file được khai báo để check checksum, thay vì quét đệ quy dẫn đến lỗi gửi SYNC.md rác.

Thêm vào v1.6.3.

→ Tìm hiểu: Kiến trúc Ecosystem → Tìm hiểu: Mô hình Strategy → Plan Flow → Tìm hiểu: Unified Agent Index