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.json
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

109 hs:* skills, grouped by what you're trying to do. Invoke any with /hs:<name>. Full descriptions in the catalog.109 skill hs:*, nhóm theo điều bạn đang muốn làm. Gọi bất kỳ với /hs:<tên>. Mô tả đầy đủ 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: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	12-dimension edge-case decomposition.Phân rã edge-case 12 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 & knowledge — 9 skillsNghiên cứu & kiến thức — 9 skill

/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:autoresearch	Router for the autonomous-iteration skills.Router cho nhóm skill lặp tự động.
/hs:scout	Fast parallel codebase exploration.Khám phá codebase song song nhanh.
/hs:repomix	Pack a repo/subtree into one LLM-friendly digest.Đóng gói repo/subtree thành một digest thân thiện LLM.
/hs:docs-seeker	Look up library docs via llms.txt / context7.Tra docs thư viện qua llms.txt / context7.
/hs:graphify	Build a queryable knowledge graph from code/docs.Xây đồ thị kiến thức truy vấn được từ code/docs.
/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.
/hs:sequential-thinking	Multi-step analysis with self-revision.Phân tích nhiều bước có tự sửa.

Think & decide — 3 skillsNghĩ & quyết — 3 skill

/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 & document — 11 skillsGiải thích & tài liệu — 11 skill

/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:journal	Technical journal — decisions, blockers, lessons.Nhật ký kỹ thuật — quyết định, blocker, bài học.
/hs:retro	Data-driven retrospective from git history.Retrospective dựa dữ liệu từ lịch sử git.
/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:excalidraw	Editable .excalidraw canvases.Canvas .excalidraw chỉnh sửa được.
/hs:document-skills	Read/write .docx / .pdf / .pptx / .xlsx.Đọc/ghi .docx / .pdf / .pptx / .xlsx.
/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 harness — 6 skillsMở rộng harness — 6 skill

/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:mcp-builder	Build an MCP server.Xây một MCP server.
/hs:agentize	Turn existing code into an agent CLI / MCP.Biến code hiện có thành CLI / MCP cho 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 & session — 12 skillsVận hành, tự chủ & phiên — 12 skill

/hs:project-management	Track plan progress, tasks, reports.Theo dõi tiến độ plan, task, báo cáo.
/hs:project-organization	Organize files and directory structure.Tổ chức file và cấu trúc thư mục.
/hs:plans-kanban	File-based kanban for plans/.Kanban file-based cho plans/.
/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:afk	Run a plan unattended; gates still fire.Chạy plan không giám sát; gate vẫn kích hoạt.
/hs:autonomous-bell	Arm a self-ending unattended run with a deterministic STOP.Trang bị lần chạy không giám sát tự kết thúc với STOP xác định.
/hs:voice	Switch the terminal voice (persona / level / no-markdown).Đổi giọng terminal (persona / mức / không-markdown).
/hs:setup	Configure harness posture (voice, guards, language).Cấu hình posture harness (giọng, guard, ngôn ngữ).
/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 & media — 8 skillsAI & media — 8 skill

/hs:ai-multimodal	Analyze and generate images, video, speech, and music.Phân tích và tạo ảnh, video, giọng nói, nhạc.
/hs:ai-artist	Generate mockups and brand visuals via Nano Banana.Tạo mockup và hình ảnh thương hiệu qua Nano Banana.
/hs:media-processing	FFmpeg / ImageMagick / AI background removal.FFmpeg / ImageMagick / xóa nền AI.
/hs:threejs	3D web experiences with Three.js.Trải nghiệm web 3D với Three.js.
/hs:shader	GLSL fragment shaders for procedural graphics.Shader fragment GLSL cho đồ họa thủ tục.
/hs:remotion	Programmatic video with Remotion in React.Video lập trình với Remotion trong React.
/hs:html-video	Render MP4 videos from HTML/CSS/JS templates.Render video MP4 từ template HTML/CSS/JS.
/hs:stitch	Generate UI designs from prompts with Google Stitch.Tạo thiết kế UI từ prompt với Google Stitch.

UI & frontend — 6 skillsUI & frontend — 6 skill

/hs:ui-ux-pro-max	UI/UX design intelligence — style, color, type, a11y.Trí tuệ thiết kế UI/UX — phong cách, màu, chữ, a11y.
/hs:frontend-design	Build polished interfaces from designs / screenshots.Xây giao diện chỉn chu từ thiết kế / ảnh chụp.
/hs:ui-styling	Style with shadcn/ui — Radix + Tailwind.Style với shadcn/ui — Radix + Tailwind.
/hs:web-design-guidelines	Audit UI code against Web Interface Guidelines.Audit code UI theo Web Interface Guidelines.
/hs:design	Brand identity, logos, banners, design tokens.Nhận diện thương hiệu, logo, banner, design token.
/hs:show-off	Self-contained HTML pages to showcase work.Trang HTML tự chứa để trưng bày kết quả.

Stack & frameworks — 8 skillsStack & framework — 8 skill

/hs:frontend-development	React / TypeScript frontends, modern patterns.Frontend React / TypeScript, pattern hiện đại.
/hs:backend-development	Node / Python / Go APIs, auth, microservices.API Node / Python / Go, auth, microservice.
/hs:mobile-development	React Native, Flutter, SwiftUI, Jetpack Compose.React Native, Flutter, SwiftUI, Jetpack Compose.
/hs:web-frameworks	Next.js (App Router, RSC) and Turborepo.Next.js (App Router, RSC) và Turborepo.
/hs:tanstack	TanStack Start / Form / AI.TanStack Start / Form / AI.
/hs:react-best-practices	React / Next.js performance patterns from Vercel.Pattern hiệu năng React / Next.js từ Vercel.
/hs:databases	MongoDB / PostgreSQL schemas, queries, indexes.Schema, query, index MongoDB / PostgreSQL.
/hs:better-auth	Better Auth — OAuth, 2FA, passkeys, sessions, RBAC.Better Auth — OAuth, 2FA, passkey, session, RBAC.

DevOps & deploy — 5 skillsDevOps & triển khai — 5 skill

/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:devops	Cloudflare / Docker / GCP / Kubernetes, CI/CD.Cloudflare / Docker / GCP / Kubernetes, CI/CD.
/hs:web-testing	Playwright / Vitest / k6 — E2E, load, a11y.Playwright / Vitest / k6 — E2E, load, a11y.
/hs:agent-browser	Automate browsers — testing, screenshots, scraping.Tự động trình duyệt — kiểm thử, ảnh chụp, scraping.
/hs:chrome-profile	Drive a real Chrome profile via DevTools MCP.Điều khiển profile Chrome thật qua DevTools MCP.

Integrations & writing — 13 skillsTích hợp & viết — 13 skill

/hs:payment-integration	SePay / Stripe / Paddle / Polar / Creem checkout.Checkout SePay / Stripe / Paddle / Polar / Creem.
/hs:shopify	Shopify apps, extensions, themes; GraphQL Admin API.App, extension, theme Shopify; GraphQL Admin API.
/hs:google-adk-python	Build AI agents with Google ADK Python.Xây AI agent với Google ADK Python.
/hs:use-mcp	Discover and execute MCP server tools.Khám phá và chạy tool MCP server.
/hs:gkg	Semantic code analysis with GitLab Knowledge Graph.Phân tích code ngữ nghĩa với GitLab Knowledge Graph.
/hs:copywriting	Conversion copy — headlines, emails, CTAs.Copy chuyển đổi — tiêu đề, email, CTA.
/hs:ask	Answer technical / architectural questions.Trả lời câu hỏi kỹ thuật / kiến trúc.
/hs:ghpm	GitHub project management for humans and agents.Quản lý dự án GitHub cho người và agent.
/hs:watzup	Short handoff reports with ranked next steps.Báo cáo bàn giao ngắn với bước kế xếp hạng.
/hs:llms	Generate llms.txt from docs or codebase.Tạo llms.txt từ docs hoặc codebase.
/hs:mintlify	Build and maintain Mintlify docs sites.Xây và bảo trì site docs Mintlify.
/hs:markdown-novel-viewer	Calm book-like markdown reader over HTTP.Trình đọc markdown như sách qua HTTP.
/hs:cti-expert	Cyber threat intelligence and OSINT analysis.Phân tích tình báo mối đe dọa mạng và OSINT.

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

Straight from harness/data/stage-policy.yaml. Hard means a missing requirement blocks with exit 2; soft is advisory only.Lấy thẳng từ harness/data/stage-policy.yaml. Hard nghĩa là thiếu yêu cầu thì chặn với exit 2; 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
merge	hardcứng	same four as prcùng bốn cái như pr
ship	hardcứng	same four as prcùng bốn cái như pr
deploy	hardcứng	same four as prcùng bốn cái như pr

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

Four JSON files under plans/<active>/artifacts/. Each is schema-validated; the gate reads presence + verdict.Bốn file JSON dưới plans/<active>/artifacts/. 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.json	human (plan_approval.py)người (plan_approval.py)	self-approval verdict; plan_hash matches (no drift)verdict tự-duyệt; plan_hash khớp (không drift)
critique-consensus.json	hs:critique (gate mode)	consensus verdict presentcó verdict đồng thuận

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)
HARNESS_TERMINAL_VOICE	terminal-voice.yaml (voice prefs)(tùy chọn giọng)