Acronym Vocabulary Scheme & Progressive Disclosure

Overview

This specification establishes the single source of truth for all domain acronyms in the ZQK Knowledge Kernel, resolving cognitive load and onboarding hurdles (TDE-F-USB-JARGON-ACRONYM-BURDEN-006) under requirement REQ-ACRONYM-VOCABULARY-SCHEME.

The vocabulary scheme provides:

Single Source of Truth (pkg/acronyms): Centralized Go definitions, categories, context, and cross-references.
Interactive CLI (zqk explain / zqk glossary): Discoverable terminal commands with table and JSON formatting plus fuzzy suggestions.
Web Studio Progressive Disclosure: Hover tooltips across the DAG visualizer, Timeline/Gantt view, and Object Inspector.

Canonical Kernel Acronyms

Acronym	Full Name	Category	Definition & Context
BLI	Backlog Item	work	A discrete, tracked work package or deliverable scheduled within a Priority Plan. Decomposes requirements into engineering tasks.
PRI	Priority Plan	work	A time-bounded execution plan defining prioritized work packages and delivery horizons. Corresponds to integration branches.
REQ	Requirement	specification	A formal system invariant, capability, or architectural specification. Proven by at least three orthogonal criteria.
CRIT	Criterion	verification	An objective, verifiable acceptance condition proving a requirement (Static Floor, Operational Proof, Negative Boundary).
VDS	Verification Definition of Done	verification	Automated gate proving that all criteria and test lineages are green before pull requests merge.
TCFG	Team Configuration	organization	Approved team composition, agent roster, and operational permissions.
CVS	Convergence Session	coordination	A structured cybernetic feedback session that closes deltas between projected and actual system state.
ATK	Agent Task	execution	A granular, autonomous unit of work assigned to and executed by an agent persona.
PPLAN	Priority Plan (CLI)	cli	CLI command shortcut group for inspecting active priority plans and current workloads.
ZPARQL	ZQK Pattern Query Language	graph	Declarative graph pattern matching and query engine for traversing kernel object relationships.
ZQL	ZQK Query Language	query	Declarative object query, mutation, and filtering expression language.
CAS	Content-Addressable Storage	storage	Immutable, cryptographic hash-indexed object storage layer forming the kernel membrane.
WAL	Write-Ahead Log	storage	Append-only sequential ledger guaranteeing atomic state mutations and crash recovery.
CAP	Continuous Autonomous Protocol	governance	The self-driving cybernetic feedback loop steering agents without human intervention.
CEF	Community Evaluation Framework	evaluation	Comprehensive quality scorecard, testing pyramid, and Diamond Scale grading rubric.
TDE	Technical Debt Entry	hygiene	An objectified defect, architectural smell, or maintainability liability tracked for resolution.

CLI Usage

Look up a specific acronym

zqk explain BLI
zqk glossary VDS

Output:

ACRONYM    : BLI
FULL NAME  : Backlog Item
CATEGORY   : work
DEFINITION : A discrete, tracked work package or deliverable scheduled within a Priority Plan.
CONTEXT    : BLIs decompose requirements into tangible engineering tasks with verifiable criteria.
RELATED    : PRI, REQ, CRIT, ATK

List all acronyms

zqk explain

Structured JSON Output

zqk explain CAP --format json

Fuzzy Match Suggestions

zqk explain BL

Error: unknown kernel acronym "BL".
Did you mean: BLI?
Run 'zqk explain' without arguments to see all registered acronyms

Verification & Traceability

Requirement: REQ-ACRONYM-VOCABULARY-SCHEME
Criteria:
CRIT-ACRONYM-VOCABULARY-ACCEPTANCE: Functional Acceptance (verified by pkg/acronyms/acronyms_test.go and cmd/zqk/explain/explain_test.go).
CRIT-ACRONYM-VOCABULARY-BOUNDARY: Boundary & Error Handling (fuzzy matching and unknown input rejection).
CRIT-ACRONYM-VOCABULARY-DOCS: Documentation & Knowledge Base Entry (this specification).