methodatlas

Domain Modeling Mapping tool

Domain Context Map

A domain context map shows where particular models apply and how their owning teams must collaborate.

A context map shows bounded contexts with their own domain language and model ownership, plus integration and team relationships. Upstream and downstream describe model dependency, not automatically the direction of a data packet.

Core question
Where do particular models apply and how must their owning teams collaborate?
Participants
3-10 participants
Time
90–180 minutes for an initial slice; further modelling sessions as needed
Paper illustration for Domain Context Map
  1. Contexts

    Bound contexts

    Identify areas with a consistent model using terms and rules.

  2. Ownership

    Ownership and current state

    Assign each context to an owning team and collect current integrations.

  3. Dependency

    Label dependencies

    Determine upstream/downstream model dependency or a symmetric relationship for each connected pair.

  4. Patterns

    Examine relationship patterns

    Choose and justify team and integration patterns, such as Customer/Supplier, Partnership, Conformist or Anti-Corruption Layer.

  5. Risks

    Risks and next modelling

    Review conflicting terms, unmaintained contracts and tight coupling with both sides.

Recheck relationships with both sides and version the map when models, teams or contracts change.

A good fit when

For domain-driven design when model boundaries or cross-team integrations need clarification.

Ideal for

  • DDD strategy
  • Architecture discovery
  • Platform boundaries

Not good for

  • Story-level refinement
  • UI flow design

Outputs

  • Context map with model relationships

    The versioned context map contains boundaries, domain terms, owners, directed dependencies, relationship patterns, and open modelling questions.

  • Reviewed map and clarification tasks

    The clarification record contains a specific modelling or contract question with owner and date.

Domain Context Map· worksheet

Fictional example

A context map shows bounded contexts with their own domain language and model ownership, plus integration and team relationships. Upstream and downstream describe model dependency, not automatically the direction of a data packet.

Context inventory

Record purpose, domain terms, boundaries and owner per context.

Fictional: Catalog (Offering team) manages courses; Enrollment (Participation team) manages seat reservations; Billing (Finance team) manages receivables.

Relationship 1

Record contexts, U/D roles, contract, patterns and change coordination.

Catalog U → Enrollment D: course ID and offering via a versioned API. Catalog offers OHS/Published Language; Enrollment translates external statuses through an ACL into its reservation model.

Relationship 2

Describe another relationship including influence over the interface.

Enrollment U → Billing D: confirmed enrolment event. Customer/Supplier: Billing can negotiate required billing fields with the Participation team.

Open modelling question

Which meaning or responsibility is unclear, who will clarify it and with what evidence?

On cancellation, reservation status differs from receivable status. Both teams review three cancellation cases by Friday and document event rules.

All example details are fictional and illustrate the application.

DDD Crew: Context Mapping

First step

Collect a domain slice, concrete business workflows, team ownership and known interfaces. Keep current and target views separate.

Open the method guide

Deep dive

Purpose

When a domain model and its associated contexts need to be thought through together, it creates a shared overview. It connects the business view and organizational boundary into a readable whole.

How it works

It places domain elements and context boundaries side by side and makes their connection explicit. This makes model, collaboration, and integration points discussable together without mixing up business boundary and technical interface.

In detail

This method carries weight because it orders business spaces from the domain's point of view, creating a more robust basis for later team or system cuts. Good application looks at coherence of meaning, language boundaries, and interactions instead of just relabeling existing org charts. This produces a picture that enables strategic delimitation while also exposing where shared terms only seem to carry the same meaning.

Facilitation

Bring cases where similar terms trigger different consequences in different areas, because that's where the dividing lines show most clearly. It gets really productive when a term stays stable but its purpose changes. Close with a short list of named contexts and the most uncertain transitions between them.

The method guide walks execution through 5 phases, timing, 5 pitfalls, and clear stop criteria.

Open method guide

Your perspective

Does this method help with your work?

Your feedback helps shape the next improvements to methodatlas.

Sources and topics

Topics
Artifact templates
Domain Context Map: WorksheetCollect a domain slice, concrete business workflows, team ownership and known interfaces. Keep current and target views separate.
markdown

domain-context-map-working-template.md

Collect a domain slice, concrete business workflows, team ownership and known interfaces. Keep current and target views separate.

Domain Context Map: Worksheet

Question

To be confirmed

Desired outcome

To be confirmed

Scope

Complete cycle Time: 90–180 minutes for an initial slice; further modelling sessions as needed

Complete this worksheet on paper or in your own document during the work.

Preparation for this scope

Method setup

  • Materials: Context cards, integration contracts, team list, arrows with a U/D legend and domain-term notes.
  • Roles: Domain experts, model owners, involved development teams and facilitator.
  • Advance information: Collect a domain slice, concrete business workflows, team ownership and known interfaces. Keep current and target views separate.
  • Overall time needed: 90–180 minutes for an initial slice; further modelling sessions as needed
  • Setup: Lay out context cards with terms and owners; add a U/D legend and derive connections from concrete integrations.

Prepare for the work steps

Contexts: Bound contexts

  • Business workflows
  • Terms and rules

Ownership: Ownership and current state

  • Context inventory
  • Team representatives

Dependency: Label dependencies

  • Integrations
  • Model dependencies

Patterns: Examine relationship patterns

  • Context relationships
  • Team agreements

Risks: Risks and next modelling

  • Map draft
  • Concrete business cases

Domain Context Map· worksheet

Context inventory

Record purpose, domain terms, boundaries and owner per context.

...

Relationship 1

Record contexts, U/D roles, contract, patterns and change coordination.

...

Relationship 2

Describe another relationship including influence over the interface.

...

Open modelling question

Which meaning or responsibility is unclear, who will clarify it and with what evidence?

...

Answer the prompts with your own information. Explicitly mark unknowns and assumptions.

DDD Crew: Context Mapping

Contexts: Bound contexts

Expected artifact: Context inventory

Does a consistent domain language apply within each boundary?

Entry:

...

  • Does a consistent domain language apply within each boundary?

Ownership: Ownership and current state

Expected artifact: Confirmed ownership

Are ownership and current-state status confirmed?

Entry:

...

  • Are ownership and current-state status confirmed?

Dependency: Label dependencies

Expected artifact: Labelled context relationships

Is the arrow meaning explained in a legend?

Entry:

...

  • Is the arrow meaning explained in a legend?

Patterns: Examine relationship patterns

Expected artifact: Justified relationship patterns

Does the pattern describe actual collaboration and translation?

Entry:

...

  • Does the pattern describe actual collaboration and translation?

Risks: Risks and next modelling

Expected artifact: Reviewed map and clarification tasks

Does each unresolved relationship have a clarification task?

Entry:

...

  • Does each unresolved relationship have a clarification task?

Open questions and next steps

...

Method guide: https://methodatlas.meierhoff-systems.de/en/methods/domain-context-map/run-sheet

Alternatives and neighbors

Fitting alternatives with decision guidance, followed by other related methods.

All methods
Constraints and origin
MediumWorkshop1-3 h

Profile

Method form
Mapping tool
Participants
3-10
Time
1-3 h
Maturity
Established
Origin
Praxisgemeinschaft
A paper-based illustration representing Bounded Context Canvas with its core stages and visible working result.
Next up: Bounded Context Canvas