Context Rules — Định tuyến & Tải Context
Rule này quy định cách agent tải và ưu tiên context trong workspace. Nó định nghĩa thứ tự tải, ranh giới cách ly dự án, vòng đời beads, và cơ chế Two-Tier Progressive Disclosure cho rules.
1. Thứ tự Ưu tiên Tải Context
BẮT BUỘC tải context theo chuỗi sau (ưu tiên cao nhất trước):
- Hợp đồng Dự án —
Projects/<project>/project.md - Rules Dự án —
Projects/<project>/.agent/rules/ - Rules Workspace —
.agent/rules/ - Artifacts —
Projects/<project>/artifacts/ - Bộ nhớ Hoạt động —
Projects/<project>/.beads/ - Tri thức Trừu tượng —
Areas/ - Tham khảo —
Resources/
2. Cách ly & Liên quan
- BẮT BUỘC tìm kiếm trong thư mục dự án active trước.
- BẮT BUỘC KHÔNG đọc từ
Archive/trừ khi người dùng yêu cầu dữ liệu lịch sử. - BẮT BUỘC KHÔNG quét dự án khác trừ khi làm việc tích hợp.
- NÊN ưu tiên
.beads/hơn docs chung cho các vấn đề lặp lại.
3. Vòng đời Beads
Beads lưu trữ quyết định, thất bại, và đặc thù riêng dự án tại Projects/<project>/.beads/. Được phép lộn xộn và chưa hoàn chỉnh trong quá trình phát triển.
BẮT BUỘC thực hiện “Graduation Review” trước khi archive — chuyển kiến thức có giá trị sang Areas/, Resources/, hoặc .agent/rules/.
4. Tải Rules — Two-Tier Progressive Disclosure
Tầng 1 (LUÔN LUÔN): Đọc .agent/rules.md (~20 dòng, ~200 tokens). Ghi nhớ bảng trigger, tải file rule theo nhu cầu.
Tầng 2 (CÓ ĐIỀU KIỆN): Kiểm tra Projects/<project>/.agent/rules.md. Nếu có, đọc index và tải rules khi trigger khớp. Nếu không có, bỏ qua.
Định dạng Index chuẩn
| Rule | Trigger | File | Pri |
| :-------- | :--------------------- | :---------- | :-- |
| Tên Rule | Khi nào tải rule này | filename.md | 🔴 |Định dạng File Guards
Mở rộng tùy chọn của agent-behavior.md §4:
## File Guards
| Pattern file | BẮT BUỘC đọc lại | Lý do |
| :------------- | :---------------- | :-------------------- |
| `path/to/file` | rule-name.md | Tại sao cần guard này |Tham khảo
- Rule Layers & Trigger Index — Tổng quan kiến trúc
- Defense-in-Depth — 4 lớp bảo vệ
- Rule agent-behavior — Giao thức Phục hồi Context