Every command, gate stage, gating artifact, and environment variable on one page — scannable, no prose to wade through. Need the why behind a row? Each links to its full guide. Need to pick a skill? Use the command finder.Mọi lệnh, stage gate, artifact gác cổng, và biến môi trường trên một trang — liếc là thấy, không phải lội qua prose. Cần biết tại sao một dòng tồn tại? Mỗi dòng dẫn tới guide đầy đủ. Cần chọn skill? Dùng bộ chọn lệnh.

Pipeline at a glanceQuy trình một liếc

One enforced spine. Each step leaves an artifact the next step — or the gate — reads.Một xương sống bị ép. Mỗi bước để lại artifact mà bước sau — hoặc gate — đọc.

StepBước	CommandLệnh	Leaves behindĐể lại
PlanLập kế hoạch	/hs:plan	plan.md + phase files → plan-approval.yaml
CookNấu	/hs:cook	verification.json (per phase)(mỗi phase)
TestKiểm thử	/hs:test	verification.json verdict: PASS
ReviewReview	/hs:code-review	review-decision.json verdict: PASS
ShipShip	/hs:ship	push / PR — gate checks all artifactspush / PR — gate kiểm mọi artifact

All commandsToàn bộ lệnh

A quick-reference to the most-used hs:* skills, grouped by what you're trying to do. Invoke any with /hs:<name>. All 68 with full descriptions live in the catalog.Bảng tra nhanh các skill hs:* hay dùng nhất, nhóm theo điều bạn đang muốn làm. Gọi bất kỳ với /hs:<tên>. Toàn bộ 68 kèm mô tả đầy đủ nằm trong catalog.

/hs:plan	Verified plan — research, red-team, validate before any code.Plan có kiểm chứng — research, red-team, validate trước mọi dòng code.
/hs:cook	Execute an approved plan phase by phase, TDD red→green.Thực thi plan đã duyệt từng phase, TDD đỏ→xanh.
/hs:test	Run & validate tests; emit the QA verdict.Chạy & validate test; phát verdict QA.
/hs:ship	Gated ship pipeline: review → verify → human → push/PR.Pipeline ship có gate: review → verify → người → push/PR.

/hs:discover	Shape an ambiguous ask into a discovery brief for plan.Biến yêu cầu mơ hồ thành discovery brief cho plan.
/hs:triage	Defect lifecycle: reproduce → classify → gate.Vòng đời defect: tái hiện → phân loại → gate.
/hs:understand	Map a codebase before touching it.Lập bản đồ codebase trước khi đụng.
/hs:team	Parallel Agent Teams with file-ownership lanes.Agent Team song song với làn sở hữu file.
/hs:find-skills	Route to the right skill when you're unsure.Định tuyến tới đúng skill khi chưa chắc.
/hs:codemap	Set up (only with your yes), refresh and check the repo's code map.Lập (chỉ khi bạn đồng ý), làm mới và kiểm bản đồ code của repo.

/hs:code-review	Bugs, regressions, security — verdict in review-decision.json.Bug, regression, bảo mật — verdict trong review-decision.json.
/hs:review-pr	GitHub PR review; --fix and --reply supported.Review PR GitHub; hỗ trợ --fix và --reply.
/hs:critique	Multi-lens adversarial critique → one ranked verdict.Critique đối nghịch nhiều lăng kính → một verdict xếp hạng.
/hs:security-scan	Secrets, CVEs, injection, authz across the diff.Secrets, CVE, injection, authz trên diff.
/hs:scenario	15-dimension edge-case decomposition.Phân rã edge-case 15 chiều.
/hs:predict	Five personas debate a risky change pre-flight.Năm persona tranh luận thay đổi rủi ro trước khi áp.

/hs:debug	Prove root cause before changing behavior.Chứng minh nguyên nhân gốc trước khi đổi hành vi.
/hs:fix	Evidence-based bug / CI fix, minimal change.Fix bug / CI dựa bằng chứng, thay đổi tối thiểu.
/hs:problem-solving	Structured unblocking when you're stuck in a loop.Gỡ rối có cấu trúc khi bạn kẹt trong vòng lặp.

Research & knowledgeNghiên cứu & kiến thức

/hs:research	Verified multi-source research with citations.Nghiên cứu nhiều nguồn có kiểm chứng, kèm trích dẫn.
/hs:scout	Fast parallel codebase exploration.Khám phá codebase song song nhanh.
/hs:tech-graph	Publish-grade static technical diagrams.Sơ đồ kỹ thuật tĩnh chất lượng xuất bản.
/hs:context-engineering	Assemble optimal context within a token budget.Lắp context tối ưu trong ngân sách token.

Think & decideNghĩ & quyết

/hs:brainstorm	Honest trade-off analysis before committing.Phân tích đánh đổi trung thực trước khi cam kết.
/hs:bakeoff	Empirical 2–4-way probe on one metric; winner by numbers.Probe thực nghiệm 2–4 hướng trên một metric; thắng bằng số.
/hs:loop	In-session self-optimization against a metric.Tự tối ưu trong phiên theo một metric.

Explain & documentGiải thích & tài liệu

/hs:docs	Create, update, or audit project docs.Tạo, cập nhật, hoặc audit docs dự án.
/hs:docs-scaffold	Stub missing docs from templates (frontmatter + TBD), no-clobber.Tạo khung doc còn thiếu từ template (frontmatter + TBD), no-clobber.
/hs:docs-standardize	Validate doc structure (frontmatter + graph) → artifact → gate.Kiểm cấu trúc doc (frontmatter + graph) → artifact → gate.
/hs:docs-build	Render docs → showcase HTML + dist (flat-md, PDF, Excel).Render docs → showcase HTML + dist (flat-md, PDF, Excel).
/hs:preview	Explain a change with a diagram.Giải thích thay đổi bằng sơ đồ.
/hs:mermaidjs	Inline Mermaid diagrams in markdown.Sơ đồ Mermaid nội tuyến trong markdown.
/hs:remember	Capture session knowledge into the DEC ledger, memory, or backlog.Ghi kiến thức phiên vào ledger DEC, memory hoặc backlog.

Extend the harnessMở rộng harness

/hs:skill-creator	Create or update hs:* skills.Tạo hoặc cập nhật skill hs:*.
/hs:harness-creator	Create hook / rule / schema / data / script / agent primitives.Tạo primitive hook / rule / schema / data / script / agent.
/hs:bootstrap	Bootstrap a new harness-integrated project.Khởi tạo dự án mới tích hợp harness.
/hs:port	Extract, compare, or port a feature from another repo.Trích xuất, so sánh hoặc port một tính năng từ repo khác.

Project ops, autonomy & sessionVận hành, tự chủ & phiên

/hs:git	Conventional commits, auto-split, secret scan.Conventional commit, auto-split, quét secret.
/hs:worktree	Create / inspect / clean isolated git worktrees.Tạo / soi / dọn git worktree cách ly.
/hs:setup	Configure harness posture (guards, language, code style).Cấu hình posture harness (guard, ngôn ngữ, code style).
/hs:insights	Read-only telemetry insights — hot/cold skills, gate blocks.Insight telemetry chỉ-đọc — skill hay/ít dùng, gate block.
/hs:compound	One ranked self-improvement proposal from telemetry + backlog.Một đề xuất tự cải tiến xếp hạng từ telemetry + backlog.
/hs:techstack	Detect a target repo's stack so the harness adapts.Nhận diện stack repo đích để harness thích nghi.

AI & mediaAI & media

/hs:threejs

3D web experiences with Three.js.Trải nghiệm web 3D với Three.js.

DevOps & deployDevOps & triển khai

/hs:deploy	Deploy to any platform with auto-detection.Triển khai lên mọi nền tảng với tự dò.
/hs:web-testing	Playwright / Vitest / k6 — E2E, load, a11y.Playwright / Vitest / k6 — E2E, load, a11y.

Gate stages → required artifactsStage gate → artifact bắt buộc

Straight from harness/data/stage-policy.yaml. Hard means the requirement is checked at pr/ship/deploy — locally it's an advisory (exit 0) that never blocks you; wire the optional receipts-gate CI workflow into your own repo if you want it hard-enforced remotely too. Soft is advisory only.Lấy thẳng từ harness/data/stage-policy.yaml. Hard nghĩa là yêu cầu được kiểm tại pr/ship/deploy — tại máy chỉ là advisory (exit 0) không bao giờ chặn bạn; gắn workflow CI receipts-gate (tùy chọn) vào CI của repo bạn nếu muốn ép cứng từ xa nữa. Soft chỉ là khuyến cáo.

StageStage	Hard?Cứng?	Required artifactsArtifact bắt buộc
commit	softmềm	none — and no active plan requiredkhông — và không cần plan active
push	hardcứng	verification
pr	hardcứng	verification · review-decision · plan-approval (+critique-consensus opt-in)
merge	hardcứng	same three as prcùng ba cái như pr
ship	hardcứng	same three as prcùng ba cái như pr
deploy	hardcứng	same three as prcùng ba cái như pr

The gating artifactsCác artifact gác cổng

Four artifact files under plans/<active>/artifacts/ — three JSON, one YAML. Each is schema-validated; the gate reads presence + verdict.Bốn file artifact dưới plans/<active>/artifacts/ — ba JSON, một YAML. Mỗi cái được validate schema; gate đọc sự hiện diện + verdict.

ArtifactArtifact	Written byAi ghi	Gate checksGate kiểm
verification.json	hs:cook / hs:test	no FAILed checkkhông có check FAIL
review-decision.json	hs:code-review	verdict == PASSverdict == PASS
plan-approval.yaml	human (plan_approval.py)người (plan_approval.py)	verdict APPROVED for THIS plan (self-approval by design); plan_hash matches (no drift)verdict APPROVED cho CHÍNH plan này (tự-duyệt theo thiết kế); plan_hash khớp (không drift)
critique-consensus.json	hs:critique (gate mode)	consensus verdict presentcó verdict đồng thuận

hs-run / hs-cli referenceTra cứu hs-run / hs-cli

hs-run <domain> <verb> is the deterministic step-sequence engine every hs:* skill drives underneath — 13 domains, 24 verbs. hs-cli is the separate operator CLI for config/admin.hs-run <domain> <verb> là engine bước chạy tất định mà mọi skill hs:* chạy bên dưới — 13 domain, 24 verb. hs-cli là CLI vận hành riêng cho config/admin.

Domain(s)Domain	VerbsVerb
fix · git · port · review · review-pr · security · setup · ship · skills · suite · test	next (one door each)(một cửa mỗi cái)
cook	close, next, open, preflight, prompt, record, status, verify
plan	graph, next, prompt, record, scaffold
hs-code (the code map: Python + TypeScript via language packs)(bản đồ code: Python + TypeScript qua gói ngôn ngữ)	8 domains · 101 verbs (hs-code --list)(hs-code --list)
hs-cli (the config door, not the step engine)(cửa cấu hình, không phải engine bước)	version, doctor, status, gates, guards, hooks, capabilities, list, emit, render, migrate, components, skills, cleanup, install, trust, docs, policy

Two of the hs-cli verbs are new in v6.2.0: hooks reports every hook's resolved posture and which layer decided it, with --off/--on <csv> writing only this project's overlay; emit --target <runtime> projects the hook registrations onto another coding agent, read-only unless you pass --out DIR.Hai verb của hs-cli là mới ở v6.2.0: hooks báo tư thế đã giải của mọi hook và tầng nào đã quyết, với --off/--on <csv> chỉ ghi tầng phủ của dự án này; emit --target <runtime> chiếu các đăng ký hook sang một coding agent khác, chỉ-đọc trừ khi bạn truyền --out DIR.

Every verb returns one JSON envelope (state, next_action, artifacts, refs) on one of six exit codes: 0 done · 1 findings · 2 broken · 3 deliberate refusal · 10 needs a model turn · 11 one more deterministic step. hs-cli covers skills --on/--off (restart to apply), components, migrate, trust, and render — which pretty-prints one envelope read from stdin and never advances a step.Mỗi verb trả một envelope JSON (state, next_action, artifacts, refs) trên một trong sáu mã thoát: 0 xong · 1 phát hiện · 2 hỏng · 3 từ chối có chủ đích · 10 cần lượt model · 11 còn một bước tất định. hs-cli phủ skills --on/--off (khởi động lại để áp dụng), components, migrate, trust, và render — in đẹp một envelope đọc từ stdin, không bao giờ đẩy bước.

A step that reads code facts on a repo with no codemap.yaml answers codemap_offer at exit 10 with an ask_user block, once per session: hs-code init run --apply sets the map up, hs-code init decline keeps it off for the session, and the step's own answer waits in deferred. A broken or refused step is never masked.Bước đọc facts code trên repo chưa có codemap.yaml trả codemap_offer ở exit 10 kèm khối ask_user, mỗi phiên một lần: hs-code init run --apply lập bản đồ, hs-code init decline tắt trong phiên, câu trả lời thật của bước nằm chờ trong deferred. Bước hỏng hay bị từ chối không bao giờ bị che.

Environment variablesBiến môi trường

Behavior knobs and config-path overrides. Every config path defaults to harness/data/ — override only to point at a different file.Núm chỉnh hành vi và override đường-dẫn-config. Mọi đường config mặc định ở harness/data/ — chỉ override khi cần trỏ tới file khác.

VariableBiến	EffectTác dụng
HARNESS_AUTONOMY	default = pause at plan-approval + ship · ask_all = pause every phase · god = no pauses (trace still records)default = dừng ở duyệt-plan + ship · ask_all = dừng mỗi phase · god = không dừng (trace vẫn ghi)
HARNESS_ACTIVE_PLAN	Force which plan dir the gate treats as active.Ép thư mục plan nào được gate coi là active.
HARNESS_TELEMETRY_DISABLED	Set to silence telemetry — fail-open, never blocks.Đặt để tắt telemetry — fail-open, không bao giờ chặn.
HARNESS_USER · HARNESS_AGENT	Actor attribution: USER overrides the user, AGENT adds the agent suffix. Trace only — never authorization.Quy trách nhiệm actor: USER override người dùng, AGENT thêm hậu tố agent. Chỉ để truy vết — không phân quyền.

Actor resolution order: session-init actor → HARNESS_USER → git user.email → $USER; CI is detected automatically.Thứ tự phân giải actor: actor session-init → HARNESS_USER → git user.email → $USER; CI được phát hiện tự động.

VariableBiến	Points atTrỏ tới
HARNESS_STAGE_POLICY	stage-policy.yaml (stage → gate)(stage → gate)
HARNESS_GUARD_POLICY	guard-policy.yaml (OFF/WARN/BLOCK posture)(thế OFF/WARN/BLOCK)
HARNESS_OWNERSHIP_FILE	ownership.yaml (file lanes)(làn file)
HARNESS_PROTECTED_BRANCHES	protected-branches.yaml (merge gate)(merge gate)