Skip to main content

Coverage Expectation

Coverage Expectations define the desired coverage level for a specific business architecture domain within an organization or one of its units. Each expectation states the target level, why that level is needed, and optionally the strategy that supports it and the lifecycle stage it applies to.

Schema: coverage-expectation.schema.json
Specification: JSON Schema Draft-07

Overview​

What is a Coverage Expectation?​

A Coverage Expectation specifies:

  • Which domain it applies to
  • Where it applies (an organizational unit, or the whole organization)
  • Target coverage level for the domain
  • Justification for that level (e.g. compliance, risk, opportunity)
  • Strategic link to the strategy that supports it
  • Lifecycle stage, when the expectation is tailored to elements at a particular stage

Relationship to Other Coverage Records​

A coverage template provides typical levels; an expectation sets the level for a particular organization or unit. Coverage status records compare achieved coverage with the expectation's targetCoverageLevel (as expectedCoverageLevel).

Expectation Attributes​

AttributeTypeRequiredDescription
coverageExpectationIDString✓Unique identifier for the coverage expectation
domainString✓The business architecture domain this expectation applies to (e.g. "Capability", "Strategy", "Information")
orgUnitString or nullThe organizational unit this expectation applies to; null when it applies to the whole organization
targetCoverageLevelEnum✓The desired level of coverage for the domain
lifecycleStageEnum or nullLifecycle stage this expectation applies to, used to tailor expectations to the development phase of the domain's elements
justificationString✓Reason for the desired coverage level (e.g. compliance, risk, opportunity)
linkedStrategyString or nullLink to the Strategy element supporting this expectation
createdByString✓User or system that created this record
createdAtDate-time✓Timestamp of creation

Target Coverage Level (targetCoverageLevel)​

ValueDescription
noneThe domain is not documented
minimalA few entities are recorded with little detail
documentedCore entities and their attributes are recorded
analysedRelationships, dependencies and gaps have been analysed
governedOwnership, review and change control are in place
optimisedThe domain model is maintained continuously and used to drive decisions and improvement

Lifecycle Stage (lifecycleStage)​

The shared lifecycle stage list; null or omitted when the expectation applies at every stage.

ValueDescription
ideationIdea being explored
planningScope and approach being planned
designBeing designed
developmentBeing built
implementationBeing implemented or rolled out
launchBeing launched
operationalIn operation
enhancementBeing enhanced
optimizationBeing optimized
retirementBeing retired

Example​

Finance Unit Capability Expectation​

{
"coverageExpectationID": "cexp-001",
"domain": "capability",
"orgUnit": "OU-Finance",
"targetCoverageLevel": "analysed",
"justification": "Required for budgeting accuracy and integration with forecasting process",
"linkedStrategy": "strat-2025-03",
"createdBy": "admin@org.com",
"createdAt": "2025-07-01T10:30:00Z"
}

Organization-Wide Expectation for Operational Services​

{
"coverageExpectationID": "cexp-002",
"domain": "service",
"orgUnit": null,
"targetCoverageLevel": "governed",
"lifecycleStage": "operational",
"justification": "Operational services must have clear ownership and change control for service-level reporting",
"linkedStrategy": null,
"createdBy": "admin@org.com",
"createdAt": "2025-07-01T10:45:00Z"
}

Usage Guidelines​

Creating Realistic Expectations​

  1. Base on actual capacity — Don't overcommit
  2. Start from a template — Adjust a coverage template's levels rather than starting from scratch
  3. Justify every level — justification should name the compliance, risk or opportunity driver
  4. Prioritize ruthlessly — Set high levels only for the highest-value domains
  5. Track actively — Review coverage status against each expectation

Expectation vs. Actual Tracking​

DomainExpectedAchievedGapStatus
Capabilityanalyseddocumented1Approaching
Policygovernedgoverned0Met
Performancedocumentedminimal1Approaching
Servicegovernednone4Not started

Adjusting Expectations​

When expectations are missed:

  1. Analyze root cause — Why did we miss?
  2. Revisit the level — Is the target still justified?
  3. Address blockers — Remove dependencies
  4. Communicate early — Don't wait until the next assessment
For Data Engineers

Coverage Expectations can drive data catalog population sprints. Align your data documentation milestones with business architecture coverage expectations to ensure data assets are documented in parallel with the capabilities and processes they support.