Tâm niệm: Mọi đoạn mã đều là một Project. Kiến thức sống trong Areas. Các công cụ nằm ở Resources.
📂 Kiến trúc Không gian (Workspace Structure)
workspace/
├── _inbox/ # 📥 Nơi tập kết thông tin thô, ghi chú nhanh
├── Projects/ # ⚡ Các dự án đang phát triển (có thời hạn)
│ └── my-app/ # Tên dự án: kebab-case, bắt buộc có project.md
│ ├── project.md # Hợp đồng dự án (mục tiêu, thời hạn, DoD)
│ ├── repo/ # Mã nguồn dự án (Thư mục gốc của Git)
│ ├── sessions/ # Nhật ký làm việc & task log
│ ├── docs/ # Tài liệu nội bộ dự án
│ └── artifacts/ # Các tệp sinh ra bởi AI (kế hoạch, bản vẽ...)
│ ├── plans/ # 📝 Kế hoạch triển khai
│ └── tasks/
│ ├── backlog.md # 📌 Danh sách công việc CHÍNH (CANONICAL)
│ ├── sprint-current.md
│ └── done.md
├── Areas/
│ ├── infra/ # 🔧 SOPs hạ tầng, runbooks, cấu hình server
│ ├── product/ # 📦 Thông số sản phẩm, quyết định thiết kế
│ └── ops/ # ⚙️ Vận hành, CI/CD, kịch bản triển khai
├── Resources/
│ ├── ai-agents/ # 🤖 Kernel mặc định, luồng chạy AI Agent
│ │ ├── kernel/
│ │ └── workflows/
│ ├── references/ # 📚 Source code tham khảo, docs, cheat-sheets
│ └── tools/ # 🛠️ Scripts, utilities, công cụ CLI độc lập
├── Archive/ # ❄️ Nơi lưu trữ dự án & khu vực đã đóng
├── .agent/ # Môi trường chạy Agent (cài đặt tự động)
│ ├── rules/
│ └── workflows/
├── .para-workspace.yml # File cấu hình trung tâm của không gian
├── para # CLI lõi (Tạo tự động)
└── README.md📑 Các Luồng Công việc (Workflows) Đề xuất
| Quy trình làm việc | Khi nào nên sử dụng? |
|---|---|
/plan | Lập hoặc đánh giá kế hoạch triển khai kiến trúc |
/open | Bắt đầu phiên làm việc, tải toàn bộ Context |
/backlog | Thêm hoặc đánh giá ưu tiên công việc cho dự án |
/docs | Tạo, kiểm tra, và xuất bản tài liệu kỹ thuật |
/new-project | Khởi tạo cấu trúc tự động cho một dự án code mới |
/learn | Lưu trữ lại các bài học và kinh nghiệm vào Areas |
/push | Tự động Commit & Đẩy mã nguồn lên nền tảng đám mây |
/verify | Kiểm tra độ hoàn thiện tính năng bằng kịch bản test |
/release | Rà soát chất lượng (Quality gate) trước khi phát hành |
/retro | Chạy đánh giá dự án (Retrospective) trước khi dọn kho |
/end | Kết thúc phiên làm việc, tự động dọn rác và ghi nhật ký |
/para | Kiểm tra sức khỏe hệ thống và bảo trì tổng thể |
📜 Các Tiêu chuẩn Quản trị (Rules)
Sau khi chạy para init, các quy tắc bắt buộc sau đây sẽ được nạp tự động vào thư mục .agent/rules/:
governance.md— Chứa các bất biến cốt lõi (Invariants) và phương pháp luận Heuristics của hệ thống.
💡 Lời khuyên cho hồ sơ dev
- Sử dụng cú pháp kebab-case:
my-app,auth-service,api-gateway - Mỗi dự án chỉ có 1 kho lưu trữ Git (Repo): Thư mục
repo/chính là “gốc” (root) của Git. _inbox/là khu vực thu thập thông tin: Cứ ném mọi đoạn mã nháp, link, ghi chú lộn xộn vào đây — chúng sẽ tự được xử lý bằng lệnh/endvào cuối ngày.- Thư mục Areas chứa tài liệu Sống (SOPs): Các tài liệu như
Areas/infra/là cấu hình vận hành nên phải được cập nhật thường xuyên. - Resources chỉ để tra cứu: Thông tin ở khối này chỉ đọc (read-only), đừng tạo code dự án bên trong nhánh
Resources/.