Installing is one command — no follow-up scripts to chain over several turns. It verifies the bundle, extracts it, checks dependencies, installs into your repo, verifies the wiring, and runs the test suite — in that order, fail-fast at the first problem. Requirements: Linux, Python ≥ 3.9, git, and Claude Code.Cài đặt là một lệnh — không phải chạy script nối tiếp qua nhiều lượt. Nó kiểm bundle, giải nén, kiểm phụ thuộc, cài vào repo, xác nhận wiring, rồi chạy bộ test — theo đúng thứ tự đó, dừng ngay ở lỗi đầu tiên. Yêu cầu: Linux, Python ≥ 3.9, git, và Claude Code.

Install in one commandCài trong một lệnh

Point the installer at a release bundle and the target repo. It runs five steps for you: ① verify the sha256 sidecar → ② extract → ③ check deps (and print the exact pip command if any are missing) → ④ install + verify (--strict fails on any drift) → ⑤ run the test suite against the freshly installed copy. The integrity check in step ④ already proves the install; step ⑤ is the extra "does it run green in my environment" pass, and you can skip it with --skip-tests.Trỏ trình cài vào một bản release và repo đích. Nó chạy năm bước hộ bạn: ① kiểm sha256 → ② giải nén → ③ kiểm deps (và in đúng lệnh pip nếu thiếu) → ④ cài + verify (--strict lỗi khi có lệch) → ⑤ chạy bộ test trên bản vừa cài. Bước ④ đã chứng minh cài đúng; bước ⑤ là lượt kiểm thêm "chạy có xanh trong môi trường của tôi không", và bạn bỏ qua được bằng --skip-tests.

The release ships two files: the bundle harness-<version>.tar.gz (with its .sha256) and a standalone install.sh. Download them into the same folder, then run:Bản release kèm hai file: bundle harness-<version>.tar.gz (cùng .sha256) và một install.sh độc lập. Tải cả hai vào cùng một thư mục, rồi chạy:

Step ③ — check dependencies. Deps are checked before anything is installed, so a missing one stops the run early with the command to fix it. real outputBước ③ — kiểm phụ thuộc. Deps được kiểm trước khi cài, nên thiếu cái gì là dừng sớm kèm lệnh sửa. đầu ra thật

preflight OK: pytest, pyyaml

Step ④ — install + verify. The installer 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, injects a self-loading harness onboarding block into CLAUDE.md (replace-between-markers, your prose preserved), then runs verify_install as the closing gate. Pass --no-track to run the harness without committing harness/ into your product git. real outputBước ④ — cài + verify. Trình cài 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, chèn khối onboarding harness tự-nạp vào CLAUDE.md (thay-giữa-mốc, giữ nguyên prose của bạn), rồi chạy verify_install làm gate chốt. Dùng --no-track để chạy harness mà không commit harness/ vào git sản phẩm. đầu ra thật

verify_install OK: manifest + hook registration consistent

Step ⑤ — run the suite (default; --skip-tests to skip). The harness ships its own tests and runs them against the installed copy, so you see them green in your environment before you trust the gate. real outputBước ⑤ — chạy bộ test (mặc định; --skip-tests để bỏ). Harness kèm theo bộ test của chính nó và chạy trên bản vừa cài, để bạn thấy chúng xanh trong môi trường của mình trước khi tin vào gate. đầu ra thật

........................................................................ [  8%]
........................................................................ [ 17%]
........................................................................ [ 26%]
........................................................................ [ 35%]
........................................................................ [ 44%]
........................................................................ [ 52%]
........................................................................ [ 61%]
........................................................................ [ 70%]
........................................................................ [ 79%]
........................................................................ [ 88%]
........................................................................ [ 97%]
........................                                                 [100%]
816 passed in 17.28s

Prefer explicit commands? Install step by stepThích lệnh tường minh? Cài từng bước

The one-shot above wraps these. If you would rather see each command, unpack the bundle and run the installer directly — same writes, same final verify. Three lines: install deps, extract, install.Lệnh-một-phát ở trên gói lại đúng các bước này. Nếu muốn thấy từng lệnh, giải nén bundle và chạy thẳng trình cài — cùng cách ghi, cùng verify cuối. Ba dòng: cài deps, giải nén, cài.

① Install deps (the direct path skips the auto-check):① Cài deps (đường trực tiếp bỏ qua bước tự kiểm):

② Extract the bundle into a folder beside your repo — not inside it (see the note below):② Giải nén bundle ra một thư mục cạnh repo — đừng để trong repo (xem lưu ý dưới):

③ Install, pointing --target at your repo:③ Cài, trỏ --target vào repo của bạn:

OptionsTùy chọn

From a clone (advanced)Từ một clone (nâng cao)

If you already have the harness checked out, skip the bundle and run the installer directly. Same writes, same final verify; this is the path the one-shot wraps. Every mutation is idempotent and previewable.Nếu đã có harness sẵn, bỏ qua bundle và chạy thẳng trình cài. Cùng cách ghi, cùng verify cuối; đây là đường mà lệnh-một-phát bọc lại. Mọi thay đổi đều idempotent và xem-trước được.

FAQHỏi đáp