pk-reflect

name

pk-reflect

description

Rút bài học từ cả phiên làm việc (quét toàn bộ hội thoại). Light (mặc định): quét nhanh phiên, trích bài học. Deep: phỏng vấn AAR 5 câu chuyên sâu. Dùng khi user nói 'rút bài học', 'retro', 'tổng kết phiên', 'rút kinh nghiệm', 'AAR', hoặc vừa kết thúc một giai đoạn và muốn nhìn lại. Output đi vào inbox qua pk-capture. KHÔNG dùng khi chỉ ghi 1 mẩu rời (dùng pk-capture) hoặc đúc kết inbox đã tích (dùng pk-distill).

PK Reflect: Rút bài học

Ensure snapshot (bắt buộc, đầu flow)

1. Precondition: .cockpit/ tồn tại. Thiếu → route pk-init (mode new), KHÔNG nạp gì thêm, dừng.
2. Idempotent qua marker: phiên CHƯA có marker SNAPSHOT_LOADED → tự nạp full theo Snapshot Contract (../pk-shared/references/snapshot-contract.md) rồi đặt marker SNAPSHOT_LOADED. Đã có marker (vd harness Phase 1 đã đặt) → skip, không đọc lại.

2 mode: light (mặc định, rút nhanh từ phiên) và deep (phỏng vấn AAR 5 câu). Output → inbox.

Modes

Mode	Trigger	Mô tả
light	Mặc định, "rút bài học", "retro"	Quét phiên, trích candidates, bàn giao pk-capture
deep	"AAR", "phỏng vấn sâu", user chỉ định rõ	Phỏng vấn 5 câu + gọi pk-analyze lấy data

Nguyên tắc

• Reflect KHÔNG ghi file trực tiếp vào knowledge/skills/workflows. Mọi output đi qua pk-capture → inbox.
• Light rút nhanh. Deep phải chỉ định rõ.
• Bàn giao cho pk-capture (cross-call lớp 2 → lớp 3) để giữ bất biến "một cửa inbox".

Flow: mode light (session extraction)