contextmapper_mcp: Instructions file for Claude Code

CLAUDE.md - Context Mapper MCP Server

This file provides guidance for AI assistants (like Claude) using this MCP server to create Domain-Driven Design models.

Quick Start

// 1. Create a model
cml_create_model({ name: "MyDomainModel" })

// 2. Create a context map
cml_create_context_map({ name: "MyContextMap", state: "AS_IS" })

// 3. Create bounded contexts
cml_create_bounded_context({
  name: "OrderManagement",
  domainVisionStatement: "Handles order lifecycle",
  implementationTechnology: "Python, FastAPI"
})

// 4. Create aggregate
cml_create_aggregate({ contextName: "OrderManagement", name: "OrderAggregate" })

// 5. RECOMMENDED: Use batch creation for aggregate contents
cml_batch_add_elements({
  contextName: "OrderManagement",
  aggregateName: "OrderAggregate",
  identifiers: [
    { name: "OrderId" }
  ],
  entities: [
    {
      name: "Order",
      aggregateRoot: true,
      attributes: [
        { name: "orderId", type: "- OrderId", key: true },
        { name: "status", type: "String" }
      ]
    }
  ],
  valueObjects: [
    {
      name: "OrderStatus",
      attributes: [{ name: "status", type: "String" }]
    }
  ],
  domainEvents: [
    { name: "OrderCreated", attributes: [{ name: "orderId", type: "- OrderId" }] }
  ],
  commands: [
    { name: "CreateOrder", attributes: [{ name: "customerId", type: "String" }] }
  ]
})

// 6. Save the model
cml_save_model({ path: "/path/to/model.cml" })

Alternative: Individual Tool Calls

For simple cases or when you need fine-grained control:

cml_add_identifier({ contextName: "OrderManagement", aggregateName: "OrderAggregate", name: "OrderId" })
cml_add_entity({
  contextName: "OrderManagement",
  aggregateName: "OrderAggregate",
  name: "Order",
  aggregateRoot: true,
  attributes: [
    { name: "orderId", type: "- OrderId", key: true },
    { name: "status", type: "String" }
  ]
})

Critical Rules

1. Use Unique Names Across Bounded Contexts

NEVER use the same domain object name in multiple bounded contexts.