Closed Vocabulary

Kind: principle

Layer: Structural Core

Record: architecture:closed-vocabulary

Severity: mandatory

Scope: repository, folder, filename

Canonical: Ontology

A design rule that every word in a name slot comes from a declared list, and a new word enters the list only by an approved edit.

Listed in Architecture principles, after Hand-Kept Index and before Positional Slot Resolution.

Requires

• Vocabulary Admission
• Rejection Table

Reinforces

• Single Source of Truth
• Ubiquitous Language

Enables

• Placement Predictability
• Concern-Folder Correspondence

Conflicts with

• Vocabulary Inflation
• Nominalized Process Word
• Adjective Slot Word
• Plural Subject
• Measurement Word
• Instance Identifier Word

In tension with

• Naming Expressiveness

Tensions

• Closed Vocabulary / Naming Expressiveness

Contracts

• Vocabulary Admission Gate
• Taxonomy Kernel

Violated by

• Vocabulary Inflation

Refactored by

• Rename to a Declared Word
• Vocabulary Admission

Severity

• mandatory

Category

• Taxonomy / Classification / Naming

Enforced by

• codemods/validators/field.vocabulary.validator.ts
• rules/entrypoints/taxonomy.entrypoint.ts
• runtime/entrypoints/ontology.entrypoint.ts

Reinforced by

• Carrier and Payload Split
• Positional Slot Resolution
• Agnostic-First Vocabulary
• Guided Vocabulary Refusal
• Sanctioned Generic Subject
• Case Dialect

Required by

• Externally Resolved Slot

Linked from

• What PAG is
• A check matches a shape
• One home
• Placement is a grammar
• Coverage is derived
• Definitions own what, code owns how
• The layer spine
• Schema / Canonical Data / Semantics
• Coordination Surfaces
• Taxonomy / Classification / Naming
• Taxonomy / Classification / Naming
• Taxonomy
• Severity levels
• The resolutions

in this codebase

• checkNaming