@documentation-robotics/cli 0.1.13 → 0.3.0

package/dist/integrations/claude_code/skills/dr_02_business_layer/SKILL.md

@@ -41,21 +41,22 @@ This layer uses **ArchiMate 3.2 Business Layer** standard without custom extensi
 > **CLI Introspection:** Run `dr schema types business` for the authoritative, always-current list of node types.
 > Run `dr schema node <type-id>` for full attribute details on any type.
 
-| Entity Type               | Description                                          | Key Attributes                                                        |
-| ------------------------- | ---------------------------------------------------- | --------------------------------------------------------------------- |
-| **BusinessActor**         | Organizational entity capable of performing behavior | Examples: Customer, Employee, Partner, Supplier                       |
-| **BusinessRole**          | Responsibility for performing specific behavior      | Examples: Sales Representative, Account Manager, System Administrator |
-| **BusinessCollaboration** | Aggregate of business roles working together         | Examples: Sales Team, Customer Service Department, Project Team       |
-| **BusinessInterface**     | Point of access where business service is available  | Examples: Customer Portal, Phone Support, Email Support               |
-| **BusinessProcess**       | Sequence of business behaviors achieving a result    | Can include BPMN references, security controls, KPI targets           |
-| **BusinessFunction**      | Collection of business behavior based on criteria    | Examples: Marketing, Sales, Customer Service, Finance                 |
-| **BusinessInteraction**   | Unit of collective behavior by collaboration         | Examples: Sales Meeting, Contract Negotiation, Customer Onboarding    |
-| **BusinessEvent**         | Something that happens and influences behavior       | Types: time-driven, state-change, external                            |
-| **BusinessService**       | Service that fulfills a business need                | Includes SLA properties, motivation links, APM monitoring             |
-| **BusinessObject**        | Concept used within business domain                  | Examples: Order, Invoice, Customer, Opportunity, Support Ticket       |
-| **Contract**              | Formal specification of agreement                    | Examples: SLA, Terms of Service, Purchase Agreement                   |
-| **Representation**        | Perceptible form of business object                  | Required `format`: pdf, html, xml, json, plain-text, binary           |
-| **Product**               | Coherent collection of services with a value         | Aggregates services and contracts, delivers value to customers        |
+| Entity Type               | Description                                            | Key Attributes                                                              |
+| ------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------------- |
+| **BusinessActor**         | Organizational entity capable of performing behavior   | Examples: Customer, Employee, Partner, Supplier                             |
+| **BusinessRole**          | Responsibility for performing specific behavior        | Examples: Sales Representative, Account Manager, System Administrator       |
+| **BusinessCollaboration** | Aggregate of business roles working together           | Examples: Sales Team, Customer Service Department, Project Team             |
+| **BusinessInterface**     | Point of access where business service is available    | Examples: Customer Portal, Phone Support, Email Support                     |
+| **BusinessProcess**       | Sequence of business behaviors achieving a result      | Can include BPMN references, security controls, KPI targets                 |
+| **BusinessFunction**      | Collection of business behavior based on criteria      | Examples: Marketing, Sales, Customer Service, Finance                       |
+| **BusinessInteraction**   | Unit of collective behavior by collaboration           | Examples: Sales Meeting, Contract Negotiation, Customer Onboarding          |
+| **BusinessEvent**         | Something that happens and influences behavior         | Types: time-driven, state-change, external                                  |
+| **BusinessService**       | Service that fulfills a business need                  | Includes SLA properties, motivation links, APM monitoring                   |
+| **BusinessObject**        | Concept used within business domain                    | Examples: Order, Invoice, Customer, Opportunity, Support Ticket             |
+| **Contract**              | Formal specification of agreement                      | Examples: SLA, Terms of Service, Purchase Agreement                         |
+| **Representation**        | Perceptible form of business object                    | Required `format`: pdf, html, xml, json, plain-text, binary                 |
+| **Product**               | Coherent collection of services with a value           | Aggregates services and contracts, delivers value to customers              |
+| **BusinessCapability**    | An ability the organization has (ArchiMate Capability) | Examples: Share data with partners, Settle claims; not a SoftwareCapability |
 
 ---
 
@@ -108,98 +109,134 @@ IS this a coherent bundle of services with a value proposition for customers?
 
 ## Common Misclassifications
 
-| Misclassification                                     | Correct Classification                                                                                         | Why                                                                                |
-| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
-| A department or team as `BusinessService`             | `BusinessFunction` (department) or `BusinessCollaboration` (team)                                              | Services are externally visible capabilities; departments are behavioral groupings |
-| A REST endpoint or UI as `BusinessInterface`          | `BusinessInterface` is correct — but link it to the `ApplicationInterface` in the application layer            | Business interfaces are the business-facing access point, not the technical one    |
-| A business rule or policy as `BusinessProcess`        | `BusinessProcess` only for sequences of steps; rules belong in Motivation layer as `Principle` or `Constraint` | Processes produce outcomes through behavior; rules govern behavior                 |
-| A domain entity (Order, Invoice) as `BusinessProcess` | `BusinessObject`                                                                                               | Objects are concepts; processes are sequences of behavior                          |
-| A job title (Sales Rep) as `BusinessActor`            | `BusinessRole`                                                                                                 | Roles are responsibilities; actors are the people/orgs that fill them              |
-| An SLA document as `BusinessService`                  | `Contract`                                                                                                     | An SLA is a formal agreement, not the service itself                               |
-| A product feature as `BusinessFunction`               | `Product` if it bundles services with customer value; `BusinessService` if it's a single capability            | Products aggregate services; functions are internal behavioral groupings           |
+| Misclassification                                           | Correct Classification                                                                                         | Why                                                                                                                      |
+| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| A department or team as `BusinessService`                   | `BusinessFunction` (department) or `BusinessCollaboration` (team)                                              | Services are externally visible capabilities; departments are behavioral groupings                                       |
+| A REST endpoint or UI as `BusinessInterface`                | `BusinessInterface` is correct — but link it to the `ApplicationInterface` in the application layer            | Business interfaces are the business-facing access point, not the technical one                                          |
+| A business rule or policy as `BusinessProcess`              | `BusinessProcess` only for sequences of steps; rules belong in Motivation layer as `Principle` or `Constraint` | Processes produce outcomes through behavior; rules govern behavior                                                       |
+| A domain entity (Order, Invoice) as `BusinessProcess`       | `BusinessObject`                                                                                               | Objects are concepts; processes are sequences of behavior                                                                |
+| A job title (Sales Rep) as `BusinessActor`                  | `BusinessRole`                                                                                                 | Roles are responsibilities; actors are the people/orgs that fill them                                                    |
+| An SLA document as `BusinessService`                        | `Contract`                                                                                                     | An SLA is a formal agreement, not the service itself                                                                     |
+| A product feature as `BusinessFunction`                     | `Product` if it bundles services with customer value; `BusinessService` if it's a single capability            | Products aggregate services; functions are internal behavioral groupings                                                 |
+| A software ability ("Save to file") as `BusinessCapability` | `product.softwarecapability`                                                                                   | It is what the software can do; it realizes the business function it carries out, which realizes the business capability |
 
 ---
 
 ## Intra-Layer Relationships
 
+The business layer's modelling rules (from `spec/layers/02-business.layer.json`):
+
+- Actors fill roles. Roles and collaborations are `assigned-to` the processes, functions and interactions they perform; behaviour is never assigned to an actor directly.
+- Internal behaviour `realizes` business services. Interfaces offer services (`assigned-to`), and services `serve` actors, roles and processes.
+- Only behaviour `accesses` business objects and contracts. Actors, roles and interfaces reach information through the behaviour assigned to them.
+- Events `trigger` processes and interactions, and behaviour raises events (`triggers`). A hand-off between behaviours is `flows-to`. A function has no start, so it is reached by `flows-to`, never triggered.
+- A business capability is an ability the organization has: business functions and processes `realize` it, capabilities `aggregate` narrower capabilities, and software capabilities (product layer) contribute by realizing the business functions behind it.
+
 ### Structural Relationships
 
-| Source Type           | Predicate   | Target Type         | Example                                                           |
-| --------------------- | ----------- | ------------------- | ----------------------------------------------------------------- |
-| Product               | composes    | BusinessService     | "E-commerce Platform" composes "Payment Service"                  |
-| BusinessCollaboration | composes    | BusinessRole        | "Sales Team" composes "Sales Representative" role                 |
-| BusinessProcess       | composes    | BusinessProcess     | "Order Fulfillment" composes "Pick", "Pack", "Ship" sub-processes |
-| BusinessFunction      | composes    | BusinessProcess     | "Sales Function" composes "Lead Generation Process"               |
-| Product               | aggregates  | BusinessService     | Product bundles multiple services                                 |
-| Product               | aggregates  | Contract            | Product includes SLA contracts                                    |
-| BusinessCollaboration | aggregates  | BusinessRole        | Collaboration includes multiple roles                             |
-| BusinessActor         | assigned-to | BusinessRole        | "John Smith" assigned to "Sales Rep"                              |
-| BusinessActor         | assigned-to | BusinessProcess     | Actor directly performs process                                   |
-| BusinessRole          | assigned-to | BusinessProcess     | Role responsible for process execution                            |
-| BusinessRole          | assigned-to | BusinessFunction    | Role performs function                                            |
-| BusinessCollaboration | assigned-to | BusinessInteraction | Collaboration performs interaction                                |
-| BusinessProcess       | realizes    | BusinessService     | "Order Processing" realizes "Order Management Service"            |
-| BusinessFunction      | realizes    | BusinessService     | "Customer Support Function" realizes "Support Service"            |
-| BusinessInteraction   | realizes    | BusinessService     | "Contract Negotiation" realizes "Contracting Service"             |
-| Representation        | realizes    | BusinessObject      | "Invoice PDF" realizes "Invoice" concept                          |
-| BusinessObject        | specializes | BusinessObject      | "RetailCustomer" specializes "Customer"                           |
-| BusinessRole          | specializes | BusinessRole        | "Senior Sales Rep" specializes "Sales Rep"                        |
-| Contract              | specializes | Contract            | "Premium SLA" specializes "Standard SLA"                          |
+| Source Type           | Predicate  | Target Type        | Example                                                    |
+| --------------------- | ---------- | ------------------ | ---------------------------------------------------------- |
+| Product               | aggregates | BusinessService    | "Premium Membership" aggregates "Free Shipping Service"    |
+| Product               | composes   | Contract           | "Premium Membership" composes "Membership Terms"           |
+| BusinessFunction      | composes   | BusinessFunction   | "Sales" composes "Lead Management"                         |
+| BusinessRole          | composes   | BusinessRole       | "Store Manager" composes "Cashier Supervisor"              |
+| BusinessObject        | composes   | BusinessObject     | "Order" composes "Order Line"                              |
+| BusinessCollaboration | aggregates | BusinessRole       | "Sales Team" aggregates "Sales Representative"             |
+| Representation        | realizes   | BusinessObject     | "Invoice PDF" realizes "Invoice"                           |
+| Representation        | realizes   | Contract           | "Signed MSA Document" realizes "Master Services Agreement" |
+| Contract              | governs    | BusinessService    | "Premium SLA" governs "Support Service"                    |
+| BusinessCapability    | aggregates | BusinessCapability | "Customer Management" aggregates "Customer Onboarding"     |
+| BusinessFunction      | realizes   | BusinessCapability | "Data Exchange" realizes "Share Data with Partners"        |
+| BusinessProcess       | realizes   | BusinessCapability | "Claim Settlement" realizes "Settle Claims"                |
+
+### Assignment Relationships (who performs what)
+
+| Source Type           | Predicate   | Target Type         | Example                                                  |
+| --------------------- | ----------- | ------------------- | -------------------------------------------------------- |
+| BusinessActor         | assigned-to | BusinessRole        | "Jane Smith" assigned to "Account Manager"               |
+| BusinessRole          | assigned-to | BusinessProcess     | "Order Processor" assigned to "Order Fulfillment"        |
+| BusinessRole          | assigned-to | BusinessFunction    | "Support Agent" assigned to "Customer Support"           |
+| BusinessRole          | assigned-to | BusinessInteraction | "Account Manager" assigned to "Contract Negotiation"     |
+| BusinessCollaboration | assigned-to | BusinessInteraction | "Sales Team" assigned to "Sales Meeting"                 |
+| BusinessInterface     | assigned-to | BusinessService     | "Customer Portal" assigned to "Order Management Service" |
+
+### Service Relationships
+
+| Source Type         | Predicate | Target Type     | Example                                                 |
+| ------------------- | --------- | --------------- | ------------------------------------------------------- |
+| BusinessProcess     | realizes  | BusinessService | "Order Fulfillment" realizes "Order Management Service" |
+| BusinessFunction    | realizes  | BusinessService | "Customer Support" realizes "Support Service"           |
+| BusinessInteraction | realizes  | BusinessService | "Contract Negotiation" realizes "Contracting Service"   |
+| BusinessService     | serves    | BusinessActor   | "Order Management Service" serves "Customer"            |
+| BusinessService     | serves    | BusinessRole    | "Sales Reporting Service" serves "Regional Manager"     |
+| BusinessService     | serves    | BusinessProcess | "Credit Check Service" serves "Loan Approval"           |
+| BusinessInterface   | serves    | BusinessActor   | "Mobile App" serves "Customer"                          |
+| BusinessInterface   | serves    | BusinessRole    | "Admin Console" serves "Administrator"                  |
+| BusinessService     | delivers  | BusinessObject  | "Policy Issuance Service" delivers "Insurance Policy"   |
 
 ### Behavioral Relationships
 
-| Source Type         | Predicate       | Target Type         | Example                                                      |
-| ------------------- | --------------- | ------------------- | ------------------------------------------------------------ |
-| BusinessEvent       | triggers        | BusinessProcess     | "Order Received" triggers "Order Fulfillment Process"        |
-| BusinessEvent       | triggers        | BusinessFunction    | "Monthly Close" triggers "Financial Reporting Function"      |
-| BusinessEvent       | triggers        | BusinessInteraction | "Customer Complaint" triggers "Issue Resolution Interaction" |
-| BusinessProcess     | triggers        | BusinessEvent       | "Payment Complete" triggers "Order Confirmed Event"          |
-| BusinessInteraction | triggers        | BusinessProcess     | "Sales Meeting" triggers "Proposal Generation Process"       |
-| BusinessProcess     | flows-to        | BusinessProcess     | "Credit Check" flows to "Order Approval"                     |
-| BusinessInteraction | flows-to        | BusinessProcess     | "Negotiation" flows to "Contract Signing"                    |
-| BusinessService     | serves          | BusinessActor       | "Customer Portal" serves "Customer"                          |
-| BusinessService     | serves          | BusinessRole        | "Reporting Service" serves "Manager" role                    |
-| BusinessService     | serves          | BusinessProcess     | "Authentication Service" serves "Login Process"              |
-| BusinessInterface   | serves          | BusinessActor       | "Mobile App" serves "Customer"                               |
-| BusinessInterface   | serves          | BusinessRole        | "Admin Console" serves "Administrator" role                  |
-| BusinessProcess     | accesses        | BusinessObject      | "Order Process" accesses "Order" object                      |
-| BusinessFunction    | accesses        | BusinessObject      | "Billing Function" accesses "Invoice" object                 |
-| BusinessInteraction | accesses        | BusinessObject      | "Contract Review" accesses "Contract" object                 |
-| Contract            | associated-with | BusinessService     | SLA contract associated with service delivery                |
-| BusinessObject      | associated-with | BusinessProcess     | "Customer" associated with "Onboarding Process"              |
+| Source Type         | Predicate | Target Type         | Example                                               |
+| ------------------- | --------- | ------------------- | ----------------------------------------------------- |
+| BusinessEvent       | triggers  | BusinessProcess     | "Order Received" triggers "Order Fulfillment"         |
+| BusinessEvent       | triggers  | BusinessInteraction | "Customer Complaint" triggers "Issue Resolution Call" |
+| BusinessProcess     | triggers  | BusinessEvent       | "Order Shipping" triggers "Order Shipped"             |
+| BusinessFunction    | triggers  | BusinessEvent       | "Financial Close" triggers "Month Closed"             |
+| BusinessInteraction | triggers  | BusinessEvent       | "Contract Negotiation" triggers "Deal Agreed"         |
+| BusinessProcess     | flows-to  | BusinessProcess     | "Pick Items" flows to "Pack Order"                    |
+| BusinessProcess     | flows-to  | BusinessFunction    | "Order Fulfillment" flows to "Invoicing"              |
+| BusinessFunction    | flows-to  | BusinessProcess     | "Underwriting" flows to "Policy Issuance"             |
+| BusinessInteraction | flows-to  | BusinessProcess     | "Sales Meeting" flows to "Proposal Generation"        |
+
+### Information Access Relationships
+
+| Source Type         | Predicate | Target Type    | Example                                                |
+| ------------------- | --------- | -------------- | ------------------------------------------------------ |
+| BusinessProcess     | accesses  | BusinessObject | "Order Fulfillment" accesses "Order"                   |
+| BusinessFunction    | accesses  | BusinessObject | "Billing" accesses "Invoice"                           |
+| BusinessInteraction | accesses  | BusinessObject | "Contract Review" accesses "Quote"                     |
+| BusinessProcess     | accesses  | Contract       | "Renewal Processing" accesses "Subscription Agreement" |
+| BusinessFunction    | accesses  | Contract       | "Contract Management" accesses "Supplier Agreement"    |
+| BusinessService     | accesses  | Contract       | "Support Service" accesses "Premium SLA"               |
 
 ---
 
 ## Cross-Layer References
 
-### Outgoing References (Business → Lower Layers)
-
-| Target Layer              | Reference Type                                      | Example                                                  |
-| ------------------------- | --------------------------------------------------- | -------------------------------------------------------- |
-| **Layer 1 (Motivation)**  | BusinessService delivers **Value**                  | "Payment Service" delivers "Revenue Generation" value    |
-| **Layer 1 (Motivation)**  | BusinessService supports **Goal**                   | Service achieves business goals                          |
-| **Layer 1 (Motivation)**  | BusinessService governed by **Principle**           | Follows business principles                              |
-| **Layer 1 (Motivation)**  | BusinessActor **is** Stakeholder                    | Actor maps to stakeholder in motivation layer            |
-| **Layer 1 (Motivation)**  | BusinessProcess achieves **Goal**                   | Process realizes business goals                          |
-| **Layer 1 (Motivation)**  | Contract drives **Constraint**                      | SLA contract defines constraints                         |
-| **Layer 4 (Application)** | BusinessService realized by **ApplicationService**  | "Order Service" realized by "OrderManagementAPI"         |
-| **Layer 4 (Application)** | BusinessProcess automated by **ApplicationProcess** | Process workflow automated by application                |
-| **Layer 4 (Application)** | BusinessObject represented in **DataObject**        | "Customer" business concept maps to customer data object |
-| **Layer 4 (Application)** | BusinessEvent triggers **ApplicationEvent**         | Business event generates application event               |
-| **Layer 3 (Security)**    | BusinessProcess protected by **SecurityControl**    | Process has authentication/authorization                 |
-| **Layer 3 (Security)**    | BusinessCollaboration maps to **SecurityActor**     | Team maps to security roles                              |
-| **Layer 6 (API)**         | BusinessInterface maps to **API Operation**         | Portal interface maps to REST endpoints                  |
-| **Layer 7 (Data Model)**  | BusinessObject → **JSON Schema**                    | Business object defined as schema                        |
-| **Layer 11 (APM)**        | BusinessProcess tracked by **BusinessMetric**       | Process performance measured                             |
-| **Layer 11 (APM)**        | BusinessService defines **KPI Target**              | SLA targets for monitoring                               |
-
-### Incoming References (Lower Layers → Business)
-
-Lower layers (Application, Technology, API, etc.) reference Business layer elements to show:
-
-- **Realization**: Application services realize business services
-- **Support**: Technology supports business operations
-- **Traceability**: APIs map to business interfaces
+### Outgoing References (Business → Other Layers)
+
+| Source Type        | Predicate      | Target Type                 | Example                                                        |
+| ------------------ | -------------- | --------------------------- | -------------------------------------------------------------- |
+| BusinessService    | realizes       | `motivation.goal`           | "Order Management Service" realizes "Improve Order Efficiency" |
+| BusinessCapability | supports       | `motivation.goal`           | "Settle Claims" supports "Pay Claims Within a Day"             |
+| BusinessCapability | realizes       | `motivation.outcome`        | "Onboard Customers" realizes "Onboarding Time Halved"          |
+| BusinessService    | realizes       | `motivation.outcome`        | "Same-Day Delivery" realizes "Delivery Complaints Halved"      |
+| BusinessService    | delivers       | `motivation.value`          | "Order Management Service" delivers "Customer Convenience"     |
+| BusinessService    | satisfies      | `motivation.requirement`    | "Support Service" satisfies "24/7 Support Availability"        |
+| BusinessProcess    | realizes       | `motivation.outcome`        | "Automated Refunds" realizes "Refund Time Under 48h"           |
+| BusinessProcess    | satisfies      | `motivation.requirement`    | "KYC Verification" satisfies "Verify Customer Identity"        |
+| BusinessActor      | references     | `motivation.stakeholder`    | "Customer" actor references "Retail Customers" stakeholder     |
+| BusinessRole       | references     | `motivation.stakeholder`    | "Compliance Officer" references "Regulators"                   |
+| BusinessObject     | references     | `application.dataobject`    | "Order" references the "OrderRecord" data object               |
+| BusinessProcess    | constrained-by | `security.separationofduty` | "Payment Approval" constrained by "Maker-Checker Rule"         |
+
+### Incoming References (Other Layers → Business)
+
+| Source Type                       | Predicate  | Target Type      | Example                                                  |
+| --------------------------------- | ---------- | ---------------- | -------------------------------------------------------- |
+| `application.applicationservice`  | realizes   | BusinessService  | "OrderService API" realizes "Order Management Service"   |
+| `application.applicationprocess`  | realizes   | BusinessProcess  | "Checkout Saga" realizes "Order Fulfillment"             |
+| `application.applicationfunction` | realizes   | BusinessFunction | "Invoice Generator" realizes "Billing"                   |
+| `application.applicationevent`    | triggers   | BusinessProcess  | "PaymentSucceeded" event triggers "Order Fulfillment"    |
+| `application.applicationservice`  | accesses   | BusinessObject   | "OrderService API" accesses "Order"                      |
+| `product.softwarecapability`      | realizes   | BusinessFunction | "Save Documents to Files" realizes "Share Data"          |
+| `product.userworkflow`            | realizes   | BusinessProcess  | "Checkout Journey" realizes "Order Fulfillment"          |
+| `data-model.objectschema`         | realizes   | BusinessObject   | "Order" schema realizes "Order" business object          |
+| `data-store.collection`           | realizes   | BusinessObject   | "orders" table realizes "Order"                          |
+| `security.role`                   | references | BusinessRole     | "admin" security role references "Administrator"         |
+| `security.securitypolicy`         | governs    | BusinessService  | "Payment Security Policy" governs "Payment Service"      |
+| `apm.metricinstrument`            | monitors   | BusinessProcess  | "orders.fulfilled" metric monitors "Order Fulfillment"   |
+| `testing.testcoveragetarget`      | covers     | BusinessProcess  | "Fulfillment Workflow" target covers "Order Fulfillment" |
 
 ---
 
@@ -369,7 +406,7 @@ dr add business service "Order Management Service" \
 
 # Link to motivation layer
 dr relationship add business.businessservice.order-management-service \
-  motivation.goal.improve-order-efficiency --predicate supports
+  motivation.goal.improve-order-efficiency --predicate realizes
 ```
 
 ### Step 3: Model Business Processes
@@ -386,12 +423,10 @@ dr add business process "Pick Items Process" \
 dr add business process "Pack Order Process" \
   --description "Pack picked items for shipment"
 
-# Composition relationships
+# The catalog has no process-to-process composition; link sub-processes
+# in sequence with flows-to, and tie the main process to the service it realizes
 dr relationship add business.businessprocess.order-fulfillment-process \
-  business.businessprocess.pick-items-process --predicate composes
-
-dr relationship add business.businessprocess.order-fulfillment-process \
-  business.businessprocess.pack-order-process --predicate composes
+  business.businessservice.order-management-service --predicate realizes
 
 # Process flows
 dr relationship add business.businessprocess.pick-items-process \
@@ -434,17 +469,17 @@ dr relationship add business.businessevent.order-received \
 ### Step 6: Establish Cross-Layer Relationships
 
 ```bash
-# Link to application layer
-dr relationship add business.businessservice.order-management-service \
-  application.applicationservice.order-api --predicate realized-by
+# Application service realizes the business service (source is the realizer)
+dr relationship add application.applicationservice.order-api \
+  business.businessservice.order-management-service --predicate realizes
 
 # Link to motivation layer
 dr relationship add business.businessservice.order-management-service \
   motivation.value.customer-satisfaction --predicate delivers
 
-# Link to data layer
-dr relationship add business.businessobject.order \
-  data-model.objectschema.order --predicate defined-by
+# Data-model schema realizes the business object
+dr relationship add data-model.objectschema.order \
+  business.businessobject.order --predicate realizes
 ```
 
 ### Step 7: Validate
@@ -462,38 +497,38 @@ dr validate --relationships
 
 ```
 Product: "E-commerce Platform"
-├── composes → BusinessService: "Order Service"
+├── aggregates → BusinessService: "Order Service"
 │   ├── realizes ← BusinessProcess: "Order Fulfillment"
 │   │   ├── triggers ← BusinessEvent: "Order Received"
 │   │   ├── accesses → BusinessObject: "Order"
-│   │   └── assigned-to → BusinessRole: "Order Processor"
-│   └── realized-by → ApplicationService: "OrderManagementAPI"
-├── composes → BusinessService: "Payment Service"
+│   │   └── assigned-to ← BusinessRole: "Order Processor"
+│   └── realizes ← ApplicationService: "OrderManagementAPI"
+├── aggregates → BusinessService: "Payment Service"
 │   └── realizes ← BusinessProcess: "Payment Processing"
-└── aggregates → Contract: "E-commerce SLA"
+└── composes → Contract: "E-commerce SLA"
 ```
 
 ### Scenario 2: Customer Support System
 
 ```
 BusinessFunction: "Customer Support"
-├── composes → BusinessProcess: "Ticket Resolution"
+├── flows-to → BusinessProcess: "Ticket Resolution"
 │   ├── triggers ← BusinessEvent: "Support Request Received"
-│   ├── assigned-to → BusinessRole: "Support Agent"
+│   ├── assigned-to ← BusinessRole: "Support Agent"
 │   ├── accesses → BusinessObject: "Support Ticket"
 │   └── flows-to → BusinessProcess: "Follow-up Communication"
 ├── realizes → BusinessService: "Support Service"
 │   ├── serves → BusinessActor: "Customer"
 │   └── properties: sla-response-time=2h, sla-resolution-time=24h
-└── tracked-by → BusinessMetric: "First Response Time"
+└── monitors ← apm.MetricInstrument: "First Response Time"
 ```
 
 ### Scenario 3: Sales Pipeline
 
 ```
 BusinessCollaboration: "Sales Team"
-├── composes → BusinessRole: "Sales Representative"
-├── composes → BusinessRole: "Sales Manager"
+├── aggregates → BusinessRole: "Sales Representative"
+├── aggregates → BusinessRole: "Sales Manager"
 └── assigned-to → BusinessInteraction: "Sales Meeting"
     ├── accesses → BusinessObject: "Opportunity"
     ├── flows-to → BusinessProcess: "Proposal Generation"
@@ -560,7 +595,7 @@ dr export archimate --layers business --output business.archimate
 ## Best Practices
 
 1. **Start with Services, Not Processes** - Identify WHAT the business provides before HOW it's delivered
-2. **Use Process Composition** - Break complex processes into manageable sub-processes
+2. **Decompose Processes** - Break complex processes into sub-processes linked in sequence with `flows-to`
 3. **Model Events Explicitly** - Event-driven architectures need explicit BusinessEvent entities
 4. **Link to Motivation Early** - Connect services and processes to goals for traceability
 5. **Don't Over-Detail** - Focus on architecturally significant processes, not every task
@@ -573,14 +608,14 @@ dr export archimate --layers business --output business.archimate
 
 ## Validation Tips
 
-| Issue                        | Cause                                        | Fix                                           |
-| ---------------------------- | -------------------------------------------- | --------------------------------------------- |
-| Orphaned Process             | No event triggers it, no service realizes it | Add triggering event or link to service       |
-| Unrealized Service           | No process/function realizes the service     | Add process that implements the service       |
-| Missing Business Objects     | Processes don't access any objects           | Identify key domain concepts and add them     |
-| No Cross-Layer Relationships | Business not linked to application/data      | Add realization relationships to lower layers |
-| Unassigned Roles             | Roles not assigned to processes              | Assign roles to show responsibility           |
-| Missing SLA Properties       | Services lack performance targets            | Add SLA properties for monitoring             |
+| Issue                        | Cause                                        | Fix                                         |
+| ---------------------------- | -------------------------------------------- | ------------------------------------------- |
+| Orphaned Process             | No event triggers it, no service realizes it | Add triggering event or link to service     |
+| Unrealized Service           | No process/function realizes the service     | Add process that implements the service     |
+| Missing Business Objects     | Processes don't access any objects           | Identify key domain concepts and add them   |
+| No Cross-Layer Relationships | Business not linked to application/data      | Add realizes from application/data elements |
+| Unassigned Roles             | Roles not assigned to processes              | Assign roles to show responsibility         |
+| Missing SLA Properties       | Services lack performance targets            | Add SLA properties for monitoring           |
 
 ---
 
@@ -609,12 +644,14 @@ dr relationship add <source> <target> --predicate triggers
 dr relationship add <source> <target> --predicate flows-to
 dr relationship add <source> <target> --predicate accesses
 dr relationship add <source> <target> --predicate serves
+dr relationship add <source> <target> --predicate aggregates
 ```
 
 **Cross-Layer Relationship Commands:**
 
 ```bash
-dr relationship add <business-service> <motivation-goal> --predicate supports
-dr relationship add <business-service> <application-service> --predicate realized-by
-dr relationship add <business-object> <data-schema> --predicate defined-by
+dr relationship add <business-service> <motivation-goal> --predicate realizes
+dr relationship add <business-service> <motivation-value> --predicate delivers
+dr relationship add <application-service> <business-service> --predicate realizes
+dr relationship add <data-model-objectschema> <business-object> --predicate realizes
 ```