# Semantic Consistency

> The degree to which one name carries one meaning across the code, the schemas and the documentation.

Record: `architecture:semantic-consistency`
Kind: quality-attribute
Layer: [Contracts Core](https://banes-lab.com/records/layer/contracts-core.md)
Severity: mandatory
Scope: domain, API, data
Canonical: https://banes-lab.com/ontology#architecture-semantic-consistency

Listed in [Architecture principles](https://banes-lab.com/api/records/architecture.md), after [Normalization](https://banes-lab.com/records/architecture/normalization.md) and before [Ubiquitous Language](https://banes-lab.com/records/architecture/ubiquitous-language.md).

## Repair

- Refactored by: Rename, Split Context, Add Translator
- Detected by: conflicting glossary/schema definitions
- Violated by: same name with different meanings
- Measured by: semantic conflict count
- Enforced by: glossary review, schema review

## Requires

- [Ubiquitous Language](https://banes-lab.com/records/architecture/ubiquitous-language.md)
- [Semantic Contracts](https://banes-lab.com/records/architecture/semantic-contracts.md)

## Reinforces

- [Correctness](https://banes-lab.com/records/architecture/correctness.md)
- [Interoperability](https://banes-lab.com/records/architecture/interoperability.md)

## Enables

- [Disambiguation](https://banes-lab.com/records/lexicon/disambiguation.md)

## Conflicts with

- [Ambiguous Naming](https://banes-lab.com/records/lexicon/ambiguous-naming.md)
- [Inconsistent Error Model](https://banes-lab.com/records/architecture/inconsistent-error-model.md)

## In tension with

- [Polysemy Across Contexts](https://banes-lab.com/records/lexicon/polysemy-across-contexts.md)

## Tensions

- [Semantic Consistency / Polysemy Across Contexts](https://banes-lab.com/records/tension/polysemy-across-contexts-semantic-consistency.md)

## Severity

- [mandatory](https://banes-lab.com/records/vocabulary/severity-mandatory.md)

## Category

- [Schema / Canonical Data / Semantics](https://banes-lab.com/records/architecture-category/schema-canonical-data-semantics.md)

## Enforced by

- [codemods/entrypoints/word.entrypoint.ts](https://banes-lab.com/source/governance/codemods/entrypoints/word.entrypoint.ts.md)
- [rules/eslint/strings-terminology.eslint.rule.ts](https://banes-lab.com/source/governance/rules/eslint/strings-terminology.eslint.rule.ts.md)
- [rules/eslint/strings-vocabulary.eslint.rule.ts](https://banes-lab.com/source/governance/rules/eslint/strings-vocabulary.eslint.rule.ts.md)

## Reinforced by

- [Domain-Driven Design](https://banes-lab.com/records/architecture/domain-driven-design.md)
- [Knowledge Graphs](https://banes-lab.com/records/architecture/knowledge-graphs.md)

## Required by

- [Data Contract](https://banes-lab.com/records/architecture/data-contract.md)
- [Canonical Model](https://banes-lab.com/records/architecture/canonical-model.md)

## Linked from

- [Anti-patterns](https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md)
- [Domain Architecture](https://banes-lab.com/ontology/principles/architecture-category-domain-architecture.md)
- [Contracts / Interfaces / Compatibility](https://banes-lab.com/ontology/principles/architecture-category-contracts-interfaces-compatibility.md)
- [Correctness / Determinism / Verification](https://banes-lab.com/ontology/principles/architecture-category-correctness-determinism-verification.md)
- [Model Architecture](https://banes-lab.com/ontology/principles/architecture-category-model-architecture.md)
- [Schema / Canonical Data / Semantics](https://banes-lab.com/ontology/principles/architecture-category-schema-canonical-data-semantics.md)
- [Core Vocabulary](https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md)
- [Schema / Canonical Data / Semantics](https://banes-lab.com/ontology/lexicon/lexicon-category-schema-canonical-data-semantics.md)
- [Severity levels](https://banes-lab.com/ontology/schema/the-vocabulary-severity.md)
- [The resolutions](https://banes-lab.com/ontology/schema/the-resolutions.md)