Architecture Definition Document

The primary ArchiMate 4.0 deliverable documenting the target architecture across business, application, and technology domains. Uses the domain-based structure of ArchiMate 4.0 with merged cross-domain behavior elements.

Template: templates/architecture-definition-document.md.hbs

Required Viewpoints: Organization ProcessCooperationVP ApplicationStructureVP TechnologyVP LayeredVP ImplementationDeploymentVP

Target Purposes: Designing, Informing

Available Formats: MarkdownFormat, HTMLFormat, PDFFormat

Sections

1 1. Business Domain

Business actors, roles, collaborations, and organizational structure.

Viewpoint: Organization Result key: businessDomain

SPARQL Query

PREFIX am4:  <https://meta.linked.archi/archimate4/onto#>
PREFIX arch: <https://meta.linked.archi/core#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>

SELECT ?element ?label ?type ?description ?assignedTo WHERE {
    ?element a ?type ; skos:prefLabel ?label .
    VALUES ?type {
        am4:BusinessActor am4:Role am4:Collaboration
        am4:BusinessInterface am4:Location
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am4:assignedTo ?target .
        ?target skos:prefLabel ?assignedTo .
        FILTER(lang(?assignedTo) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?type ?label

2 2. Process Cooperation

Cross-domain processes, functions, events, services, and their interactions.

Viewpoint: ProcessCooperationVP Result key: processCooperation

SPARQL Query

PREFIX am4:  <https://meta.linked.archi/archimate4/onto#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>

SELECT ?element ?label ?type ?description ?flowsTo ?serves WHERE {
    ?element a ?type ; skos:prefLabel ?label .
    VALUES ?type {
        am4:Process am4:Function am4:Event am4:Service
        am4:BusinessObject am4:DataObject
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am4:flowsTo ?ft .
        ?ft skos:prefLabel ?flowsTo .
        FILTER(lang(?flowsTo) = "en")
    }
    OPTIONAL {
        ?element am4:serves ?sv .
        ?sv skos:prefLabel ?serves .
        FILTER(lang(?serves) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?type ?label

3 3. Application Domain

Application components, interfaces, and data objects.

Viewpoint: ApplicationStructureVP Result key: applicationDomain

SPARQL Query

PREFIX am4:  <https://meta.linked.archi/archimate4/onto#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>

SELECT ?element ?label ?type ?description ?serves ?accesses WHERE {
    ?element a ?type ; skos:prefLabel ?label .
    VALUES ?type {
        am4:ApplicationComponent am4:ApplicationInterface am4:DataObject
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am4:serves ?sv .
        ?sv skos:prefLabel ?serves .
        FILTER(lang(?serves) = "en")
    }
    OPTIONAL {
        ?element am4:accesses ?ac .
        ?ac skos:prefLabel ?accesses .
        FILTER(lang(?accesses) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?type ?label

4 4. Technology Domain

Nodes, devices, system software, networks, equipment, facilities.

Viewpoint: TechnologyVP Result key: technologyDomain

SPARQL Query

PREFIX am4:  <https://meta.linked.archi/archimate4/onto#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>

SELECT ?element ?label ?type ?description ?assignedTo WHERE {
    ?element a ?type ; skos:prefLabel ?label .
    VALUES ?type {
        am4:Node am4:Device am4:SystemSoftware am4:Path
        am4:CommunicationNetwork am4:DistributionNetwork
        am4:Equipment am4:Facility am4:TechnologyInterface
        am4:Artifact am4:Material
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am4:assignedTo ?at .
        ?at skos:prefLabel ?assignedTo .
        FILTER(lang(?assignedTo) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?type ?label

5 5. Cross-Domain Overview

Cross-domain serving and realization relationships.

Viewpoint: LayeredVP Result key: crossDomainOverview

SPARQL Query

PREFIX am4:  <https://meta.linked.archi/archimate4/onto#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>

SELECT ?source ?sourceLabel ?relType ?target ?targetLabel WHERE {
    {
        ?source am4:serves ?target .
        BIND("serves" AS ?relType)
    } UNION {
        ?source am4:realizes ?target .
        BIND("realizes" AS ?relType)
    }
    ?source skos:prefLabel ?sourceLabel .
    ?target skos:prefLabel ?targetLabel .
    FILTER(lang(?sourceLabel) = "en")
    FILTER(lang(?targetLabel) = "en")
} ORDER BY ?relType ?sourceLabel

6 6. Implementation & Deployment

Work packages, deliverables, plateaus, and artifact deployment.

Viewpoint: ImplementationDeploymentVP Result key: implementationDeployment

SPARQL Query

PREFIX am4:  <https://meta.linked.archi/archimate4/onto#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>

SELECT ?element ?label ?type ?description ?realizes ?deployedOn WHERE {
    ?element a ?type ; skos:prefLabel ?label .
    VALUES ?type {
        am4:WorkPackage am4:Deliverable am4:Plateau
        am4:Artifact am4:Node am4:Device am4:SystemSoftware
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am4:realizes ?rl .
        ?rl skos:prefLabel ?realizes .
        FILTER(lang(?realizes) = "en")
    }
    OPTIONAL {
        ?element am4:assignedTo ?dep .
        ?dep skos:prefLabel ?deployedOn .
        FILTER(lang(?deployedOn) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?type ?label

📄 Template Preview

---
title: "Architecture Definition Document"
date: "{{meta.date}}"
author: "{{meta.author}}"
status: "{{meta.status}}"
version: "{{meta.version}}"
---

# Architecture Definition Document

{{#if meta.description}}
> {{meta.description}}
{{/if}}

| Property | Value |
|----------|-------|
| Date | {{meta.date}} |
| Author | {{meta.author}} |
| Status | {{meta.status}} |
| Version | {{meta.version}} |
| Metamodel | ArchiMate 4.0 |

---

## 1. Business Domain

Organizational structure, business behavior, and business passive elements.

{{#if views.organization.diagram}}
![Organization View]({{views.organization.diagram}})
{{/if}}

### Business Actors

| Actor | Description |
|-------|-------------|
{{#each elements.businessActors}}
| {{this.label}} | {{this.description}} |
{{/each}}

### Business Roles

| Role | Description | Assigned To |
|------|-------------|-------------|
{{#each elements.businessRoles}}
| {{this.label}} | {{this.description}} | {{this.assignedTo}} |
{{/each}}

### Business Collaborations

| Collaboration | Description | Participants |
|---------------|-------------|--------------|
{{#each elements.businessCollaborations}}
| {{this.label}} | {{this.description}} | {{this.participants}} |
{{/each}}

{{#if views.businessProcessCooperation.diagram}}
![Business Process Cooperation View]({{views.businessProcessCooperation.diagram}})
{{/if}}

### Business Processes

| Process | Description | Triggers | Services Used |
|---------|-------------|----------|---------------|
{{#each elements.businessProcesses}}
| {{this.label}} | {{this.description}} | {{this.triggers}} | {{this.servicesUsed}} |
{{/each}}

### Business Services

| Service | Description | Realized By |
|---------|-------------|-------------|
{{#each elements.businessServices}}
| {{this.label}} | {{this.description}} | {{this.realizedBy}} |
{{/each}}

### Business Objects

| Object | Description |
|--------|-------------|
{{#each elements.businessObjects}}
| {{this.label}} | {{this.description}} |
{{/each}}

### Information Flows

| From | To | Description |
|------|----|-------------|
{{#each relationships.businessFlows}}
| {{this.source}} | {{this.target}} | {{this.description}} |
{{/each}}

---

## 2. Application Domain

Application components, interfaces, services, and data objects.

{{#if views.applicationCooperation.diagram}}
![Application Cooperation View]({{views.applicationCooperation.diagram}})
{{/if}}

### Application Components

| Component | Description | Domain | Technology |
|-----------|-------------|--------|------------|
{{#each elements.applicationComponents}}
| {{this.label}} | {{this.description}} | {{this.domain}} | {{this.technology}} |
{{/each}}

### Application Interfaces

| Interface | Description | Exposed By | Protocol |
|-----------|-------------|------------|----------|
{{#each elements.applicationInterfaces}}
| {{this.label}} | {{this.description}} | {{this.exposedBy}} | {{this.protocol}} |
{{/each}}

### Application Services

| Service | Description | Provided By | Consumed By |
|---------|-------------|-------------|-------------|
{{#each elements.applicationServices}}
| {{this.label}} | {{this.description}} | {{this.providedBy}} | {{this.consumedBy}} |
{{/each}}

### Data Objects

| Data Object | Description | Accessed By |
|-------------|-------------|-------------|
{{#each elements.dataObjects}}
| {{this.label}} | {{this.description}} | {{this.accessedBy}} |
{{/each}}

### Data Flows

| From | To | Data Object | Access Type |
|------|----|-------------|-------------|
{{#each relationships.applicationFlows}}
| {{this.source}} | {{this.target}} | {{this.dataObject}} | {{this.accessType}} |
{{/each}}

---

## 3. Technology Domain

Nodes, devices, system software, networks, and communication paths.

{{#if views.technology.diagram}}
![Technology View]({{views.technology.diagram}})
{{/if}}

### Nodes & Devices

| Node | Type | Description | Location |
|------|------|-------------|----------|
{{#each elements.technologyNodes}}
| {{this.label}} | {{this.type}} | {{this.description}} | {{this.location}} |
{{/each}}

### System Software

| Software | Description | Deployed On |
|----------|-------------|-------------|
{{#each elements.systemSoftware}}
| {{this.label}} | {{this.description}} | {{this.deployedOn}} |
{{/each}}

### Networks & Communication Paths

| Path | From | To | Description |
|------|------|----|-------------|
{{#each elements.communicationPaths}}
| {{this.label}} | {{this.from}} | {{this.to}} | {{this.description}} |
{{/each}}

---

## 4. Common Domain

Shared behavior elements used across domains — services, processes, functions, events, capabilities, and value streams.

{{#if views.commonDomain.diagram}}
![Common Domain View]({{views.commonDomain.diagram}})
{{/if}}

### Services

| Service | Description | Domain Context | Realized By |
|---------|-------------|----------------|-------------|
{{#each elements.commonServices}}
| {{this.label}} | {{this.description}} | {{this.domainContext}} | {{this.realizedBy}} |
{{/each}}

### Processes

| Process | Description | Domain Context | Triggers |
|---------|-------------|----------------|----------|
{{#each elements.commonProcesses}}
| {{this.label}} | {{this.description}} | {{this.domainContext}} | {{this.triggers}} |
{{/each}}

### Functions

| Function | Description | Domain Context | Performed By |
|----------|-------------|----------------|--------------|
{{#each elements.commonFunctions}}
| {{this.label}} | {{this.description}} | {{this.domainContext}} | {{this.performedBy}} |
{{/each}}

### Events

| Event | Description | Domain Context | Triggers |
|-------|-------------|----------------|----------|
{{#each elements.commonEvents}}
| {{this.label}} | {{this.description}} | {{this.domainContext}} | {{this.triggers}} |
{{/each}}

### Capabilities

| Capability | Description | Realized By |
|------------|-------------|-------------|
{{#each elements.capabilities}}
| {{this.label}} | {{this.description}} | {{this.realizedBy}} |
{{/each}}

### Value Streams

| Value Stream | Description | Stages |
|-------------|-------------|--------|
{{#each elements.valueStreams}}
| {{this.label}} | {{this.description}} | {{this.stages}} |
{{/each}}

---

## 5. Cross-Domain Overview

Relationships spanning multiple domains — serving, realization, and composition.

{{#if views.crossDomain.diagram}}
![Cross-Domain View]({{views.crossDomain.diagram}})
{{/if}}

### Domain Summary

| Domain | Element Count | Key Elements |
|--------|---------------|--------------|
{{#each domains}}
| {{this.name}} | {{this.count}} | {{this.keyElements}} |
{{/each}}

### Cross-Domain Relationships

| Source (Domain) | Relationship | Target (Domain) |
|-----------------|-------------|-----------------|
{{#each relationships.crossDomain}}
| {{this.source}} ({{this.sourceDomain}}) | {{this.type}} | {{this.target}} ({{this.targetDomain}}) |
{{/each}}

---

## 6. Implementation & Deployment

Artifact deployment on technology infrastructure, work packages, and migration planning.

{{#if views.implementationDeployment.diagram}}
![Implementation & Deployment View]({{views.implementationDeployment.diagram}})
{{/if}}

### Artifacts

| Artifact | Description | Realizes |
|----------|-------------|----------|
{{#each elements.artifacts}}
| {{this.label}} | {{this.description}} | {{this.realizes}} |
{{/each}}

### Work Packages

| Work Package | Description | Delivers |
|-------------|-------------|----------|
{{#each elements.workPackages}}
| {{this.label}} | {{this.description}} | {{this.delivers}} |
{{/each}}

### Deployment Mapping

| Artifact | Deployed On | Environment |
|----------|-------------|-------------|
{{#each deployments}}
| {{this.artifact}} | {{this.node}} | {{this.environment}} |
{{/each}}

---

## Appendix A: Element Inventory

| Element | Type | Domain | Description |
|---------|------|--------|-------------|
{{#each allElements}}
| {{this.label}} | {{this.type}} | {{this.domain}} | {{this.description}} |
{{/each}}

## Appendix B: Relationship Inventory

| Source | Relationship | Target |
|--------|-------------|--------|
{{#each allRelationships}}
| {{this.source}} | {{this.type}} | {{this.target}} |
{{/each}}

Architecture Requirements Specification

Documents architecture requirements, goals, and constraints.

Template: templates/architecture-requirements-spec.md.hbs

Required Viewpoints: StakeholderVP GoalRealization RequirementsRealization MotivationVP

Target Purposes: Deciding

Available Formats: MarkdownFormat, PDFFormat

📄 Template Preview

---
title: "Architecture Requirements Specification"
date: "{{meta.date}}"
author: "{{meta.author}}"
status: "{{meta.status}}"
version: "{{meta.version}}"
---

# Architecture Requirements Specification

{{#if meta.description}}
> {{meta.description}}
{{/if}}

| Property | Value |
|----------|-------|
| Date | {{meta.date}} |
| Author | {{meta.author}} |
| Status | {{meta.status}} |
| Version | {{meta.version}} |
| Metamodel | ArchiMate 4.0 |

---

## 1. Stakeholder Analysis

{{#if views.stakeholder.diagram}}
![Stakeholder View]({{views.stakeholder.diagram}})
{{/if}}

### Stakeholders

| Stakeholder | Description | Key Concerns |
|-------------|-------------|--------------|
{{#each elements.stakeholders}}
| {{this.label}} | {{this.description}} | {{this.concerns}} |
{{/each}}

### Stakeholder–Driver Associations

| Stakeholder | Driver | Influence |
|-------------|--------|-----------|
{{#each relationships.stakeholderDrivers}}
| {{this.stakeholder}} | {{this.driver}} | {{this.influence}} |
{{/each}}

---

## 2. Goal Realization

{{#if views.goalRealization.diagram}}
![Goal Realization View]({{views.goalRealization.diagram}})
{{/if}}

### Goals

| Goal | Description | Priority | Measured By |
|------|-------------|----------|-------------|
{{#each elements.goals}}
| {{this.label}} | {{this.description}} | {{this.priority}} | {{this.measuredBy}} |
{{/each}}

### Goal Decomposition

| Parent Goal | Sub-Goal | Relationship |
|-------------|----------|-------------|
{{#each relationships.goalDecomposition}}
| {{this.parent}} | {{this.child}} | {{this.type}} |
{{/each}}

### Goal–Requirement Traceability

| Goal | Requirement | Realized By |
|------|-------------|-------------|
{{#each relationships.goalRequirements}}
| {{this.goal}} | {{this.requirement}} | {{this.realizedBy}} |
{{/each}}

---

## 3. Requirements Realization

{{#if views.requirementsRealization.diagram}}
![Requirements Realization View]({{views.requirementsRealization.diagram}})
{{/if}}

### Requirements

| ID | Requirement | Priority | Status | Realized By |
|----|-------------|----------|--------|-------------|
{{#each elements.requirements}}
| {{this.id}} | {{this.label}} | {{this.priority}} | {{this.status}} | {{this.realizedBy}} |
{{/each}}

### Constraints

| Constraint | Description | Restricts |
|------------|-------------|-----------|
{{#each elements.constraints}}
| {{this.label}} | {{this.description}} | {{this.restricts}} |
{{/each}}

### Realization Matrix

| Requirement | Realizing Element | Element Type | Domain |
|-------------|-------------------|-------------|--------|
{{#each relationships.realization}}
| {{this.requirement}} | {{this.element}} | {{this.elementType}} | {{this.domain}} |
{{/each}}

---

## 4. Motivation Overview

{{#if views.motivation.diagram}}
![Motivation View]({{views.motivation.diagram}})
{{/if}}

### Drivers

| Driver | Description | Source |
|--------|-------------|-------|
{{#each elements.drivers}}
| {{this.label}} | {{this.description}} | {{this.source}} |
{{/each}}

### Assessments

| Assessment | Description | Related Driver |
|------------|-------------|----------------|
{{#each elements.assessments}}
| {{this.label}} | {{this.description}} | {{this.relatedDriver}} |
{{/each}}

### Motivation Chain

| Driver | Assessment | Goal | Requirement | Realizing Element |
|--------|------------|------|-------------|-------------------|
{{#each motivationChains}}
| {{this.driver}} | {{this.assessment}} | {{this.goal}} | {{this.requirement}} | {{this.element}} |
{{/each}}

---

## Appendix: Requirements Traceability Matrix

| Req ID | Requirement | Goal | Stakeholder | Realizing Element | Status |
|--------|-------------|------|-------------|-------------------|--------|
{{#each traceabilityMatrix}}
| {{this.id}} | {{this.requirement}} | {{this.goal}} | {{this.stakeholder}} | {{this.element}} | {{this.status}} |
{{/each}}

Architecture Principles Document

Documents architecture principles and strategy alignment.

Template: templates/architecture-principles-document.md.hbs

Required Viewpoints: MotivationVP StrategyVP

Target Purposes: Governing

Available Formats: MarkdownFormat, PDFFormat

📄 Template Preview

---
title: "Architecture Principles Document"
date: "{{meta.date}}"
author: "{{meta.author}}"
status: "{{meta.status}}"
version: "{{meta.version}}"
---

# Architecture Principles Document

{{#if meta.description}}
> {{meta.description}}
{{/if}}

| Property | Value |
|----------|-------|
| Date | {{meta.date}} |
| Author | {{meta.author}} |
| Status | {{meta.status}} |
| Version | {{meta.version}} |
| Metamodel | ArchiMate 4.0 |

---

## 1. Motivation Context

{{#if views.motivation.diagram}}
![Motivation View]({{views.motivation.diagram}})
{{/if}}

### Drivers

| Driver | Description |
|--------|-------------|
{{#each elements.drivers}}
| {{this.label}} | {{this.description}} |
{{/each}}

### Goals

| Goal | Description | Influenced By |
|------|-------------|---------------|
{{#each elements.goals}}
| {{this.label}} | {{this.description}} | {{this.influencedBy}} |
{{/each}}

---

## 2. Architecture Principles

{{#if views.strategy.diagram}}
![Strategy View]({{views.strategy.diagram}})
{{/if}}

{{#each elements.principles}}
### {{this.label}}

| Attribute | Value |
|-----------|-------|
| Statement | {{this.description}} |
| Rationale | {{this.rationale}} |
| Implications | {{this.implications}} |
| Related Goals | {{this.relatedGoals}} |
| Status | {{this.status}} |

{{#if this.violations}}
**Validation Results:**

| Element | Violation | Severity |
|---------|-----------|----------|
{{#each this.violations}}
| {{this.element}} | {{this.message}} | {{this.severity}} |
{{/each}}
{{/if}}

---

{{/each}}

## 3. Strategic Alignment

### Capabilities

| Capability | Description | Realized By |
|------------|-------------|-------------|
{{#each elements.capabilities}}
| {{this.label}} | {{this.description}} | {{this.realizedBy}} |
{{/each}}

### Value Streams

| Value Stream | Description | Stages |
|-------------|-------------|--------|
{{#each elements.valueStreams}}
| {{this.label}} | {{this.description}} | {{this.stages}} |
{{/each}}

### Courses of Action

| Course of Action | Description | Addresses |
|-----------------|-------------|-----------|
{{#each elements.coursesOfAction}}
| {{this.label}} | {{this.description}} | {{this.addresses}} |
{{/each}}

---

## 4. Principle–Goal Traceability

| Principle | Goal | Driver | Assessment |
|-----------|------|--------|------------|
{{#each traceability}}
| {{this.principle}} | {{this.goal}} | {{this.driver}} | {{this.assessment}} |
{{/each}}

---

## 5. Principle Compliance Summary

| Principle | Compliant | Violations | Warnings |
|-----------|-----------|------------|----------|
{{#each complianceSummary}}
| {{this.principle}} | {{this.compliant}} | {{this.violations}} | {{this.warnings}} |
{{/each}}

Linked.Archi ArchiMate 4.0 Deliverable Templates

Architecture Definition Document

Sections

Architecture Requirements Specification

Architecture Principles Document

TTL Source

JSON-LD