Linked.Archi Core Deliverable Templates
type: Ontology
imports: core#
imports: core-viewpoints#
license: http://creativecommons.org/licenses/by/4.0/
preferred namespace prefix: archdt
creator: Kalin Maldzhanski
description: Framework-agnostic deliverable templates that define the content structure of common architecture documents. Each template specifies which viewpoints are required — the actual views are created when someone instantiates the template into a concrete deliverable (arch:Model). These templates reference core viewpoints. Framework-specific templates (e.g., TOGAF Architecture Definition Document) should be defined in the respective framework's file, referencing framework-specific viewpoints.
created: 2026-04-15
modified: 2026-04-15
publisher: Linked.Archi
publisher: linked.archi
status: draft
version IRI: 0.1.0#
version info: 0.1.0

Markdown Document
type: PresentationFormat
definition: Renders the deliverable as a Markdown document with headings per section, embedded diagrams as images, and tables for catalogs and matrices. Suitable for Git-based documentation workflows (MkDocs, Docusaurus, Jekyll).
template resource: templates/deliverable.md.hbs
generator command: handlebars render --template deliverable.md.hbs

HTML Report
type: PresentationFormat
definition: Renders the deliverable as a standalone HTML page with interactive navigation, collapsible sections, and embedded SVG diagrams. Suitable for intranet publishing and stakeholder portals.
template resource: templates/deliverable.html.j2
generator command: python generate.py --format html --template deliverable.html.j2

PDF Document
type: PresentationFormat
definition: Renders the deliverable as a paginated PDF with formal layout, headers/footers, table of contents, and print-ready diagrams. Suitable for governance submissions, audits, and formal sign-off.
template resource: templates/deliverable.tex
generator command: python generate.py --format pdf --template deliverable.tex

Slide Deck
type: PresentationFormat
definition: Renders the deliverable as a presentation slide deck with one section per slide or slide group. Diagrams are simplified for projection. Suitable for architecture review boards and stakeholder briefings.
template resource: templates/deliverable.pptx
generator command: python generate.py --format pptx --template deliverable.pptx

Interactive Dashboard
type: PresentationFormat
definition: Renders the deliverable as an interactive web dashboard with filterable views, drill-down navigation, and live data from the knowledge graph. Suitable for continuous architecture monitoring and portfolio management.
template resource: templates/dashboard.d3.js
generator command: python generate.py --format dashboard --template dashboard.d3.js

1. Architecture Landscape
type: TemplateSection
section order: 1
section viewpoint: LandscapeOverview
definition: High-level overview of the architecture showing major components and domains.

2. Stakeholder Analysis
type: TemplateSection
section order: 2
section viewpoint: StakeholderMap
definition: Map stakeholders to their concerns and the viewpoints that address them.

3. Component Inventory
type: TemplateSection
section order: 3
section viewpoint: ComponentCatalog
definition: Catalog of all architecture components with key attributes.

4. Dependency Analysis
type: TemplateSection
section order: 4
section viewpoint: DependencyMatrix
definition: Matrix showing dependencies between components for impact analysis.

5. Standards Compliance
type: TemplateSection
section order: 5
section viewpoint: StandardsCompliance
definition: Assessment of component compliance with applicable standards.

1. Solution Context
type: TemplateSection
section order: 1
section viewpoint: LandscapeOverview
definition: Overview of the solution within the broader architecture landscape.

2. Process Design
type: TemplateSection
section order: 2
section viewpoint: ProcessFlow
definition: Process flows showing activities, decision points, and handoffs.

3. Interface Design
type: TemplateSection
section order: 3
section viewpoint: InterfaceMap
definition: Interface map showing component connections, protocols, and data flows.

4. Deployment Design
type: TemplateSection
section order: 4
section viewpoint: DeploymentMap
definition: Deployment map showing where components run and hosting relationships.

5. Architecture Decisions
type: TemplateSection
section order: 5
section viewpoint: DecisionLog
definition: Log of architecture decisions with context, rationale, and status.

1. Impact Analysis
type: TemplateSection
section order: 1
section viewpoint: ImpactAnalysis
definition: Propagation of change through dependencies — what breaks if this changes.

2. Dependency Assessment
type: TemplateSection
section order: 2
section viewpoint: DependencyMatrix
definition: Full dependency matrix for the affected components.

3. Gap Analysis
type: TemplateSection
section order: 3
section viewpoint: GapAnalysis
definition: Differences between current and target state after the change.

4. Migration Roadmap
type: TemplateSection
section order: 4
section viewpoint: Roadmap
definition: Planned evolution steps to implement the change.

Architecture Overview Document
type: DeliverableTemplate
definition: A high-level architecture document providing stakeholders with an overview of the architecture landscape, component inventory, dependencies, and standards compliance. Suitable for governance reviews and onboarding.
template requires viewpoint: LandscapeOverview
template requires viewpoint: StakeholderMap
template requires viewpoint: ComponentCatalog
template requires viewpoint: DependencyMatrix
template requires viewpoint: StandardsCompliance
template has section: 1. Architecture Landscape
template has section: 2. Stakeholder Analysis
template has section: 3. Component Inventory
template has section: 4. Dependency Analysis
template has section: 5. Standards Compliance
template targets purpose: Informing
template targets purpose: Governing
template has format: Markdown Document
template has format: HTML Report
template has format: PDF Document

Solution Design Document
type: DeliverableTemplate
definition: A solution-level architecture document covering process design, interface design, deployment topology, and architecture decisions. Used by solution architects and development teams during design and implementation.
template requires viewpoint: LandscapeOverview
template requires viewpoint: ProcessFlow
template requires viewpoint: InterfaceMap
template requires viewpoint: DeploymentMap
template requires viewpoint: DecisionLog
template has section: 1. Solution Context
template has section: 2. Process Design
template has section: 3. Interface Design
template has section: 4. Deployment Design
template has section: 5. Architecture Decisions
template targets purpose: Designing
template has format: Markdown Document
template has format: HTML Report

Change Impact Assessment
type: DeliverableTemplate
definition: An assessment document for evaluating the impact of a proposed architecture change. Covers impact propagation, dependency analysis, gap analysis, and migration planning. Used for change governance and decision-making.
template requires viewpoint: ImpactAnalysis
template requires viewpoint: DependencyMatrix
template requires viewpoint: GapAnalysis
template requires viewpoint: Roadmap
template has section: 1. Impact Analysis
template has section: 2. Dependency Assessment
template has section: 3. Gap Analysis
template has section: 4. Migration Roadmap
template targets purpose: Deciding
template targets purpose: Governing
template has format: Markdown Document
template has format: PDF Document
template has format: Slide Deck