harness-kit
CLI scaffold agent harness thuộc sở hữu của project.
Agent harness bị drift khi mỗi repository tự chế setup riêng.
Harness Kit dành cho đội ngũ cần guardrail AI coding có thể lặp lại, review được, và thuộc sở hữu của project thay vì nằm trong prompt folder cá nhân.
Setup drift
Rules, skills, hooks, MCP servers và agent instructions lệch nhau giữa các repository khi được copy thủ công.
Áp lực context budget
Mỗi rule thêm vào đều tiêu tốn model context. Bundle phải chứng minh chi phí của nó thay vì nhét mọi thứ vào mọi project.
Cài đặt khó review
Những thay đổi setup một lần rất khó audit. Đội ngũ cần diff nhỏ, file rõ ràng và status check.
Cài một capability, preview artifacts, rồi xác minh state.
CLI giữ workflow có tính cơ học rõ ràng: init, chọn bundle, apply file thuộc sở hữu của repo, rồi audit harness state ngay từ repository.
Artifacts được preview
Initialize
Detect hình dạng project, hỏi tối thiểu các câu setup và ghi baseline harness files.
Chọn bundle
Chọn capability workflow, stack, tech-stack, memory, search, browser hoặc MCP từ registry.
Preview diff
Hiển thị các file sẽ được ghi để harness đi vào project qua code review bình thường.
Audit status
Báo cáo bundles đã cài, file thiếu, env vars và drift trước khi agent run tiếp theo phụ thuộc vào chúng.
Typed registry cấp dữ liệu cho copy-owned installer.
Hệ thống được tách lớp có chủ đích: shared types định nghĩa contract, registry mô tả bundles như data, engine ghi artifact, còn commands/TUI điều phối quyết định của người dùng.
- 01
Core contract
Shared TypeScript types định nghĩa bundle manifest, artifact variants, env vars và harness config để mọi layer dùng cùng schema.
@harness-kit/coretypesconstants - 02
Bundle registry
Bundles là TypeScript manifests, không phải JSON rời. Catalog có thể query, validate và render thành web docs.
BundleManifestworkflowtechstack - 03
Installer engine
Artifact installers và template renderers ghi file vào target repo trong khi giữ kết quả có thể audit.
installertemplatesscaffolder - 04
Command và TUI layer
Commander commands và Ink/XState wizard điều phối init, add, list, status và preview/apply flows.
commanderInkxstate
Guardrails thuộc sở hữu project, cài theo từng đơn vị nhỏ.
Harness Kit tập trung vào artifact cụ thể trong repository thay vì một runtime service ẩn.
Diff nhỏ, dễ review
Thêm từng tính năng một để các thay đổi thiết lập luôn dễ hiểu và dễ kiểm toán.
Baseline đội ngũ nhất quán
Chuẩn hóa các quy tắc agent, skills, và trạng thái harness trên toàn bộ repository.
Tài liệu onboarding thực tiễn
Làm theo quickstart, command reference và troubleshooting mà không cần đọc source code trước.
Toolkit tối ưu cho ownership, không phải automation ẩn.
Mỗi quyết định thiết kế giữ harness ở trong repository, kể cả khi điều đó buộc người dùng review file và quản lý context có chủ đích.
- 01
Copy-own distribution
Tối ưu
Tối ưu cho artifacts có thể edit, version và không phụ thuộc runtime vào CLI sau khi cài.
Chi phí chấp nhận
Updates không tự động. Thay đổi tương lai cần update flow rõ ràng và diff có thể review.
- 02
Just enough context
Tối ưu
Tối ưu để giữ agent instructions dưới ngưỡng context cost làm giảm chất lượng output.
Chi phí chấp nhận
Default preset phải có opinion rõ và không thể mặc định chứa mọi rule hữu ích.
- 03
Registry là typed data
Tối ưu
Tối ưu cho validation, docs generation và bundle metadata agent-readable.
Chi phí chấp nhận
Thêm bundle đòi hỏi manifest structure có kỷ luật thay vì thả file tuỳ ý vào một folder.
Một beta CLI đã publish với bundle catalog đang mở rộng.
Harness Kit đã có hình dạng của một developer tool thật: package boundaries, command tests, TUI wizard, registry validation, web docs, examples và release planning.
CLI và wizard dùng được
Beta CLI hỗ trợ init, add, list, status, budget, version, activate và remove flows quanh các harness files thuộc sở hữu project.
Đã có bundle catalog
Workflow, stack và tech-stack bundles bao phủ skills, rules, agents, hooks, MCP integrations và framework guidance.
Evidence tiếp theo là usage telemetry
Lệnh usage được planned sẽ cho thấy skill và agent nào hữu ích, stale, hoặc đang làm giảm context efficiency.