Kỷ luật PARA
Rule này áp dụng nghiêm ngặt kiến trúc PARA cho tổ chức file. Mọi file phải thuộc một Project, Area, hoặc Resource — không cho phép file rời rạc ở gốc workspace.
1. Không File Rời rạc
BẮT BUỘC đặt mọi file vào Project, Area, hoặc Resource. BẮT BUỘC KHÔNG tạo file ở gốc workspace ngoại trừ công cụ CLI hoặc file config được phê duyệt.
2. Ánh xạ Thư mục
| Danh mục | Thư mục Đích |
|---|---|
| Công việc đang làm | Projects/[project-name]/ |
| Tri thức/SOPs ổn định | Areas/ |
| Tham khảo & học tập | Resources/ |
| Hoàn thành/hủy bỏ | Archive/ |
| Input chưa phân loại | _inbox/ |
3. Phạm vi Dự án
- BẮT BUỘC ở trong thư mục dự án active.
- BẮT BUỘC dùng đường dẫn tương đối đầy đủ cho tham chiếu chéo dự án.
- NÊN tạo tài nguyên chia sẻ trong
Resources/thay vì phụ thuộc chéo dự án.
4. Bất biến Tài nguyên
BẮT BUỘC KHÔNG sửa đổi file trong Resources/references/. Resources chỉ dùng để học, scaffolding, và cài đặt.
5. Dự án Được Bảo vệ
BẮT BUỘC KHÔNG sửa đổi Projects/para-workspace/repo/ trừ khi đang phát triển PARA framework.
6. Tuân thủ Kernel
- BẮT BUỘC tuân theo các bất biến kernel (I1–I10).
- BẮT BUỘC dùng
backlog.mdlàm kho task chính tắc qua/backlog. - BẮT BUỘC KHÔNG xóa file mà không có sự đồng ý của người dùng.
7. Ranh giới VCS & Git
- BẮT BUỘC chỉ
git commit/pushtrongrepo/. - BẮT BUỘC KHÔNG commit
sessions/,docs/, hoặcartifacts/trừ khi được track trongrepo/. - BẮT BUỘC KHÔNG chạy git ở gốc workspace trừ khi cập nhật template repository.
Tham khảo
- Rule governance — Các bất biến mà rule này mở rộng
- Rule vcs — Chi tiết ranh giới Git
- Rule naming — Tiêu chuẩn đặt tên file