# Architecture Decision Records

> A formal definition of one architecture decision, recording its context, the choice made and its consequences.

Record: `architecture:architecture-decision-records`
Kind: artifact
Layer: [Evolution Principles](https://banes-lab.com/records/layer/evolution-principles.md)
Severity: recommended
Scope: architecture decision
Aliases: ADRs
Canonical: https://banes-lab.com/ontology#architecture-architecture-decision-records

Listed in [Architecture principles](https://banes-lab.com/api/records/architecture.md), after [Quality Attributes](https://banes-lab.com/records/architecture/quality-attributes.md) and before [Evolutionary Architecture](https://banes-lab.com/records/architecture/evolutionary-architecture.md).

## Repair

- Refactored by: Add ADR, Link to Change
- Detected by: architecture change without ADR
- Violated by: major decision not recorded
- Measured by: ADR coverage
- Enforced by: PR template, review policy

## Requires

- [Context](https://banes-lab.com/records/lexicon/context.md)
- [Decision](https://banes-lab.com/records/lexicon/decision.md)
- [Consequences](https://banes-lab.com/records/lexicon/consequences.md)

## Reinforces

- [Traceability](https://banes-lab.com/records/architecture/traceability.md)
- [Governance](https://banes-lab.com/records/architecture/governance.md)

## Enables

- [Decision History](https://banes-lab.com/records/lexicon/decision-history.md)

## Conflicts with

- [Tribal Knowledge](https://banes-lab.com/records/lexicon/tribal-knowledge.md)

## In tension with

- [Documentation Maintenance](https://banes-lab.com/records/lexicon/documentation-maintenance.md)

## Tensions

- [Architecture Decision Records (ADR) / Documentation Maintenance](https://banes-lab.com/records/tension/architecture-decision-records-adr-documentation-maintenance.md)

## Severity

- [recommended](https://banes-lab.com/records/vocabulary/severity-recommended.md)

## Category

- [Architecture Review / Evolution / Governance Artifacts](https://banes-lab.com/records/architecture-category/architecture-review-evolution-governance-artifacts.md)

## Required by

- [Architecture Review](https://banes-lab.com/records/architecture/architecture-review.md)

## Linked from

- [Rules with names](https://banes-lab.com/disciplined-methodology/start/rules-with-names.md)
- [The structural domain](https://banes-lab.com/software-architecture/principles/the-structural-domain.md)
- [A cell that resists an invariant](https://banes-lab.com/software-architecture/coverage/a-cell-that-resists-an-invariant.md)
- [Architecture Review / Evolution / Governance Artifacts](https://banes-lab.com/ontology/principles/architecture-category-architecture-review-evolution-governance-artifacts.md)
- [Observability / Auditability / Traceability](https://banes-lab.com/ontology/principles/architecture-category-observability-auditability-traceability.md)
- [Security / Privacy / Compliance / Governance](https://banes-lab.com/ontology/principles/architecture-category-security-privacy-compliance-governance.md)
- [Architecture Review Evolution Governance](https://banes-lab.com/ontology/lexicon/lexicon-category-architecture-review-evolution-governance.md)
- [Core Vocabulary](https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md)
- [Severity levels](https://banes-lab.com/ontology/schema/the-vocabulary-severity.md)
- [The resolutions](https://banes-lab.com/ontology/schema/the-resolutions.md)