One settled word replaces a paragraph of re-explanation. Definitions here are copied from the canonical sources — SKILL.md files, CLAUDE.md GATEs, and the five operating principles. Each term carries what it forbids (the wording the harness avoids) and the gate, principle, or skill that backs it.Một từ đã chốt thay cho cả đoạn giải thích lại. Các định nghĩa ở đây lấy từ nguồn gốc chuẩn — các file SKILL.md, các GATE của CLAUDE.md, và năm nguyên tắc vận hành. Mỗi thuật ngữ kèm điều nó cấm (cách nói harness tránh dùng) và gate, nguyên tắc, hoặc skill làm chỗ dựa.

Spec hierarchy artifactsCác artifact cây spec

The five artifact levels that product-spec builds. Each level has exactly one parent (except Vision). IDs are parent-scoped and stable.Năm cấp artifact mà product-spec dựng. Mỗi cấp có đúng một parent (trừ Vision). ID có phạm vi theo parent và ổn định.

TermThuật ngữ	DefinitionĐịnh nghĩa	Forbidden wordingCách nói bị cấm	BackingChỗ dựa
Vision	The north-star narrative: why the product exists, who it is for, and what winning looks like. Captured in vision.md. Root of the whole hierarchy — no parent. All BRD goals must trace to it.Câu chuyện định hướng: tại sao sản phẩm tồn tại, cho ai, và thành công trông như thế nào. Ghi trong vision.md. Gốc của toàn bộ cây — không có parent. Mọi mục tiêu BRD phải truy ngược về đây.	"vision statement" (implies a one-liner; the artifact is richer)"tuyên bố tầm nhìn" (ngụ ý một dòng; artifact phong phú hơn)	product-spec SKILL.md
BRD	Business Requirements Document. The single BRD holds business goals (BRD-G1, BRD-G2, …), success metrics, and stakeholders. Exactly one per product; all PRDs must justify against BRD goals.Business Requirements Document. BRD duy nhất chứa mục tiêu kinh doanh (BRD-G1, BRD-G2, …), chỉ số thành công, và stakeholder. Đúng một cái mỗi sản phẩm; mọi PRD phải lý giải dựa trên mục tiêu BRD.	multiple BRDs per product; calling a BRD a "PRD"nhiều BRD cho một sản phẩm; gọi BRD là "PRD"	product-spec SKILL.md
PRD	Product Requirements Document. One PRD per feature area. Contains epics and traces to BRD goals. ID is slug-based (e.g. PRD-AUTH). Multiple PRDs per product are expected.Product Requirements Document. Một PRD mỗi vùng tính năng. Chứa các epic và truy ngược về mục tiêu BRD. ID theo slug (ví dụ PRD-AUTH). Một sản phẩm có nhiều PRD là bình thường.	one monolithic PRD for the whole productmột PRD nguyên khối cho toàn bộ sản phẩm	product-spec SKILL.md
Epic	A deliverable slice of a PRD — large enough to span multiple stories, small enough to ship incrementally. ID is parent-scoped: PRD-AUTH-E1. Each epic contains one or more stories.Một lát deliverable của PRD — đủ lớn để trải nhiều story, đủ nhỏ để ship từng bước. ID theo phạm vi parent: PRD-AUTH-E1. Mỗi epic chứa một hoặc nhiều story.	equating an epic with a user storyđồng nhất epic với user story	product-spec SKILL.md
Story	A user-facing unit of work with acceptance criteria (AC). ID: PRD-AUTH-E1-S1. Must be INVEST-compliant (Independent / Negotiable / Valuable / Estimable / Small / Testable). Size is S | M | L — no story points or hours.Đơn vị công việc hướng người dùng kèm tiêu chí chấp nhận (AC). ID: PRD-AUTH-E1-S1. Phải tuân thủ INVEST (Độc lập / Thương lượng được / Có giá trị / Ước lượng được / Nhỏ / Có thể kiểm thử). Kích thước là S | M | L — không có story point hay giờ.	story points; hour estimates; "task" (implies no user value)story point; ước lượng giờ; "task" (ngụ ý không có giá trị người dùng)	product-spec SKILL.md

Spec governanceQuản trị spec

How the harness guards approved content, tracks decisions, and records outcomes.Cách harness bảo vệ nội dung đã duyệt, theo dõi quyết định, và ghi kết quả.

TermThuật ngữ	DefinitionĐịnh nghĩa	Forbidden wordingCách nói bị cấm	BackingChỗ dựa
status: approved	YAML frontmatter status value meaning the artifact has been explicitly signed off by the PO with an owner and date. Requires a named owner and date — never set by the harness autonomously.Giá trị trạng thái frontmatter YAML nghĩa là artifact đã được PO ký duyệt rõ ràng kèm owner và ngày. Yêu cầu owner và ngày cụ thể — harness không bao giờ tự đặt.	"looks good, marking approved"; setting approved without owner + date"trông ổn, đánh dấu approved"; đặt approved không có owner + ngày	GATE-NEVER-ASSUME (CLAUDE.md)
DEC-<n>	A recorded PO ruling in decisions.md. Created when the PO resolves a contradiction, approves a critique finding, or makes a scope call. Authoritative home for ruled drift — prevents re-litigating settled calls. Status: active or superseded.Một phán quyết PO đã ghi trong decisions.md. Được tạo khi PO giải quyết mâu thuẫn, duyệt phát hiện critique, hoặc đưa ra quyết định phạm vi. Nơi lưu trữ chính thức cho drift đã giải quyết — ngăn tranh luận lại các cuộc đã chốt. Trạng thái: active hoặc superseded.	calling a DEC a "note" or "comment"; auto-creating a DEC without PO confirmgọi DEC là "ghi chú" hay "comment"; tự tạo DEC mà không có xác nhận PO	--decision flag; GATE-NO-SILENT-REVERSAL
OUT-<n>	An outcome record in outcomes.md. Created via --learn to capture a PO-declared measurement of a BRD goal (target vs actual). A miss on an approved goal is surfaced; never auto-edited.Bản ghi kết quả trong outcomes.md. Được tạo qua --learn để ghi lại đo lường do PO khai của một mục tiêu BRD (mục tiêu so với thực tế). Một miss trên mục tiêu đã duyệt được nêu ra; không bao giờ tự sửa.	using OUT-n as a market-success metric (it is PO-declared, offline)dùng OUT-n làm chỉ số thành công thị trường (nó do PO khai, offline)	--learn flag; product-spec SKILL.md
no-silent-reversal	The rule that a new claim contradicting an approved artifact is a stop point. The harness surfaces the contradiction verbatim and offers three choices — Keep · Change (re-approve, owner + date) · Hybrid — never auto-flipping. Backed by GATE-NO-SILENT-REVERSAL in CLAUDE.md.Quy tắc rằng một khẳng định mới mâu thuẫn với artifact approved là điểm dừng. Harness nêu mâu thuẫn nguyên văn và đưa ra ba lựa chọn — Giữ · Đổi (duyệt lại, owner + ngày) · Kết hợp — không bao giờ tự đảo. Được bảo vệ bởi GATE-NO-SILENT-REVERSAL trong CLAUDE.md.	"I'll fix the contradiction"; "tidying up approved wording""Tôi sẽ sửa mâu thuẫn"; "chỉnh văn đã duyệt cho gọn"	GATE-NO-SILENT-REVERSAL (CLAUDE.md)
frontmatter-as-source-of-truth	Operating Principle 1: scripts parse YAML frontmatter to determine structure, status, IDs, and relationships. The LLM never infers structure from headings or prose layout. Frontmatter wins over headings when they conflict.Nguyên tắc vận hành 1: script phân tích frontmatter YAML để xác định cấu trúc, trạng thái, ID và mối quan hệ. LLM không bao giờ suy cấu trúc từ tiêu đề hay bố cục văn. Frontmatter thắng tiêu đề khi chúng mâu thuẫn.	"the heading says…" as a structural claim; inferring status from section titles"tiêu đề ghi…" như khẳng định cấu trúc; suy trạng thái từ tiêu đề mục	Principle 1 (CLAUDE.md)
validate	The two-pass check run by --validate: (1) structural scripts (orphans, missing AC, ID integrity, broken trace, timing drift) → (2) LLM judgment (INVEST quality, vagueness, core-value drift, duplication, contradiction). Deterministic and reproducible — used as a CI gate.Kiểm tra hai lượt do --validate chạy: (1) script cấu trúc (mồ côi, thiếu AC, tính toàn vẹn ID, truy vết hỏng, lệch thời gian) → (2) nhận định LLM (chất lượng INVEST, mơ hồ, lệch core-value, trùng lặp, mâu thuẫn). Tất định và có thể tái tạo — dùng làm cổng CI.	conflating validate with critique (validate = structure; critique = opinion)trộn validate với critique (validate = cấu trúc; critique = quan điểm)	--validate flag; product-spec SKILL.md
core-value	The central value proposition a story or epic must deliver to be worth building — a key concept in LLM-layer validation and critique. Drift from core-value is a findable violation in both --validate and all four critique lenses.Đề xuất giá trị trung tâm mà một story hoặc epic phải mang lại để đáng xây dựng — khái niệm then chốt trong lớp nhận định LLM và critique. Lệch khỏi core-value là vi phạm có thể phát hiện trong cả --validate lẫn bốn lăng kính critique.	unmeasurable adjectives like "great", "excellent", "best-in-class" as core-value evidencetính từ không đo được như "tuyệt vời", "xuất sắc", "tốt nhất" làm bằng chứng core-value	product-spec SKILL.md; GATE-NEVER-ASSUME
in / out scope	Frontmatter scope: field values: in (committed), out (deliberately excluded), or core-value (must-have for the central value prop). Scope is always the PO's call — the harness never sets it autonomously.Giá trị trường scope: trong frontmatter: in (đã cam kết), out (loại trừ có chủ ý), hoặc core-value (bắt buộc cho đề xuất giá trị trung tâm). Phạm vi luôn là quyết định của PO — harness không bao giờ tự đặt.	"scope is obvious, I'll set it"; assuming in/out without explicit PO answer"phạm vi rõ rồi, tôi sẽ đặt"; giả định in/out không có câu trả lời rõ ràng từ PO	GATE-NEVER-ASSUME (CLAUDE.md)

Critique conceptsKhái niệm critique

The opinion layer: non-deterministic, never gates CI, never edits the spec.Lớp quan điểm: không tất định, không bao giờ là cổng CI, không bao giờ sửa spec.

TermThuật ngữ	DefinitionĐịnh nghĩa	Forbidden wordingCách nói bị cấm	BackingChỗ dựa
critique lens	One of four read-only sub-agent perspectives that each critique a spec from a different angle: product (JTBD / Kano / RICE), tech (INVEST / NFRs / testability), market (competitive landscape / moat / unit-economics), craft (writing quality / term drift / vague adjectives). All four run in parallel; a consolidator merges them.Một trong bốn góc nhìn sub-agent chỉ-đọc, mỗi cái critique spec từ một góc độ khác: product (JTBD / Kano / RICE), tech (INVEST / NFR / có thể kiểm thử), market (cạnh tranh / lợi thế / kinh tế đơn vị), craft (chất lượng viết / trôi thuật ngữ / tính từ mơ hồ). Cả bốn chạy song song; một consolidator hợp nhất chúng.	mixing lens output into the spec directly; calling a lens finding a "validation error"trộn đầu ra lăng kính vào spec trực tiếp; gọi phát hiện lăng kính là "lỗi validate"	product-spec-critique SKILL.md
voice level	A 1–9 intensity scale for the critique's sarcasm and register. Default 5 (--no-mercy). Levels 1–4: artifact-only, no personal attack. Level 5: brutal but grounded. Levels 6–9: opt-in danger gate — 6 attacks the author, 7–9 escalate Vietnamese register (ông/tôi → mày/tao); level 9 adds work-targeted profanity and re-confirms on every run.Thang cường độ 1–9 cho sự châm biếm và giọng điệu của critique. Mặc định 5 (--no-mercy). Mức 1–4: chỉ nhắm artifact, không công kích cá nhân. Mức 5: gắt nhưng có căn cứ. Mức 6–9: cổng nguy hiểm opt-in — 6 tấn công tác giả, 7–9 leo thang đại từ tiếng Việt (ông/tôi → mày/tao); mức 9 thêm chửi thề nhắm-vào-công-việc và hỏi lại mỗi lần chạy.	"dialing up the voice" without triggering the danger gate; treating voice level as a setting that can skip the confirm"tăng mức giọng" không qua cổng nguy hiểm; coi voice level là cài đặt có thể bỏ xác nhận	product-spec-critique SKILL.md; --level flag
universal-harm floor	The non-removable safety boundary that applies at ALL voice levels, even 9, even with PO consent. The critique attacks the work — never the person. Out at every level: real violence threats, protected-characteristic slurs, self-harm content, sexual content, family-targeted profanity. The target of the line — work vs person — is the criterion, not the harshness.Ranh giới an toàn không-gỡ-được áp dụng ở MỌI mức giọng, kể cả 9, kể cả khi PO đồng ý. Critique nhắm công việc — không bao giờ nhắm người. Bị loại ở mọi mức: đe dọa bạo lực thật, lăng mạ đặc điểm được bảo vệ, nội dung tự hại, nội dung tình dục, chửi thề nhắm gia đình. Đối tượng của dòng chữ — công việc vs con người — mới là tiêu chí, không phải độ gay gắt.	"the floor is lowerable at level 9 with consent"; treating family-target or slurs as work-criticism"floor có thể hạ ở mức 9 nếu đồng ý"; coi lăng mạ gia đình hay phân biệt chủng tộc là phê bình công việc	product-spec-critique SKILL.md; references/voice-and-tone.md

Release conceptsKhái niệm release

How the harness packs, fingerprints, and ships the bundle — determinism and the safety filter.Cách harness đóng gói, lấy vân tay và ship bundle — tính tất định và bộ lọc an toàn.

TermThuật ngữ	DefinitionĐịnh nghĩa	Forbidden wordingCách nói bị cấm	BackingChỗ dựa
deterministic pack	The guarantee that the same inputs produce a byte-identical tar.gz regardless of when or where it is built. Achieved by: PAX format, sorted walk, mtime=0, uid=gid=0, gzip header mtime=0. A .sha256 sidecar accompanies every bundle for verification. Pinned to commit via SOURCE_DATE_EPOCH in CI.Đảm bảo rằng cùng đầu vào tạo ra tar.gz byte-identical bất kể xây dựng khi nào hay ở đâu. Đạt được bằng: định dạng PAX, duyệt có sắp xếp, mtime=0, uid=gid=0, gzip header mtime=0. Một sidecar .sha256 đi kèm mọi bundle để xác minh. Ghim theo commit qua SOURCE_DATE_EPOCH trong CI.	"should be the same" (without the structural guarantees above); manually running gh release create (SHA differs from CI build)"nên giống nhau" (không có đảm bảo cấu trúc trên); chạy thủ công gh release create (SHA khác build CI)	release SKILL.md; Determinism section
safety filter	The always-on layer inside the pack builder that unconditionally drops .env files, secrets, private keys, .git/, runtime caches, and session state from any bundle — regardless of what manifest or flags request. Non-removable via any flag.Lớp luôn-bật bên trong pack builder luôn loại bỏ vô điều kiện các file .env, secrets, khóa riêng tư, .git/, bộ nhớ đệm runtime, và trạng thái phiên khỏi mọi bundle — bất kể manifest hay cờ yêu cầu gì. Không thể gỡ bỏ bằng bất kỳ cờ nào.	"I'll include the .env for convenience"; a flag that disables the safety filter"Tôi sẽ thêm .env cho tiện"; một cờ tắt bộ lọc an toàn	release SKILL.md; references/safety-rules.md

Telemetry conceptsKhái niệm telemetry

What telemetry measures, what it deliberately does not, and the honesty boundary it must keep.Những gì telemetry đo, những gì nó cố ý không đo, và ranh giới trung thực nó phải giữ.

TermThuật ngữ	DefinitionĐịnh nghĩa	Forbidden wordingCách nói bị cấm	BackingChỗ dựa
telemetry lens	One of 11 named read-only views over local telemetry sinks: usage · session · health · reliability · workflow · validate · memory · product_memory · artifact_heat · forensics · all. Each lens reads from specific .jsonl sinks and surfaces a narrated report. Below ~5 data points a lens shows raw counts + "chưa đủ dữ liệu" and suppresses recommendations.Một trong 11 góc nhìn chỉ-đọc đã đặt tên trên các sink telemetry cục bộ: usage · session · health · reliability · workflow · validate · memory · product_memory · artifact_heat · forensics · all. Mỗi lăng kính đọc từ các sink .jsonl cụ thể và hiển thị báo cáo được diễn giải. Dưới ~5 điểm dữ liệu một lăng kính hiện đếm thô + "chưa đủ dữ liệu" và không đưa ra gợi ý.	inventing a trend when data is sparse; calling a lens a "report generator"bịa ra xu hướng khi dữ liệu ít; gọi lăng kính là "bộ tạo báo cáo"	telemetry SKILL.md; Low-volume gate section
validate proxy	What the --lens validate actually measures: "did the last --validate run pass?" — an internal structural quality signal. It does NOT mean "users adopted the feature" or "the product is succeeding in the market". The proxy label is mandatory in every telemetry narration.Những gì --lens validate thực sự đo: "lần chạy --validate cuối có pass không?" — tín hiệu chất lượng cấu trúc nội bộ. Nó KHÔNG có nghĩa là "người dùng đã chấp nhận tính năng" hay "sản phẩm đang thành công trên thị trường". Nhãn proxy là bắt buộc trong mọi diễn giải telemetry.	"validate passed means the product is working"; equating structural pass with market success"validate pass nghĩa là sản phẩm đang hoạt động"; đồng nhất pass cấu trúc với thành công thị trường	telemetry SKILL.md; Narration & honesty gate
fail-open	Telemetry hook behaviour: on any internal error, the hook stays silent and always continues — never blocks a tool call or session. The 5 telemetry sink hooks are fail-open by design; the 2 enforcement hooks are fail-closed (they block on violation).Hành vi hook telemetry: khi xảy ra lỗi nội bộ, hook giữ im lặng và luôn tiếp tục — không bao giờ chặn lời gọi công cụ hay phiên. 5 sink hook telemetry là fail-open theo thiết kế; 2 hook thực thi là fail-closed (chúng chặn khi vi phạm).	a telemetry hook that exits non-zero on data errormột hook telemetry thoát non-zero khi có lỗi dữ liệu	telemetry SKILL.md; Hook config section
chưa đủ dữ liệu	Telemetry's mandatory low-volume gate phrase. When fewer than ~5 data points exist for a lens, the skill shows raw counts and this phrase, and suppresses all recommendations. On a new or thin repo, most lenses will be gated — the skill says so plainly rather than inventing trends.Cụm từ cổng khối lượng thấp bắt buộc của telemetry. Khi có ít hơn ~5 điểm dữ liệu cho một lăng kính, skill hiện đếm thô và cụm từ này, và bỏ mọi gợi ý. Trên repo mới hay mỏng, hầu hết lăng kính sẽ bị gated — skill nói thẳng như vậy thay vì bịa ra xu hướng.	extrapolating a pattern from 1–2 data points; soft-framing sparse data as a "trend"suy ra xu hướng từ 1–2 điểm dữ liệu; gọi nhẹ dữ liệu thưa là "xu hướng"	telemetry SKILL.md; Low-volume gate section

Structural principlesCác nguyên tắc cấu trúc

The five operating principles from CLAUDE.md that shape how all four skills behave.Năm nguyên tắc vận hành từ CLAUDE.md định hình cách tất cả bốn skill hoạt động.

TermThuật ngữ	DefinitionĐịnh nghĩa	Forbidden wordingCách nói bị cấm	BackingChỗ dựa
script vs LLM split	Principle 3: scripts handle graph traversal, orphan detection, ID integrity, and structural counts (deterministic, reproducible). The LLM judges prose and alignment: INVEST quality, vagueness, core-value drift, duplication, contradiction. Scripts run first; the LLM never recomputes a structural count.Nguyên tắc 3: script xử lý duyệt đồ thị, phát hiện mồ côi, tính toàn vẹn ID và đếm cấu trúc (tất định, có thể tái tạo). LLM nhận định văn và căn chỉnh: chất lượng INVEST, mơ hồ, lệch core-value, trùng lặp, mâu thuẫn. Script chạy trước; LLM không bao giờ tính lại số đếm cấu trúc.	"the LLM counted N orphans" (counts are the script's job)"LLM đếm được N mồ côi" (đếm là việc của script)	Principle 3 (CLAUDE.md)
DRY — one home per fact	Principle 2: every fact has one authoritative home in the spec tree. Cross-reference by ID; never duplicate prose across artifacts. The BRD goal metric lives in brd.md, not restated in each PRD.Nguyên tắc 2: mỗi sự kiện có một nơi chính thống trong cây spec. Tham chiếu chéo bằng ID; không bao giờ nhân đôi văn xuôi giữa các artifact. Chỉ số mục tiêu BRD nằm trong brd.md, không được nhắc lại trong từng PRD.	copy-pasting a goal metric into every PRD; maintaining "convenience copies" of approved textsao chép-dán chỉ số mục tiêu vào mọi PRD; duy trì "bản sao tiện lợi" của văn đã duyệt	Principle 2 (CLAUDE.md)
never overwrite PO prose	Principle 4: on --update, the harness computes the downstream affected set, flags those nodes for PO review, and never auto-rewrites prose. Regeneration is opt-in per node, after the PO sees the flag.Nguyên tắc 4: khi --update, harness tính tập node xuôi chiều bị ảnh hưởng, gắn cờ các node đó cho PO xem, và không bao giờ tự ghi lại văn. Tái tạo là opt-in theo từng node, sau khi PO thấy cờ.	"I'll tidy up their wording"; silently regenerating an approved section"Tôi sẽ chỉnh văn của họ"; tự tạo lại một mục đã duyệt ngầm	Principle 4 (CLAUDE.md)