{
  "code": "ADR",
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-architecture-decision-records",
  "id": "architecture-decision-records",
  "kind": "artifact",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-evolution-principles",
    "json": "https://banes-lab.com/json/records/layer/evolution-principles",
    "label": "Evolution Principles",
    "markdown": "https://banes-lab.com/records/layer/evolution-principles.md",
    "ref": "layer:evolution-principles"
  },
  "name": "Architecture Decision Records",
  "ref": "architecture:architecture-decision-records",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-context",
          "json": "https://banes-lab.com/json/records/lexicon/context",
          "label": "Context",
          "markdown": "https://banes-lab.com/records/lexicon/context.md",
          "ref": "lexicon:context"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-decision",
          "json": "https://banes-lab.com/json/records/lexicon/decision",
          "label": "Decision",
          "markdown": "https://banes-lab.com/records/lexicon/decision.md",
          "ref": "lexicon:decision"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-consequences",
          "json": "https://banes-lab.com/json/records/lexicon/consequences",
          "label": "Consequences",
          "markdown": "https://banes-lab.com/records/lexicon/consequences.md",
          "ref": "lexicon:consequences"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-traceability",
          "json": "https://banes-lab.com/json/records/architecture/traceability",
          "label": "Traceability",
          "markdown": "https://banes-lab.com/records/architecture/traceability.md",
          "ref": "architecture:traceability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-governance",
          "json": "https://banes-lab.com/json/records/architecture/governance",
          "label": "Governance",
          "markdown": "https://banes-lab.com/records/architecture/governance.md",
          "ref": "architecture:governance"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-decision-history",
          "json": "https://banes-lab.com/json/records/lexicon/decision-history",
          "label": "Decision History",
          "markdown": "https://banes-lab.com/records/lexicon/decision-history.md",
          "ref": "lexicon:decision-history"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-tribal-knowledge",
          "json": "https://banes-lab.com/json/records/lexicon/tribal-knowledge",
          "label": "Tribal Knowledge",
          "markdown": "https://banes-lab.com/records/lexicon/tribal-knowledge.md",
          "ref": "lexicon:tribal-knowledge"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-documentation-maintenance",
          "json": "https://banes-lab.com/json/records/lexicon/documentation-maintenance",
          "label": "Documentation Maintenance",
          "markdown": "https://banes-lab.com/records/lexicon/documentation-maintenance.md",
          "ref": "lexicon:documentation-maintenance"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-architecture-decision-records-adr-documentation-maintenance",
          "json": "https://banes-lab.com/json/records/tension/architecture-decision-records-adr-documentation-maintenance",
          "label": "Architecture Decision Records (ADR) / Documentation Maintenance",
          "markdown": "https://banes-lab.com/records/tension/architecture-decision-records-adr-documentation-maintenance.md",
          "ref": "tension:architecture-decision-records-adr-documentation-maintenance"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-tribal-knowledge",
          "json": "https://banes-lab.com/json/records/lexicon/tribal-knowledge",
          "label": "Tribal Knowledge",
          "markdown": "https://banes-lab.com/records/lexicon/tribal-knowledge.md",
          "ref": "lexicon:tribal-knowledge"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-decision-record-with-alternatives",
          "json": "https://banes-lab.com/json/records/lexicon/decision-record-with-alternatives",
          "label": "Decision Record with Alternatives",
          "markdown": "https://banes-lab.com/records/lexicon/decision-record-with-alternatives.md",
          "ref": "lexicon:decision-record-with-alternatives"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-data-change-audit",
          "json": "https://banes-lab.com/json/records/lexicon/data-change-audit",
          "label": "Data Change Audit",
          "markdown": "https://banes-lab.com/records/lexicon/data-change-audit.md",
          "ref": "lexicon:data-change-audit"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-recommended",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-recommended",
          "label": "recommended",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-recommended.md",
          "ref": "vocabulary:severity-recommended"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-architecture-review-evolution-governance-artifacts",
          "json": "https://banes-lab.com/json/records/architecture-category/architecture-review-evolution-governance-artifacts",
          "label": "Architecture Review / Evolution / Governance Artifacts",
          "markdown": "https://banes-lab.com/records/architecture-category/architecture-review-evolution-governance-artifacts.md",
          "ref": "architecture-category:architecture-review-evolution-governance-artifacts"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-architecture-review",
          "json": "https://banes-lab.com/json/records/architecture/architecture-review",
          "label": "Architecture Review",
          "markdown": "https://banes-lab.com/records/architecture/architecture-review.md",
          "ref": "architecture:architecture-review"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/disciplined-methodology#rules-with-names",
          "json": "https://banes-lab.com/json/disciplined-methodology/start/rules-with-names",
          "label": "Rules with names",
          "markdown": "https://banes-lab.com/disciplined-methodology/start/rules-with-names.md",
          "ref": "chapter:/disciplined-methodology#rules-with-names"
        },
        {
          "href": "https://banes-lab.com/software-architecture/principles#the-structural-domain",
          "json": "https://banes-lab.com/json/software-architecture/principles/the-structural-domain",
          "label": "The structural domain",
          "markdown": "https://banes-lab.com/software-architecture/principles/the-structural-domain.md",
          "ref": "chapter:/software-architecture/principles#the-structural-domain"
        },
        {
          "href": "https://banes-lab.com/software-architecture/coverage#a-cell-that-resists-an-invariant",
          "json": "https://banes-lab.com/json/software-architecture/coverage/a-cell-that-resists-an-invariant",
          "label": "A cell that resists an invariant",
          "markdown": "https://banes-lab.com/software-architecture/coverage/a-cell-that-resists-an-invariant.md",
          "ref": "chapter:/software-architecture/coverage#a-cell-that-resists-an-invariant"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-architecture-review-evolution-governance-artifacts",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-architecture-review-evolution-governance-artifacts",
          "label": "Architecture Review / Evolution / Governance Artifacts",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-architecture-review-evolution-governance-artifacts.md",
          "ref": "chapter:/ontology#architecture-category-architecture-review-evolution-governance-artifacts"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-observability-auditability-traceability",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-observability-auditability-traceability",
          "label": "Observability / Auditability / Traceability",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-observability-auditability-traceability.md",
          "ref": "chapter:/ontology#architecture-category-observability-auditability-traceability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-security-privacy-compliance-governance",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-security-privacy-compliance-governance",
          "label": "Security / Privacy / Compliance / Governance",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-security-privacy-compliance-governance.md",
          "ref": "chapter:/ontology#architecture-category-security-privacy-compliance-governance"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-architecture-review-evolution-governance",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-architecture-review-evolution-governance",
          "label": "Architecture Review Evolution Governance",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-architecture-review-evolution-governance.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-architecture-review-evolution-governance"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-core-vocabulary",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-vocabulary",
          "label": "Core Vocabulary",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-vocabulary"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-observability-auditability-traceability",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-observability-auditability-traceability",
          "label": "Observability / Auditability / Traceability",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-observability-auditability-traceability.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-observability-auditability-traceability"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A formal definition of one architecture decision, recording its context, the choice made and its consequences.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-evolutionary-architecture",
      "json": "https://banes-lab.com/json/records/architecture/evolutionary-architecture",
      "label": "Evolutionary Architecture",
      "markdown": "https://banes-lab.com/records/architecture/evolutionary-architecture.md",
      "ref": "architecture:evolutionary-architecture"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-quality-attributes",
      "json": "https://banes-lab.com/json/records/architecture/quality-attributes",
      "label": "Quality Attributes",
      "markdown": "https://banes-lab.com/records/architecture/quality-attributes.md",
      "ref": "architecture:quality-attributes"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [
    "ADRs"
  ],
  "exemplar": {
    "after": "const adr = recordDecision({\n  id: \"ADR-0042\",\n  title: \"Use PostgreSQL for Foo persistence\",\n  status: \"accepted\",\n  context: fooPersistenceForces,\n  decision: \"postgres\",\n  consequences: fooPersistenceConsequences,\n});",
    "before": "chooseFooDatabase(\"postgres\");",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "architecture decision"
  ],
  "severity": "recommended"
}