adr.zone

← All templates

ISO 42010 Companion (advanced)

ISO 42010 vocabulary on one page: stakeholders, concerns, views. Companion ADR shape for traceability, not an ISO-standard format.

Last reviewed: .

Format

This companion connects a decision to an architecture description. It is an adr.zone adaptation of ISO 42010 vocabulary, not a template prescribed by ISO or evidence that a document conforms to the standard.

Use it when a decision is inseparable from who is affected, which quality concerns drive it, and which view (e.g. deployment, security) must change. For background, read ISO / IEEE 42010 and decisions.

Connect a concern to a decision

  1. Stakeholder and concern: API owners need faster reads without serving incorrect tenant data.
  2. Viewpoint and view: a runtime viewpoint defines what to describe; a request-flow view shows the cache and authoritative database.
  3. Decision and evidence: record the cache policy, link the request-flow diagram, and identify the failure tests that check it.

See the Redis example in the companion structure and keep the full decision record discoverable in your architecture decision log.

Markdown template
# <short title>

> **ISO 42010 Companion.** Not a standard ADR format or conformity template. Use when an architecture decision needs to connect stakeholders, concerns, views, viewpoints, and traceability.

**Record ID / cross-ref:** <ADR-42010-0001 or your scheme>

## System / subject scope
<what system of interest is described>

## Stakeholders and roles
<who may be affected or who must read this description>

## Stakeholder concerns
<reliability, cost, lawfulness, modifiability, … as relevant to this view>

## View and viewpoint
<name the viewpoint, e.g. security / deployment, and the view, e.g. C4 L2, cluster map>

## Decision
<one clear architecture decision the description must reflect>

## Rationale
<reference alternatives or constraints, tied to the concerns above>

## Architectural impact
<what in the as-built or to-be design changes>

## Traceability
<links: requirements, policies, SLOs, other ADRs>

Open generator with this format preselected (also persisted in local storage on this site).

Compare all ADR formats · Browse worked ADR examples