arrow_back Trở về Quy tắc
rules Rule

Hybrid 3-File Integrity

Quản trị hệ thống quản lý task 3 file — backlog.md, sprint-current.md (Hot Lane), và done.md — với 6 ràng buộc (C1–C6) đảm bảo workflow task an toàn.

Hybrid 3-File Integrity

Rule này quản trị hệ thống quản lý task 3 file: backlog.md (nguồn sự thật duy nhất), sprint-current.md (Hot Lane buffer), và done.md (kho lưu trữ append-only). 6 ràng buộc (C1–C6) đảm bảo agent không vô tình phá vỡ workflow task.

C1: sprint-current.md — Hot Lane

Hành độngQuyền hạn
Thêm task nhanh (- [ ] mô tả)✅ Được phép
Thêm - [ ] TRƯỚC KHI bắt đầu code✅ Bắt buộc (log-first)
Đánh dấu [x] khi hoàn thành✅ Được phép
Thêm ghi chú vào ## Notes✅ Được phép
Copy task chiến lược từ backlog❌ Cấm
Sửa mô tả/ưu tiên của task đã có❌ Cấm

C2: done.md — CHỈ THÊM VÀO

Bản ghi mới chỉ được thêm qua /end (Hot Lane Sync) hoặc /backlog clean. Các bản ghi được nhóm theo plan với tag nguồn: #backlog (chiến lược) hoặc #session (hot lane).

Các bản ghi đã có TUYỆT ĐỐI KHÔNG được sửa hoặc xóa.

C3: backlog.md — QUYỀN VẬN HÀNH

Nguồn sự thật duy nhất cho tất cả task. Mọi thay đổi cấu trúc (thêm, xóa, sắp xếp ưu tiên) BẮT BUỘC đi qua /backlog.

Chuỗi tra cứu: backlog.md → done.md → plans/done/

C4: Đồng bộ Plan-Backlog

BẮT BUỘC sau /plan create. Agent BẮT BUỘC đề xuất /backlog sync để ánh xạ phase của plan tới backlog items. Thiếu bước này, /plan review không thể đo tiến độ theo phase.

C5: /end — ĐIỂM Đồng Bộ DUY NHẤT

Mọi hòa giải task diễn ra tại /end — KHÔNG phải khi đang code. Quy trình đồng bộ:

  1. Hot Lane Sync: item [x] → append vào done.md
  2. Item [ ] → hỏi người dùng xử lý
  3. Gợi ý thông minh từ session log
  4. Dọn dẹp sprint-current.md

C6: File Guard Headers

Các file task NÊN bao gồm comment guard nội tuyến. Agent BẮT BUỘC đọc và tuân thủ trước khi sửa:

<!-- ⚠️ CHỈ THÊM VÀO: Ghi qua /end hoặc /backlog clean (C2) -->
<!-- ⚠️ CHỈ HOT LANE: Không copy task chiến lược từ backlog (C1) -->

Guards đóng vai trò tuyến phòng thủ cuối cùng khi agent mất rule context sau truncation. Đây là Lớp 4 của kiến trúc Defense-in-Depth.

Tham khảo

→ Trở về Rules Catalog