Chọn workflow

zenify-kit có ba workflow: /znf:cook, /znf:fix và /znf:hotfix. Với thay đổi nhỏ đã rõ yêu cầu, bạn không cần workflow nào, chỉ cần làm trong worktree rồi chạy /znf:ship.

Tiêu chí chọn là mức độ bạn đã hiểu về công việc, không phải kích cỡ thay đổi.

Bảng chọn

Tình huống	Dùng
Chưa có thiết kế, hoặc chưa rõ cần làm gì	/znf:cook
Có lỗi, chưa biết nguyên nhân	/znf:fix
Lỗi đang xảy ra trên production	/znf:hotfix. /znf:fix tự chuyển sang đây khi có bằng chứng production, và bạn vẫn gõ trực tiếp được
Đã rõ yêu cầu và cách làm, trong một repo, không chạm tài nguyên chung	Không dùng workflow. Mở worktree, sửa, verify, chạy /znf:ship

Luồng chọn workflow

Tài nguyên chung là thứ nhiều service cùng dùng: collection trong DB, endpoint giữa các service, queue, channel pub/sub. Khi thay đổi chạm vào một trong số này, bạn chạy contract gate của project và đi theo workflow thay vì làm trực tiếp.

Khi nào dùng hotfix

/znf:cook và /znf:fix phân biệt theo mức hiểu về công việc. /znf:hotfix phân biệt theo nơi code sẽ được merge.

Bạn không cần tự chọn giữa fix và hotfix khi chưa chắc: /znf:fix tự chuyển sang /znf:hotfix khi có bằng chứng production, và bạn vẫn gõ /znf:hotfix trực tiếp được. Hotfix tạo branch từ base hotfix mà repo khai trong worktree.json (ví dụ origin/main), không từ nhánh tích hợp hằng ngày. Phần chẩn đoán dùng lại các bước của /znf:fix. Xem chi tiết ở hotfix.

Bước cuối: ship

Mọi đường đều kết thúc bằng /znf:ship.

• /znf:cook gọi ship ở bước cuối.
• /znf:fix và /znf:hotfix gọi ship sau khi verify.
• Khi không dùng workflow, bạn tự chạy /znf:ship sau khi sửa xong.

Kit không có tùy chọn bỏ bớt bước. Nếu thay đổi đủ nhỏ để không cần /znf:cook, hãy chọn đường không dùng workflow ngay từ đầu.

Skill dùng độc lập

Ba workflow trên tự gọi các skill sau khi cần. Bạn cũng có thể gọi trực tiếp.

Skill	Chức năng	Dùng trực tiếp khi
/znf:ground	Đối chiếu tên, field, shape với nguồn thật	Sắp dùng một field DB, API hoặc symbol chưa kiểm trong phiên này
/znf:scout	Liệt kê nơi phụ thuộc vào code sắp sửa	Sắp sửa code hoặc data shape đã có nơi khác dùng
/znf:gate	Quét cross-repo cho một tài nguyên chung, chỉ đọc	Vừa sửa collection, endpoint, queue hoặc channel chung
/znf:top-issues	Khảo sát Grafana, xếp top 5 issue hệ thống kèm đánh giá impact/rủi ro và phương án. Xem top-issues	Muốn biết hệ thống đang có vấn đề gì nặng nhất trước khi chọn bug để fix
/znf:run	Chạy app trong worktree hiện tại, trả về URL	Cần quan sát hành vi thật của app
/znf:qa	Run QA của zenie viết kịch bản nghiệm thu đóng băng trước khi có code dev, journey phải đỏ trên code gốc, rồi gắn journey vào code xong mà không sửa expect. Xem qa	Không gọi tay; zenie chạy khi ZENIE_QA=on. Journey tự viết trong /znf:cook dùng /znf:e2e
/znf:ci-watch	Theo dõi CI của commit vừa push ở chế độ nền, đánh thức phiên khi xong; fail thì giao run lỗi cho /znf:fix và theo dõi commit mới (dừng sau 2 vòng). Khi CI xanh và PR đã mở, skill chờ PR CLEAN rồi in URL PR kèm lệnh ! gh pr merge -R <owner/repo> <n> --merge cho bạn chạy; skill không tự merge. Xem ci-watch	Vừa push, muốn Claude tự biết CI xanh hay đỏ
/znf:sweep	Dọn dev server, worktree và branch đã merge	Công việc đã merge, cần dọn workspace
/znf:where	Tóm tắt task tới đâu: đã xong (kèm bằng chứng), đang làm, bước tiếp với lệnh kit, đọc ledger, branch, worktree, PR	Quay lại sau khi nghỉ hoặc sau khi phiên bị nén
/znf:track <verb> <mã>	Quản lý Plan và Backlog của pane track bằng mã ngắn: add, drop, ls, plan, go, done, cancel, est; help in bảng verb	Thêm, bỏ, lập plan hoặc bắt đầu, đóng một việc trong ledger track; xem Pane track
/znf:retro	Rút bài học tốn kém của phiên về đúng một nơi (check, rule, CLAUDE.md, memory), bạn duyệt trước khi ghi	Cuối phiên vừa có chỗ phải làm lại hoặc bị sửa
/znf:research	Research có kiểm chứng: worker fetch nguồn, verifier fetch lại từng URL, báo cáo ghi vào docs/reference/	Thiết kế phụ thuộc thư viện, API ngoài hoặc cách người khác làm; brainstorming tự gọi khi checklist sáu mục bật. Xem Research có kiểm chứng
agent spec-reviewer	Soát spec bằng context mới trước khi bạn duyệt, chỉ báo thiếu sót và mâu thuẫn	Brainstorming tự dispatch ở tier architectural, không gọi tay. Xem spec-reviewer

Muốn xem thời gian agent, thời gian chờ, token và chất lượng ship của các lượt cook, fix, hotfix: bật zenify feature track on (hoặc dòng Dev track trong /config của Claude Code) và xem Pane track. Các thiết lập của kit (feature, cách mở pane track, reviewer) là các dòng của plugin znf trong /config; xem Settings trong /config.