Tham chiếu lệnh

Mọi verb đều chạy qua engine cơ học: bash <skill-dir>/runner/flow.sh <command>. Trong Claude Code, Cursor và Antigravity, bạn gõ /flow …; trong Codex CLI, bạn gõ $flow …. Trên Windows PowerShell, gọi <skill-dir>\runner\flow.cmd <command> chứ không gọi bash.

Lệnh hằng ngày

/flow              status — đang ở đâu, cái gì chặn
/flow next         kiểm gate + mở stage kế
/flow assess       đánh giá brownfield
/flow card         tạo build card
/flow check C-001  kiểm tra card (hoàn thành = bằng chứng thế giới thật)
/flow auto         build tự động (HALT nhóm bảo mật)
/flow doctor       kiểm môi trường

State và vào lại

Lệnh	Làm gì
`/flow resume`	Bản tóm tắt câu chuyện session, chỉ đọc, để vào lại dự án đang dở: session trước (chỉ liệt kê tên lệnh, không bao giờ gồm raw args), card đang chạy (in flight) kèm dwell, trạng thái gate, một dòng `NEXT ->`. Không chiếm lock. Chạy lệnh này ĐẦU TIÊN khi tiếp tục một dự án lạnh.
`/flow` (status)	Bạn đang ở đâu, cái gì đang chặn, một dòng `NEXT ->` từ cùng helper với `resume`, dwell của stage hiện tại, danh sách card (rút gọn khi quá mười card), và một dòng tóm tắt bộ nhớ.
`/flow recall`	Đọc lại bộ nhớ bền vững — debt mở, retro gần đây, scope card trước, friction/backlog của harness, sức khỏe audit, playbook — khi bắt đầu stage hoặc card.
`/flow unlock`	Xóa khóa concurrency của dự án này sau khi session crash hoặc bị bỏ dở.
`/flow doctor`	Tự kiểm tra môi trường trên macOS, Linux, Windows: bash, python, grep, git, đường dẫn cài đặt.

Stage và planning

Lệnh	Làm gì
`/flow next`	Kiểm tra gate của stage hiện tại; nếu pass thì mở stage kế tiếp (hoặc bắt đầu ở stage 00). Phần thách thức ngữ nghĩa của stage vừa pass được áp dụng sau khi đã pass cơ học.
`/flow gate <stage> [--json]`	Quét cơ học read-only một stage (hoặc `--card C-NNN` cho card): báo findings mà không mở gì thêm. `next`/`check` mới là bên quyết định mở tiếp. `--json` xuất envelope `gate.report` đóng.
`/flow assess`	Brownfield: tạo khung (scaffold) và đặt gate cho bản đánh giá hiện trạng trong `flow/00-inspect.md` trước khi lên plan. Cần người duyệt.
`/flow skip <stage> --reason`	Vượt gate khi có dòng debt mở tương ứng. Không áp dụng cho nhóm security-class; stage 05 không bao giờ skip được.
`/flow clarify`	Liệt kê các bullet `- [ ]` còn sót dưới `## Open decisions` trên Scope, PRD và Contract. Chỉ mang tính khuyến nghị — không phải gate của `next`.
`/flow constitution`	Kiểm tra các bất biến do operator tự viết cho từng dự án trong `flow/constitution.md`. Chỉ mang tính khuyến nghị — không phải gate của `next`.
`/flow converge`	Các remainder card ở chế độ chỉ-append, đối soát code hiện tại với plan. Transactional — hoặc tất cả card, hoặc không card nào; không bao giờ sửa card đã có; in `CONVERGED` và không ghi gì khi không có gap.

Card và building

Lệnh	Làm gì
`/flow card`	Tạo build card kế tiếp, chỉ sau khi mọi gate planning đã pass.
`/flow card start\|done C-NNN`	Đánh dấu card đang chạy (in flight), hoặc thực hiện lần flip sang `done` do CLI sở hữu, với cùng luật như `check` — revert nếu fail. Dùng song song được với sửa tay.
`/flow check C-NNN`	Kiểm tra một card: `[FILL]`, status, section bắt buộc, bằng chứng hoàn thành.
`/flow ready`	Liệt kê các card todo có thể build, kèm gợi ý chạy song song an toàn.
`/flow auto`	Preflight cho lần chạy tự động; `auto stop` để tắt. Tier-A tự merge, Tier-B được một subagent mới sửa một lần, Tier-C (nhóm security-class) thì HALT.
`/flow attest semantic\|live-verify\|status\|recover`	Tạo (mint) hoặc xem bằng chứng gắn fingerprint, dùng bởi control plane attested-execution.
`/flow workspace add\|list\|enter\|remove\|check\|doctor\|port`	Cô lập nhiều agent bằng worktree: mỗi agent một `git worktree`, để nhiều agent chạy song song mà không có lần đổi nhánh nào làm lật mọi terminal. `workspace port` cấp phát port tất định cho từng card.
`/flow loop-prep <card>`	Hạ tầng (plumbing) để lặp lại theo một mục tiêu số: worktree cô lập cộng lệnh verify dạng số, suy ra từ allowed files của card.
`/flow loop-log <card> --iterations N --start M --end K --outcome …`	Ghi một lần loop đã xong vào usage telemetry.

Mode và cấu hình

Lệnh	Làm gì
`/flow mode [teach\|work]`	Xem hoặc đặt ai là người viết artifact tại gate. Mặc định là `teach`.
`/flow project-type [web\|cli\|library\|skill]`	Xem hoặc đặt loại dự án — quyết định luật bằng chứng hoàn thành và seam của contract. Mặc định là `web`.
`/flow debt add\|list`	Ghi hoặc liệt kê các lần bỏ qua gate có chủ đích trong `DEBT.md`. Mục thuộc nhóm security-class chỉ operator được ghi.
`/flow rules [cursor\|windsurf\|roo\|cline\|aider\|openhands\|copilot\|list] [--write]`	Xuất (hoặc ghi) khung rule cho workspace để harness bên thứ ba tuân thủ kỷ luật của flow. Khuyến nghị, không bắt buộc.

Kiểm drift

/flow contract, /flow tokens, /flow coherence và /flow consistency — mỗi lệnh gắn cờ một trục drift và không bao giờ tự sửa. Cùng nhau, chúng tạo thành một lattice kiểm tra: version, URL, design token, và xem các artifact còn truy vết được tới nhau hay không.

Lệnh	Trục	Nó báo gì
`/flow coherence`	version	Lệch version giữa các trường version đã khai báo; lát cắt doc-versus-code giá rẻ
`/flow contract`	URL	Lệch giữa base-URL của client và prefix path của server; các lớp double-`/api` và mixed-prefix mà tool diff schema bỏ sót (web)
`/flow tokens`	design	So token khai báo trong `DESIGN.md` với CSS thực tế đang dùng: token chưa dùng tới, lệch giá trị, biến orphan
`/flow consistency`	truy vết	Mỗi `FRn` trong PRD được một card nhận (claim) và một interface contract phục vụ; success metric phải có số, không còn placeholder

Chạy consistency và coherence sau gate contract, trước khi tạo card. Chạy contract và tokens khi build các bề mặt mà chúng mô tả.

/flow design <file> là kiểm tra cơ học tương tự nhưng chỉ trên một file UI, không quét cả dự án.

Mô tả chi tiết và thời điểm chạy: README_VN.md

Lớp bền vững và tri thức

Lệnh	Làm gì
`/flow harness <args>`	Passthrough xuống CLI lớp bền vững: intake, story, trace, decision, backlog, query, audit, propose, cùng init, tool, intervention, promote-suggest, rollup, usage, prune, graph, journal.
`/flow promote <file>`	Copy playbook vào KB liên dự án tại `~/.claude/flow/playbooks`.
`/flow usage [--global\|--prune]`	Tổng hợp usage-log JSONL cục bộ thành analytics build: cycle time, tỷ lệ fail gate, dwell theo stage và theo card, phân bố lệnh. Chỉ lưu cục bộ.
`/flow retro`	In ba câu hỏi retro. Operator viết dòng, không bao giờ agent.

Lệnh phụ harness

/flow harness <args> là passthrough xuống lớp bền vững, CLI Python và SQLite do flow sở hữu, lưu thứ sống sót giữa các session.

Subcommand	Mục đích
`intake`	Ghi yêu cầu vào kèm type, tóm tắt và cờ; cờ rủi ro như auth sẽ tự nâng lane
`story`	Theo dõi một đơn vị công việc và bằng chứng của nó. Hoàn tất bằng `story complete --proof-source …`
`trace`	Bản ghi được chấm tier, ghi khi check card pass
`decision`	Ghi một quyết định, rồi đóng vòng lặp sau với kết quả thực tế
`backlog`	Backlog cải tiến mà `propose` ghi vào
`query`	Đọc lại các bản ghi
`audit`	Chấm điểm entropy và drift trong các bản ghi tích lũy
`propose`	Đào friction và các can thiệp lặp lại thành mục backlog; chỉ kích hoạt khi pattern xuất hiện từ hai lần trở lên
`init`	Tạo hoặc nâng cấp database của harness
`tool`	Registry tool và capability đầu vào, phân loại theo kind
`intervention`	Ghi lại lần override của người, reviewer, CI, hoặc agent
`promote-suggest`	Soạn gợi ý playbook từ friction và intervention lặp lại
`rollup`	Nạp JSONL usage sink vào kho usage (idempotent)
`usage`	In analytics sử dụng từ kho usage
`prune`	Cắt mỗi JSONL sink còn N dòng cuối (an toàn khi crash)
`graph`	Graph executor: ghi và đẩy journal entry

Hầu hết engine tự ghi hộ bạn: tiến một stage thì seed một intake, check pass thì ghi một trace — nên phần bạn phải làm tay chủ yếu là đọc. Lớp này không bắt buộc: thiếu python3 thì gate vẫn chạy, chỉ store này tắt.

Schema, flag và bảng quyền hạn (live): skills/flow/harness/README.md

Evaluation

Lệnh	Làm gì
`/flow eval [--stage 01\|02\|05\|card\|routing\|converge] [--fixture <id>] [--n 3] [--timeout <s>]`	Bằng chứng hành vi cho gate ngữ nghĩa: model có thật sự gắn cờ các fixture rỗng nhưng sạch về mặt cơ học không? Opt-in và tính phí; bỏ qua trong lặng lẽ (không gọi gì) nếu thiếu CLI `claude`.
`/flow eval --report`	Chạy offline, không gọi model: scorecard của batch hoàn chỉnh gần nhất, kèm drift so với batch trước.
`/flow eval --replay`	Chạy lại fixture đã lưu, không gọi model. Fixture thiếu hoặc cũ thì exit 1. Verdict không tính vào eval floor.
`/flow eval --diff <old> <new>`	Phân loại regression fixture offline: so sánh hai batch với baseline.