Install into your repoCài vào repo của bạn

Download the bundle and the standalone install.sh from the release into one folder. One command does it all: verify checksum → extract → check deps → install + verify → run the suite (skip with --skip-tests). No follow-up scripts to chain. Full walkthrough and options: the Install page.Tải bundle và install.sh độc lập từ bản release vào cùng một thư mục. Một lệnh làm tất: kiểm checksum → giải nén → kiểm deps → cài + verify → chạy bộ test (bỏ qua bằng --skip-tests). Không phải nối script. Hướng dẫn đầy đủ và tùy chọn: trang Cài đặt.

Or run the installer directly from a clone. It copies harness/, merges hooks into .claude/settings.json additively (your own hooks survive), installs the pre-push gate, adds a .gitignore block for runtime state, then runs verify_install as the final gate. --non-interactive (alias --yes) is the CI path. Idempotent — preview with --dry-run, reverse with --uninstall. real outputHoặc chạy thẳng trình cài từ một clone. Nó copy harness/, gộp hook vào .claude/settings.json theo kiểu cộng thêm (hook của bạn vẫn còn), cài pre-push gate, thêm khối .gitignore cho trạng thái runtime, rồi chạy verify_install chốt cuối. --non-interactive (alias --yes) là đường CI. Idempotent — xem trước bằng --dry-run, gỡ bằng --uninstall. đầu ra thật

verify_install OK: manifest + hook registration consistent

After installing, enable the plugin with /reload-plugins in Claude Code. Full options: docs/deployment-guide.md; every config knob: harness/rules/config-reference.md.Sau khi cài, bật plugin bằng /reload-plugins trong Claude Code. Tùy chọn đầy đủ: docs/deployment-guide.md; mọi núm cấu hình: harness/rules/config-reference.md.

Plan your first taskLập plan cho task đầu tiên

In Claude Code, run /hs:plan and describe what you want. The harness researches, scans constraints, red-teams, and writes a plan under plans/<slug>/ (plan.md + phase files). You approve it — cook will not run until a human does. Then /clear so cook starts from a clean context. real outputTrong Claude Code, chạy /hs:plan và mô tả điều bạn muốn. Harness nghiên cứu, quét ràng buộc, red-team, rồi ghi plan dưới plans/<slug>/ (plan.md + file phase). Bạn duyệt — cook không chạy cho tới khi một con người duyệt. Rồi /clear để cook bắt đầu từ context sạch. đầu ra thật

plans/260612-1237-harness-w2-horizontal-1/
  artifacts/verification.json
  phase-01-claims-fsm-team-config.md
  phase-02-task-store-adapter-github.md
  phase-03-plan-approval-role-check.md
  phase-04-write-guard-env-scrub-en-3.md
  phase-05-memory-gap-staged-port.md
  phase-06-telemetry-hooks-workflow-lens.md
  plan.md
  reports/code-review-260613-phase6-telemetry.md
  reports/from-code-reviewer-to-planner-red-team-maintainer-operator-plan-review-report.md
  reports/from-code-reviewer-to-planner-red-team-security-failure-plan-review-report.md

Build it — and write the acceptance artifactBuild — và ghi artifact nghiệm thu

Run /hs:cook with the absolute path to the approved plan. It executes phase by phase in TDD red→green, then on the final phase writes verification.json — the exact artifact the gate will look for. /hs:test can re-run the suite and refresh the verdict any time. real outputChạy /hs:cook với đường dẫn tuyệt đối tới plan đã duyệt. Nó thực thi từng phase theo TDD đỏ→xanh, rồi ở phase cuối ghi verification.json — đúng artifact mà gate sẽ tìm. /hs:test có thể chạy lại bộ test và làm mới verdict bất cứ lúc nào. đầu ra thật

{
    "stage": "push",
    "plan": "260612-1237-harness-w2-horizontal-1",
    "actor": "user:dev@team.example",
    "ts": "2026-06-12T05:48:36.669571+00:00",
    "checks": [
        {
            "name": "preflight_deps",
            "status": "PASS",
            "detail": "pytest, pyyaml"
        },
        {
            "name": "pytest harness/tests",
            "status": "PASS",
            "detail": "258 passed (incl. 5 invariants)"
        },
        {
            "name": "schema load yaml+json",
            "status": "PASS",
            "detail": "yaml ok, schemas ok"
        },
        {
            "name": "verify_install --strict",
            "status": "PASS",
            "detail": "manifest 53 files"
        },
        {
            "name": "e2e vertical slice",
            "status": "PASS",
            "detail": "12 passed, 0 failed, transport=simulated-stdin"
        }
    ],
    "verdict": "PASS"
}

Ship through the gateShip qua gate

Now push. If the artifact is missing, the pre-push gate blocks with exit 2 and names the exact path to create — never a dead end. Once Step 4 has written verification.json, the same push passes. That block-then-pass is the whole point. real outputGiờ push. Nếu thiếu artifact, pre-push gate chặn với exit 2 và nêu đúng đường cần tạo — không bao giờ là ngõ cụt. Khi Bước 4 đã ghi verification.json, chính lệnh push đó vượt qua. Chặn-rồi-vượt chính là cốt lõi. đầu ra thật

[gate_stage] BLOCKED: hard stage 'push' needs an active plan but none resolved. Three exits: (1) create a plan under plans/ with `status: in_progress` frontmatter; (2) set HARNESS_ACTIVE_PLAN to the plan dir; (3) set `require_plan: false` for this stage in harness/data/stage-policy.yaml (tracked in git)
[exit 2 — compliance hook fail-closed]