Skip to content

Glossary

Terms defined here are ADDD-specific or specialized in this standards repository. Standard DDD terms (Aggregate, Value Object, Domain Event, etc.) use Evans/Vernon definitions unless noted otherwise. Agents SHOULD load this file when a term is ambiguous. Do not load for routine layer edits unless the task touches documentation or cross-layer naming.


Architecture and process

TermDefinition
ADDDAgentic Domain-Driven Design: documentation and delivery model for single bounded-context monoliths. Combines spec sync, lexical alignment, tri-layer naming, and agent-first conventions. Not a distributed systems pattern, microservices strategy, or full DDD methodology.
Agent load planMachine-readable specification in standards.manifest.jsonagentLoadPlans that maps a task type to Tier 0–3 resources an agent MUST load. See Context tiers.
Agentic guardrailsNormative rules in docs/conventions/shared/agentic-guardrails.md: scaffolding sequence, XML rules, anti-drift patterns, verification checkpoints.
Context tiersThree-level loading strategy for agent documentation: Tier 0 (AGENTS.md, always loaded), Tier 1 (task-loaded Quick Rules sections), Tier 2 (reference-loaded full conventions), Tier 3 (blueprints for file generation only). See docs/agentic-development.md §6.
FeatureFolder grouping that contains one Aggregate and all its Use Cases. Not a bounded context, GitHub feature flag, or feature toggle. Multiple Features exist within a single bounded context. Example: docs/domain/posts/, Posts/, features/posts/.
Implementation Prerequisite SetMinimum documents that MUST exist before an agent begins implementation: Feature Spec (docs/domain/{feature}/README.md), Use Case Doc, and Use Case Test Spec. See docs/guides/agentic-domain-driven-design.md.
Invariant coverageMapping between domain invariants declared in a Feature Spec and the specific tests that verify each invariant. Recorded in the Feature Spec Invariants Under Test table and Use Case Test Spec Test Coverage rows.
Lexical alignmentProperty of a codebase where folder names, file names, class names, and method names use the same vocabulary as the domain ubiquitous language and the Feature Spec. Consequence of Screaming Architecture applied to docs, backend, and frontend.
Page composition docDocument under docs/ui/{app}/pages/ or shell.md that describes a single frontend route: which Use Cases compose on it, screen states, and content modes. Not a CQRS read model projection. Previously called “UI projection doc.”
ReactionsADDD-specific name for the Application.Reactions project layer. Handles domain event-driven side effects via narrow interfaces. In DDD literature this corresponds to policies or domain event handlers.
Scoped loadingLoading only the convention files or Quick Rules sections required for the current layer or task, not the entire docs/conventions/ tree.
Screaming architectureBob Martin’s term: folder structure communicates business intent without reading code. In ADDD it applies to docs (docs/domain/{feature}/), backend ({Feature}/{UseCase}/), and frontend (features/{feature}/{use-case}/), not code folders alone.
Spec sync ruleConvention that documentation and code MUST be updated in the same commit/PR. A document that describes behavior the code does not implement, or code that implements behavior no document describes, violates this rule.
Spec-anchoredSynonym for Spec sync rule when describing a repository or workflow: documentation and code cannot diverge by policy.
Strike 0 / 1 / 2Promotion rule for shared frontend code: use case local (0), feature shared/ after two uses (2). Strike 1 is the first duplicate that triggers planning for promotion.
TierProject risk classification for coverage thresholds: production (default), internal, prototype. Declared in project docs/domain/README.md or project README. Distinct from Context tiers.

Documentation artifacts (consumer projects)

TermDefinition
Agent indexMachine-readable domain map at docs/domain/agent-index.json. Lists features, use cases, doc paths, risk levels, and layer-context keys matching agentLoadPlans. Companion to docs/domain/README.md.
Layer contextYAML frontmatter and agent-index field listing agentLoadPlans keys (for example backend.application, frontend.app) that an agent MUST load for a use case. See docs/guides/write-use-case-doc.md.
Feature README (Feature Spec)docs/domain/{feature}/README.md: ubiquitous language, aggregate invariants, events, use case index.
System indexdocs/domain/README.md: map of features, use cases, and documentation completeness status.
Use case doc (operation doc)docs/domain/{feature}/{use-case}.md: operation specification for a single command or query. Contains business contract, HTTP interface, domain behavior, and pointer to Use Case Test Spec. Not a UML use case diagram.
Use case test specdocs/domain/{feature}/{use-case}.tests.md: specifies which scenarios are tested, at which layer, with which variations, and what is explicitly not tested.
Test Coverage tableRows in a test spec; each row maps to tests and, for acceptance tests, to AC-00N criterion IDs.

Backend layers

TermDefinition
Contracts projectApplication.Write.Contracts or Application.Read.Contracts: commands, queries, results, shared validation types; no handlers.
IDatabaseContextRead-side EF abstraction in Application.Read.Contracts; query handlers project through it only.

Testing and traceability

TermDefinition
API acceptance testHTTP-level test tracing to a Test Coverage row; may be plain xUnit or Reqnroll Gherkin. See docs/conventions/backend/api-acceptance-tests.md.
@usecase: tagReqnroll tag value {feature}/{use-case} matching the operation doc path without .md (for example posts/publish-post).
@ac: tagReqnroll tag value AC-00N matching row N in the test spec Test Coverage table.
Executable acceptanceAcceptance tests that fail when behavior diverges from the test spec; closes part of the Specification by Example gap.
Spec completeness checkingAgent-assisted or CI structural audit of ADDD documents: invariant coverage gaps, state transition coverage, frontmatter completeness, test spec orphans. Not domain discovery. See docs/guides/agentic-domain-driven-design.md §12.

DocumentPurpose
docs/guides/agentic-domain-driven-design.mdDocumentation tree, scope, and agent workflow
docs/guides/onboarding.mdHuman engineer entry path
docs/agentic-development.mdContext tiers and agent failure modes
standards.manifest.jsonMachine-readable paths and agentLoadPlans