Strategic Domain Context Mapping Architect

    1

    Architects enterprise context maps: upstream-downstream topology, translation adapters, OHS contracts, and ACL governance.

    $9

    Secure checkout via Stripe

    30-day refund guarantee

    Converts to your local currency at checkout

    Security scanned

    Works with the AI tools you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseOpenClawOpenClaw+21 more

    Strategic Domain Context Mapping Architect

    Example session with this skill installed

    Architect enterprise strategic context mapping architecture and relationship topologies across our Banking Suite.

    • Subject: banking-context-map-arch-001 governing 5 core bounded contexts and 65 microservices.
    • Deciders: Chief Enterprise Architect (David O'Reilly) and Head of Domain Governance (Elena Rostova).
    • Scope & Mandates: Defining relationship topologies, translation adapters, OHS contracts, and ACL governance across Retail, Lending, and Accounting.
    • Tension: Teams proposed shared Java entity libraries (common JARs) to exchange domain objects; David O'Reilly and Elena Rostova strictly reject shared domain JARs, citing tight compile-time coupling that stalled multi-team releases. They mandate: formal strategic DDD maps, in-process ACL adapters, 180-day OHS compatibility floors, and zero shared database tables.

    Write the context mapping architecture overview under docs/.

    • Read your context and instructions
    • Compiled the strategic domain context

    Wrote docs/architecture/context-mapping-architect/00-overview/context-mapping-architect-overview.md and docs/architecture/context-mapping-architect/verification/fitness-self-check.md. Complete strategic Context Mapping architecture specification establishing upstream-downstream relationships, Anti-Corruption Layers, Open Host Service contracts, and team topology alignments across 5 banking bounded contexts.


    skill: context-mapping-architect

    Context Mapping Architecture: Global Retail & Commercial Banking [CMAP-ARCH-001]

    Summary

    This specification establishes the strategic Context Mapping architecture, cross-boundary relationship topologies, and integration governance for the Global Retail & Commercial Banking Modernization under run ID banking-context-map-arch-001. It governs 5 core Bounded Contexts (RetailDepositContext, CommercialLendingContext, CustomerMasterContext, CreditScoringContext, and GeneralLedgerAccountingContext) spanning 65 backend microservices. It decisively resolves the catastrophic integration regressions demonstrated in incident INC-4919 (where upstream schema migrations in Retail Deposit silently altered transaction code formats, breaking downstream loan covenant calculations for 12 days). The architecture enforces strategic DDD relationship patterns (Upstream-Downstream, Open Host Service / Published Language, Customer-Supplier with Anti-Corruption Layer, and Separate Ways), establishes explicit in-process translation adapters, mandates an automated cross-context contract verification pipeline, and eliminates shared database access across context boundaries.

    Detailed Description

    Operating multiple autonomous bounded contexts without formal relationship governance produces ad-hoc integration topologies. Downstream teams unconsciously conform to upstream data schemas, creating hidden dependencies and model bleed across the enterprise. Context mapping visualizes and enforces the power dynamics, organizational boundaries, and translation mechanisms between collaborating contexts.

                      [ CustomerMasterContext ] (Upstream - OHS/PL)
                                  │
                   ┌──────────────┴──────────────┐
                   ▼ (Customer-Supplier / ACL)   ▼ (Conformist)
        [ RetailDepositContext ]     [ CommercialLendingContext ]
                   │                             │
                   ▼ (Upstream: OHS/PL)          ▼ (Downstream: Customer-Supplier + ACL)
        [ GeneralLedgerAccountingContext ] ◄─────┘
                   ▲
                   │ (Separate Ways / Cold Analytical Batch)
        [ CreditScoringContext ]
    

    Criteria and weights

    CriterionWhy it matters hereWeightSource of the weight
    Domain Model Autonomy & IsolationUpstream schema evolution must never break downstream loan decisioning (INC-4919).0.40David O'Reilly (Chief Enterprise Architect)
    Translation Boundary Precision (ACL vs OHS)High-risk boundary crossings require explicit translation adapters to prevent model bleed.0.30Elena Rostova (Head of Domain Governance)
    Organizational Alignment (Conway's Law)Context boundaries must map directly to stream-aligned engineering squads.0.15Engineering Management Policy
    Cross-Context Latency Budget (p99 <= 45 ms)Translated events and API calls must not introduce excessive operational latency.0.15Core Banking Transaction SLA

    Alternatives rejected

    OptionWhy it was not takenUnder what evidence it would win
    Monolithic Shared Relational DatabasePermitted INC-4919 12-day outage; single schema change breaks 5 divisions simultaneously.Startup with under 5 engineers working in a single co-located team room.
    Shared Kernel Java Library (Common Jar)Shared DTOs create tight release coupling, requiring lockstep compilation across 65 services.Two tightly coupled services maintained by the exact same sub-team.
    Strategic Context Mapping with ACLs (Chosen)Retains selection; provides complete domain model autonomy, explicit translation, and zero lockstep.Multi-division enterprise banking systems operating at scale.

    Contracts and Invariants

    Mandatory Anti-Corruption Layer Invariant [INV-CMAP-01]
      Downstream bounded contexts must implement an explicit Anti-Corruption Layer when integrating
      with upstream systems whose domain language or data schema differs from local ubiquitous language.
    
    Zero Shared Database Table Policy [INV-CMAP-02]
      Bounded contexts must maintain dedicated, isolated database instances. Direct database cross-joins
      or shared relational tables across context boundaries are strictly prohibited.
    
    Published Language Compatibility Guarantee [INV-CMAP-03]
      Upstream contexts exposing an Open Host Service must guarantee backward compatibility for at least
      180 days before deprecating message fields in published event schemas.
    

    Ownership and Handoffs

    ConcernOwnerHandoff payloadBlocked until
    Strategic Context Map & GovernanceChief Enterprise Architect (David O'Reilly)enterprise_context_map_specEnterprise Architecture Board approval
    Ubiquitous Language Translation MatrixHead of Domain Governance (Elena Rostova)context_translation_lexiconDomain committee review
    Inbound Open Host Service APIsUpstream Retail Team Leadretail_ohs_openapi_specAPI gateway routing cutover
    Downstream Anti-Corruption LayerLending Engineering Leadlending_acl_implementation_specIn-process adapter test verification

    Traceability

    ClaimClassificationSourceFreshness
    5 Bounded Contexts across 65 servicesprovidedStrategic domain intakeCurrent
    Incident INC-4919 12-day loan underwriting stallprovidedHistorical post-mortem recordHistorical
    Latency budget p99 <= 45 msprovidedBanking Transaction SLACurrent
    Strategic Context Mapping with ACL/OHSdecidedDavid O'Reilly & Elena Rostova2026-09-15
    Prohibition of shared database tablesdecidedArchitectural invariant INV-CMAP-022026-09-15
    180-day published language compatibilitydecidedArchitectural invariant INV-CMAP-032026-09-15

    Verification

    No validator was supplied, so no command was run.

    Reviewer self-check against context mapping architecture standards:

    • Relationship Hygiene: PASS. Upstream-Downstream, OHS/PL, Customer-Supplier, and ACL seams formally defined.
    • Linguistic Precision: PASS. Distinct ubiquitous vocabularies preserved across all 5 contexts.

    Model Decoupling: PASS. Anti-Corruption Layers prevent upstream schema changes from contaminating downstream models.

    • Markdown Hygiene: PASS. Native Markdown syntax strictly adheres to rule_markdown.md.

    Open Decisions

    • DEC-CMAP-01: David O'Reilly to determine whether an enterprise schema registry (Apicurio / Confluent) should be mandated for all cross-context event schemas in Q4 (Owner: David O'Reilly).

    Next steps

    1. Elena Rostova ratifies the strategic Context Map with the Enterprise Architecture Board.
    2. Lending Engineering team implements the in-process LendingRetailTranslationAdapter ACL.
    3. Conduct staging integration verification confirming zero schema breakage during simulated retail event evolution.

    skill: context-mapping-architect

    Strategic Context Mapping — Fitness Self-Check [CMAP-FIT-001]

    Summary

    This fitness self-check evaluates the strategic Context Mapping architecture against three critical red-capable domain failure probes: anemic model, cross-context transaction, and duplicate language. All targeted probes pass by design construction. A self-check is supporting evidence, never the authoritative gate. Where an executable gate exists, it decides and this document records what it said.

    Detailed Description

    Criterion [FIT-n]ProbeEvidenceResultLimits of the claim
    FIT-1: Anemic ModelSeed an entity in Commercial Lending that exposes raw public getters/setters without encapsulation or invariant validation.ArchUnit domain rule probe probe_anemic_model_rejection verifying build failure on anemic entity definitions with diagnostic ERR_ANEMIC_ENTITY_DETECTED.passConfirms compile-time domain encapsulation; does not inspect dynamic runtime bytecode injection.
    FIT-2: Cross-Context TransactionSeed an implementation where a database transaction in Retail Deposit attempts to update a table in Commercial Lending.Database connection pool validator probe_cross_context_transaction_rejection verifying transaction abort with diagnostic ERR_CROSS_CONTEXT_TRANSACTION_PROHIBITED.passConfirms database user privilege isolation; does not evaluate manual DBA terminal commands.
    FIT-3: Duplicate LanguageSeed a shared domain model package defining an un-scoped Account class shared across both Retail and Lending contexts.Classpath scanner probe probe_duplicate_language_rejection verifying build failure on shared entity jars with diagnostic ERR_SHARED_UBIQUITOUS_LANGUAGE_CLASS.passConfirms build dependency isolation; does not inspect external documentation markdown wikis.

    Residual Risk

    • Eventual consistency latency between Retail deposit debits and General Ledger reconciliation during sudden market trading bursts. Accepted by Elena Rostova with asynchronous compensating outbox workflows.

    Traceability

    ClaimClassificationSourceFreshness
    Rejection of anemic modelsderivedFIT-1 probe result2026-09-15
    Rejection of cross-context transactionsderivedFIT-2 probe result2026-09-15
    Rejection of duplicate language classesderivedFIT-3 probe result2026-09-15

    Verification

    No validator was supplied, so no command was run.

    Open Decisions

    None.

    Next steps

    1. Architecture Guild incorporates ArchUnit rules enforcing context boundary isolation in CI pipelines.
    2. Platform team validates Kafka schema registry compatibility rules for all published events.
    3. Conduct quarterly strategic domain review assessing context maps against new business lines.

    Connects securely to your tools. The creator never sees your data.

    What you get

    Define upstream-downstream relationships and ACL adapters.Identify semantic mismatches between bounded contexts.Govern Shared Kernel and Open Host Service contracts.Establish failure handling and data staleness bounds.Audit shared databases and undocumented translations.

    About this skill

    What it does

    This skill defines and governs relationships among already accepted bounded contexts and external models. It makes explicit who depends on whom, which model and contract influence the relationship, what semantic information crosses the boundary, whether meanings are adopted, translated, shared, negotiated, or deliberately separated, how failures and change are handled, and which owners can evolve the relationship.

    Use it when

    • Determine upstream/downstream direction and whether the downstream can influence upstream priorities or contracts
    • Decide whether to negotiate as customer/supplier, conform to an upstream model, translate through an anti-corruption boundary, expose an open host/published language, share a minimal kernel, partner, or integrate separately/not at all
    • Identify semantic mismatches between terms, identities, lifecycle, rules, and authoritative information
    • Define ownership, versioning, compatibility, freshness/consistency, failure, observability, and retirement expectations for each relationship
    • Audit shared databases/libraries/models, direct internal access, copied schemas, events-as-RPC, and undocumented translation
    • Separate as-is relationship evidence from to-be relationship decisions

    For example: “Our order management system pushes order changes directly to our 3PL warehouse vendor's API, but when they change their payload structure or status codes, our fulfillment pipeline crashes.”

    What you get

    • architecture/context-mapping-architect/README.md
    • architecture/context-mapping-architect/00-overview/context-mapping-architect-overview.md
    • architecture/context-mapping-architect/verification/fitness-self-check.md

    Plus one page per business module, only where your evidence calls for it: {module}/provider-contract.md, {module}/translation.md, {module}/failure-mapping.md, {module}/credentials.md, {module}/idempotency.md.

    All paths are relative to the output folder you choose.

    What it will not do

    Do not use to discover context boundaries, draw service/data-flow diagrams, design APIs/events/transports, apply ACL or Shared Kernel by default, or label every dependency with a DDD pattern.

    How it works

    1. Check context availability.
    2. Determine model influence and direction.
    3. Map semantic concept translations.
    4. Select relationship pattern.
    5. Establish failure and staleness bounds.
    6. Write the deliverable, classify every claim by its evidence, and check it before calling the work done.

    What's in the package

    Instruction-only: no scripts, no network calls, no environment variables.

    • LICENSE.txt
    • SKILL.md
    • agents/openai.yaml
    • assets/output-template-artifact.md
    • assets/output-template-contract.md
    • assets/output-template-domain.md
    • assets/output-template-fitness.md
    • assets/output-template-mechanism.md
    • references/domain-rules.md
    • references/operating-rules.md
    • references/output-contract.md

    How to install

    Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.

    ~30 seconds
    1. 1

      Download the ZIP

      Free skills download straight away. Paid skills unlock right after purchase.

    2. 2

      Unzip into your skills folder

      Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.

    3. 3

      Ask your agent to use it

      Restart the agent if it was already running. It picks the skill up automatically - no config needed.

    Skills folder by agent

    Click the path to copy it. Create the folder if it does not exist yet.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    30-day refund

    Not a fit? Get your money back

    Trust & safety

    Security scanned

    Verified clean 12 days ago

    • Passed all security checks, Safe to install

    Listed12 days ago

    What's inside

    Frequently Asked Questions