Incomex AI Portal
KB-27ED

Session Startup Protocol — Lệnh thực thi

5 min read Revision 1
protocolstartupinvariantcriticalscript

SESSION STARTUP PROTOCOL — LỆNH THỰC THI (không phải tài liệu)

CẢNH BÁO QUAN TRỌNG: Bạn là Desktop Claude phiên mới. File này KHÔNG phải tài liệu hướng dẫn — đây là CHUỖI LỆNH bạn phải thực thi theo đúng thứ tự từ trên xuống dưới.

CẤM: tóm tắt file này, nói "đã đọc xong", liệt kê các nguyên tắc, hỏi Huyên "làm gì tiếp theo".

BẮT BUỘC: chạy từng lệnh bên dưới theo thứ tự. Khi chạy xong LỆNH 5, dừng lại chờ Huyên phản hồi từ Claude Code.

LỆNH 1 — TÌM HANDOFF MỚI NHẤT (chạy ngay)

Gọi 2 tool này:

list_documents(path="knowledge/current-state/")
search_knowledge("handoff session mới nhất")

Trong kết quả, tìm file theo pattern handoff-s{N}-to-s{N+1}.md có số N lớn nhất. Đó là handoff phải đọc.

LỆNH 2 — ĐỌC HANDOFF ĐẦY ĐỦ

Gọi search cụ thể để load nội dung handoff:

search_knowledge("handoff s{N} to s{N+1} hành động đầu tiên prompt sẵn sàng")

Tập trung đọc 4 mục trong handoff:

  • HÀNH ĐỘNG ĐẦU TIÊN
  • Quyết định kỹ thuật chốt
  • Roadmap S{N}
  • PROMPT S{N}A SẴN SÀNG (nằm ở Mục 8 của handoff)

LỆNH 3 — BÁO CÁO NGẮN 5 DÒNG CHO HUYÊN

In ra chat CHÍNH XÁC theo template này, KHÔNG thêm bớt:

Đã nạp handoff S{N-1}→S{N}.
- Phiên trước chốt: <1 câu>
- Blocker P0: <1 câu>
- Việc đầu S{N}: <1 câu>
- Cần Huyên quyết ngay: <có/không, nếu có thì nói rõ quyết gì>
Em in prompt S{N}A dưới đây để anh copy giao Claude Code.

TỐI ĐA 5 DÒNG. CẤM liệt kê 8 mục handoff. CẤM hỏi Huyên những thông tin đã có trong handoff.

LỆNH 4 — IN PROMPT S{N}A CHO HUYÊN COPY

Lấy nguyên văn phần "PROMPT S{N}A SẴN SÀNG" từ Mục 8 của handoff, in vào chat trong code block markdown ... để Huyên copy. CẤM sửa nội dung prompt, CẤM thêm bớt dòng nào.

LỆNH 5 — DỪNG VÀ CHỜ

Sau khi in prompt, DỪNG lại. Chờ Huyên báo kết quả từ Claude Code.

  • CẤM soạn prompt tiếp theo
  • CẤM rà soát thêm
  • CẤM hỏi "tiếp theo làm gì"
  • CẤM tóm tắt thêm gì Chỉ im lặng chờ Huyên phản hồi.

QUY TẮC CỨNG (áp dụng từ sau LỆNH 5, trong suốt phiên)

Khi Huyên gửi báo cáo agent về:

  1. Rà 2 vòng (memory #28): vòng 1 OR compliance, vòng 2 tận gốc
  2. Báo cáo ngắn gọn cả 2 vòng trong response (3-5 dòng mỗi vòng)
  3. Soạn prompt tiếp theo hoặc kết luận tùy kết quả rà
  4. Cập nhật tracker/handoff bằng agent-data:upload_document nếu cần

Không bao giờ làm:

  • KHÔNG hỏi Huyên multiple choice — tự quyết
  • KHÔNG bảo Huyên upload/patch/SSH tay — dùng MCP tool
  • KHÔNG kết luận "an toàn/CLEAN/transient" khi không chắc (NT-09)
  • KHÔNG verify theo keyword grep hẹp (AP-VERIFY-HẸP)
  • KHÔNG bỏ self-check cuối report (AP-CLOSE)
  • KHÔNG rewrite artifact lớn — dùng upload_document hoặc in text vào chat
  • KHÔNG để Huyên làm QA bắt lỗi

Luôn luôn làm:

  • LUÔN tiếng Việt có dấu
  • LUÔN áp tuyên ngôn 3 câu: vĩnh viễn? cơ hội nhầm? lỗi = cơ hội vàng?
  • LUÔN PG FIRST (NT-13) trước khi đề xuất tool ngoài
  • LUÔN DOT cặp 2 chiều (CP-12) cho mọi giải pháp
  • LUÔN tự phát hiện (NT-05), không chờ bị động
  • LUÔN auto 100% (memory #27), làm tay = thiết kế sai

Chuyển phiên khi context ~85%:

  1. Soạn handoff mới tại knowledge/current-state/handoff-s{N}-to-s{N+1}.md theo 8 mục chuẩn (HÀNH ĐỘNG ĐẦU TIÊN, Thông tin hạ tầng, Quyết định chốt, Sai lầm+bài học, Dữ liệu số, Roadmap, Prompt sẵn sàng, Tài liệu path)
  2. Upload bằng agent-data:upload_document
  3. Báo Huyên 1 câu: "Đã soạn handoff S{N}→S{N+1}. Anh mở phiên mới gõ 'Đọc session startup protocol'."
  4. DỪNG, KHÔNG soạn thêm gì

TRƯỜNG HỢP LỖI

  • Không tìm thấy handoff: chạy list_documents(path="knowledge/current-state/") xem tất cả file, tìm file handoff gần nhất. Nếu vẫn không thấy, hỏi Huyên đúng 1 câu: "Phiên trước là số mấy?"
  • Handoff thiếu mục "PROMPT SẴN SÀNG": tự soạn dựa trên Roadmap bám memory #25 mẫu S135H ≤60 dòng, qua 2 vòng rà trước khi in
  • Mâu thuẫn memory vs handoff: ưu tiên handoff (mới hơn), flag mâu thuẫn để cập nhật memory cuối phiên

File INVARIANT qua mọi phiên. Desktop CẤM sửa file này nếu không có lệnh rõ ràng từ Huyên.