Architecture Definition Document

The primary ArchiMate deliverable documenting the target architecture across business, application, and technology layers. Covers organizational structure, application landscape, technology infrastructure, and cross-layer dependencies. Aligned with TOGAF Architecture Definition Document.

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

Required Viewpoints: Organization BusinessProcessCooperation ApplicationCooperation TechnologyVP Layered ImplementationDeployment

Target Purposes: Designing, Informing

Available Formats: MarkdownFormat, HTMLFormat, PDFFormat

Sections

1 1. Business Organization

Organizational structure — actors, roles, collaborations.

Viewpoint: Organization Result key: businessOrganization

SPARQL Query

PREFIX am:   <https://meta.linked.archi/archimate3/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 {
        am:BusinessActor am:BusinessRole am:BusinessCollaboration
        am:BusinessInterface am:Location
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am:assignedTo ?target .
        ?target skos:prefLabel ?assignedTo .
        FILTER(lang(?assignedTo) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?type ?label

2 2. Business Process Cooperation

Process interactions, information exchange, application support.

Viewpoint: BusinessProcessCooperation Result key: businessProcessCooperation

SPARQL Query

PREFIX am:   <https://meta.linked.archi/archimate3/onto#>
PREFIX arch: <https://meta.linked.archi/core#>
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 {
        am:BusinessProcess am:BusinessFunction am:BusinessInteraction
        am:BusinessEvent am:BusinessService am:BusinessObject
        am:ApplicationService am:ApplicationComponent
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am:flowsTo ?ft .
        ?ft skos:prefLabel ?flowsTo .
        FILTER(lang(?flowsTo) = "en")
    }
    OPTIONAL {
        ?element am:serves ?sv .
        ?sv skos:prefLabel ?serves .
        FILTER(lang(?serves) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?type ?label

3 3. Application Cooperation

Application components, interfaces, data flows.

Viewpoint: ApplicationCooperation Result key: applicationCooperation

SPARQL Query

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

SELECT ?element ?label ?type ?description ?flowsTo ?serves ?accesses WHERE {
    ?element a ?type ;
             skos:prefLabel ?label .
    VALUES ?type {
        am:ApplicationComponent am:ApplicationCollaboration
        am:ApplicationInterface am:ApplicationFunction
        am:ApplicationInteraction am:ApplicationProcess
        am:ApplicationEvent am:ApplicationService am:DataObject
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am:flowsTo ?ft .
        ?ft skos:prefLabel ?flowsTo .
        FILTER(lang(?flowsTo) = "en")
    }
    OPTIONAL {
        ?element am:serves ?sv .
        ?sv skos:prefLabel ?serves .
        FILTER(lang(?serves) = "en")
    }
    OPTIONAL {
        ?element am:accesses ?ac .
        ?ac skos:prefLabel ?accesses .
        FILTER(lang(?accesses) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?type ?label

4 4. Technology Infrastructure

Nodes, devices, system software, networks.

Viewpoint: TechnologyVP Result key: technologyInfrastructure

SPARQL Query

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

SELECT ?element ?label ?type ?description ?assignedTo ?serves WHERE {
    ?element a ?type ;
             skos:prefLabel ?label .
    VALUES ?type {
        am:Node am:Device am:SystemSoftware am:TechnologyCollaboration
        am:TechnologyInterface am:Path am:CommunicationNetwork
        am:TechnologyFunction am:TechnologyProcess
        am:TechnologyInteraction am:TechnologyEvent
        am:TechnologyService am:Artifact
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am:assignedTo ?at .
        ?at skos:prefLabel ?assignedTo .
        FILTER(lang(?assignedTo) = "en")
    }
    OPTIONAL {
        ?element am:serves ?sv .
        ?sv skos:prefLabel ?serves .
        FILTER(lang(?serves) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?type ?label

5 5. Cross-Layer Overview

Layered view showing serving and realization across all layers.

Viewpoint: Layered Result key: crossLayerOverview

SPARQL Query

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

SELECT ?source ?sourceLabel ?sourceLayer ?relType ?target ?targetLabel ?targetLayer WHERE {
    {
        ?source am:serves ?target .
        BIND("serves" AS ?relType)
    } UNION {
        ?source am:realizes ?target .
        BIND("realizes" AS ?relType)
    }
    ?source skos:prefLabel ?sourceLabel .
    ?target skos:prefLabel ?targetLabel .
    ?source a/rdfs:subClassOf* ?srcLayerClass .
    ?target a/rdfs:subClassOf* ?tgtLayerClass .
    VALUES (?srcLayerClass ?sourceLayer) {
        (am:BusinessLayerElement "Business")
        (am:ApplicationLayerElement "Application")
        (am:TechnologyLayerElement "Technology")
        (am:PhysicalLayerElement "Physical")
        (am:StrategyLayerElement "Strategy")
        (am:ImplementationAndMigrationLayerElement "Implementation & Migration")
    }
    VALUES (?tgtLayerClass ?targetLayer) {
        (am:BusinessLayerElement "Business")
        (am:ApplicationLayerElement "Application")
        (am:TechnologyLayerElement "Technology")
        (am:PhysicalLayerElement "Physical")
        (am:StrategyLayerElement "Strategy")
        (am:ImplementationAndMigrationLayerElement "Implementation & Migration")
    }
    FILTER(?sourceLayer != ?targetLayer)
    FILTER(lang(?sourceLabel) = "en")
    FILTER(lang(?targetLabel) = "en")
} ORDER BY ?sourceLayer ?relType ?targetLayer

6 6. Implementation & Deployment

Artifact deployment on technology infrastructure.

Viewpoint: ImplementationDeployment Result key: implementationDeployment

SPARQL Query

PREFIX am:   <https://meta.linked.archi/archimate3/onto#>
PREFIX arch: <https://meta.linked.archi/core#>
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 {
        am:WorkPackage am:Deliverable am:ImplementationEvent
        am:Plateau am:Gap am:Artifact am:Node am:Device
        am:SystemSoftware
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?element am:realizes ?rl .
        ?rl skos:prefLabel ?realizes .
        FILTER(lang(?realizes) = "en")
    }
    OPTIONAL {
        ?element am: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 3.2 |

---

## 1. Business Organization

Organizational structure — actors, roles, collaborations.

{{#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}}

---

## 2. Business Process Cooperation

Process interactions, information exchange, application support.

{{#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}}

### Information Flows

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

---

## 3. Application Cooperation

Application components, interfaces, data flows.

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

### Application Components

| Component | Description | Layer | Technology |
|-----------|-------------|-------|------------|
{{#each elements.applicationComponents}}
| {{this.label}} | {{this.description}} | {{this.layer}} | {{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 Flows

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

---

## 4. Technology Infrastructure

Nodes, devices, system software, networks.

{{#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}}

---

## 5. Cross-Layer Overview

Layered view showing serving and realization across all layers.

{{#if views.layered.diagram}}
![Layered View]({{views.layered.diagram}})
{{/if}}

### Layer Summary

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

### Cross-Layer Relationships

| Source (Layer) | Relationship | Target (Layer) |
|----------------|-------------|----------------|
{{#each relationships.crossLayer}}
| {{this.source}} ({{this.sourceLayer}}) | {{this.type}} | {{this.target}} ({{this.targetLayer}}) |
{{/each}}

---

## 6. Implementation & Deployment

Artifact deployment on technology infrastructure.

{{#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}}

### Deployment Mapping

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

---

## Appendix A: Element Inventory

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

## Appendix B: Relationship Inventory

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

Architecture Requirements Specification

Documents the architecture requirements derived from stakeholder concerns, goals, and constraints. Traces requirements to the architecture elements that realize them.

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 3.2 |

---

## 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 | Layer |
|-------------|-------------------|-------------|-------|
{{#each relationships.realization}}
| {{this.requirement}} | {{this.element}} | {{this.elementType}} | {{this.layer}} |
{{/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 the architecture principles that guide design decisions. Includes principle validation results from the principle shapes.

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 3.2 |

---

## 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 3.2 Deliverable Templates

Architecture Definition Document

Sections

Architecture Requirements Specification

Architecture Principles Document

TTL Source

JSON-LD