Workflow /end đóng phiên làm việc bằng cách tóm tắt kết quả và ghi nhận vào đúng vị trí PARA.
Lưu ý:
/endKHÔNG thực hiện bất kỳ thao tác Git nào (commit, push, tag). Dùng/pushcho việc đó.
Tổng quan Lệnh
/end [tên-project] # Đóng phiên cho project cụ thể
/end all # Đóng phiên cho tất cả project đã thay đổi
/end workspace # Đóng phiên cho công việc cấp workspace
/end [tên-project] done # Đóng + dọn dẹp plan đã hoàn thành
Luồng Đóng Phiên
Pre-flight → Phân loại → Ghi nhận → Sync queue → Phát hiện Strategy/Roadmap
→ Brainstorm follow-up → Hot Lane Sync → Tiến độ Plan → Roadmap sync → Master index
0. Rules Pre-flight (v1.5.4)
Agent đọc lại .agent/rules.md từ đĩa để khôi phục ngữ cảnh rule — Defense-in-Depth Layer 3.
1. Phân loại & Xác định Thay đổi
Xác định công việc thuộc Project hay Workspace/Learning.
2. Ghi nhận Session
Tạo hoặc append vào session log. Các phần bắt buộc: Đã làm, TODO pending, Downstream Impact.
3. Hàng đợi Đồng bộ Liên dự án
Nếu project.md khai báo downstream, thêm dòng vào Areas/Workspace/SYNC.md.
Phân giải @prefix (v1.6.0+): Hỗ trợ @{ecosystem}/ prefix. Bỏ qua đề xuất git cho type: ecosystem.
3.2. Phát hiện Thay đổi Strategy/Roadmap (v1.6.3)
Sử dụng cơ chế field-gated qua field strategy và roadmap trong project.md để phát hiện thay đổi chính xác thay vì dò quét glob:
- Nếu strategy document hiện tại thay đổi → tạo mục SYNC cho downstream
- Nếu roadmap document hiện tại thay đổi → ghi nhận cập nhật roadmap
3.3. Brainstorm Follow-up (v1.6.1)
Nếu brainstorm được tạo/cập nhật trong phiên → đề xuất next step: tiếp tục brainstorm, formalize thành plan, hoặc publish thành docs.
3.5. Hot Lane Sync (v1.5.3)
Bước A: Xử lý quick tasks từ sprint-current.md — [x] → done.md, [ ] → giữ hoặc promote.
Bước B: Smart Suggest Strategic Tasks — trích xuất task IDs từ session log, đối chiếu với backlog.
4. Kiểm tra Tiến độ Plan Phase
Chỉ chạy nếu project.md có active_plan. Đếm ✅ Done items theo phase.
4.5. Đồng bộ Trạng thái Roadmap (v1.6.3)
Thay vì dò quét plans/*-roadmap.md, agent kiểm tra field roadmap trong project.md. Nếu tồn tại, tự động cập nhật trạng thái phase roadmap khi detail plan hoàn thành.
5. Cập nhật Master Index
Thêm tóm tắt vào Areas/Workspace/SESSION_LOG.md.
/end KHÔNG Làm
| Không làm | Dùng thay thế |
|---|---|
| Commit code | /push |
| Push to remote | /push |
| Chạy build/test | /push --test |
| Tạo release | /release |
Cập nhật v1.6.3. Giám sát thay đổi Strategy/Roadmap qua cơ chế field-gated.
→ Workflow /open — Mở phiên với context loading → Tìm hiểu: Strategy → Plan Flow