Product Spec Harness
A harness for Claude Code · v2.4.0Một harness cho Claude Code · v2.4.0

Bulletproof a spec
before a line of code.
Ép chặt một spec
trước khi viết dòng code đầu tiên.

DefineĐịnh nghĩa ValidateKiểm tra CritiquePhản biện ShipĐóng gói ObserveQuan sát

Not a pile of skills — a coordinated .claude/ rig: four skills, seven critique sub-agents, the hooks that instrument them, a shared eval-gate, and a deterministic packager. Plain language for product owners, no code required. Không phải một mớ skill — mà cả một bộ .claude/ phối hợp: bốn skill, bảy sub-agent phản biện, các hook đo lường chúng, một eval-gate dùng chung, và một bộ đóng gói deterministic. Bằng ngôn ngữ bình thường cho Product Owner, không cần code.

product-spec
v2.4.0
…-critique
v1.3.0
release
v1.2.0
telemetry
v1.1.0
Scroll the pipelineCuộn xem quy trình
The closed loopVòng khép kín

One pipeline, four skills, a feedback loopMột quy trình, bốn skill, một vòng phản hồi

Raw ideas in one end; a structured, validated, brutally-critiqued, packaged spec out the other — and the usage of the whole rig flows back as observability.Ý tưởng thô vào một đầu; một spec có cấu trúc, đã kiểm tra, bị phản biện gắt, đã đóng gói ra đầu kia — và mức dùng của cả bộ chảy ngược về thành quan trắc.

01

product-spec

Interview → Vision · BRD · PRD · Epic · Story. Validate, approve, visualize.Phỏng vấn → Vision · BRD · PRD · Epic · Story. Kiểm tra, duyệt, trực quan hóa.

DefineĐịnh nghĩa
02

…-critique

Four lenses tear it apart: product · tech · market · craft. Why it dies + a fix.Bốn lăng kính xé nó ra: product · tech · market · craft. Vì sao chết + cách sửa.

ChallengePhản biện
03

release

Pack a curated .claude/ subset into a deterministic, hashed tar.gz.Đóng gói tập con .claude/ chọn lọc thành tar.gz deterministic, có hash.

ShipĐóng gói
04

telemetry

Read-only usage & health of your own tooling, in plain Vietnamese.Mức dùng & sức khỏe chỉ-đọc của chính bộ đồ nghề, bằng tiếng Việt thuần.

ObserveQuan sát
The return edge: a critique report flows back into product-spec via --apply-critique → recorded decisions. --learn closes spec → build → measure → learn. Cạnh quay về: báo cáo phản biện chảy ngược vào product-spec qua --apply-critique → các quyết định được ghi. --learn khép vòng spec → build → đo → học.
4
coordinated skillsskill phối hợp
7
critique sub-agentssub-agent phản biện
20
visualization viewskhung nhìn trực quan
0
network calls at runtimelần gọi mạng khi chạy
Under the hoodBên trong

What the harness installs — the whole rigHarness cài những gì — cả bộ

Installing the bundle drops a coordinated .claude/ tree into your project. Four skills share one Python venv; everything runs offline after install.Cài bundle là thả vào dự án một cây .claude/ phối hợp. Bốn skill dùng chung một venv Python; mọi thứ chạy offline sau khi cài.

🧩 4 skills4 skill/skills
  • product-spec
  • product-spec-critique
  • release
  • telemetry
🤖 7 sub-agents7 sub-agent/agents
  • product · tech · market · craft critic
  • critique-consolidator
  • critique-humanizer
  • memory-harvester
🪝 HooksHook/hooks
  • 5 telemetry sinks (auto)5 sink telemetry (tự động)
  • memory-gap (opt-in)memory-gap (opt-in)
  • critique-nudge (opt-in)critique-nudge (opt-in)
📐 RulesRule/rules
  • workflow · orchestrationworkflow · điều phối
  • development · docsphát triển · tài liệu
  • the always-on safety floorlằn ranh an toàn luôn bật
🧪 Shared eval-gateEval-gate dùng chung/_shared
  • run_evals.py (structural)(cấu trúc)
  • llm_eval.py (advisory)(advisory)
  • runnable golden fixturesfixture golden chạy được
📦 Packager + installerĐóng gói + installerroot
  • pack.manifest.yaml
  • install.sh · install.ps1
  • multiplatform, idempotentđa nền tảng, idempotent
🔒
Privacy: all four skills make no network calls at runtime. product-spec's one-time installer vendors Mermaid/marked/DOMPurify from a public CDN, then verifies each against a pinned SHA-256. After install, everything runs on your machine.Quyền riêng tư: cả bốn skill không gọi mạng khi chạy. Installer một lần của product-spec tải Mermaid/marked/DOMPurify từ CDN công khai rồi verify từng cái bằng SHA-256 đã ghim. Sau khi cài, mọi thứ chạy trên máy bạn.
NextSauAll guidesMục lục