architecture-decision-records · ADR — записи архитектурных решений

{
  "id": "architecture-decision-records",
  "title_ru": "ADR — записи архитектурных решений",
  "title_original": "Architecture Decision Records",
  "owner": "Michael Nygard / сообщество ADR",
  "kind": "Метод документирования",
  "normativity": "Редакционная карточка практики документирования; не нормативный стандарт и не полный перевод источников.",
  "domains": [
    "программная архитектура",
    "описание решений",
    "управление изменениями"
  ],
  "summary_ru": "ADR (Architecture Decision Record) — короткая запись одного существенного архитектурного решения. Она сохраняет контекст, выбранный подход, основания и последствия, чтобы участники проекта могли понять, почему система устроена именно так. Это помогает обсуждать компромиссы и пересматривать решения при изменении условий.",
  "principles_ru": [
    "Базовая структура: название, контекст, решение, статус и последствия. Расширенный шаблон может включать рассмотренные варианты и критерии выбора.",
    "Фиксируйте ограничения, причины выбора, положительные и отрицательные последствия, а также компромиссы.",
    "Различайте предложенное (Proposed), принятое (Accepted) и заменённое (Superseded) решение. Заменённую запись сохраняйте и связывайте с новой."
  ],
  "use_ru": "Ведите записи рядом с проектом и обсуждайте их при выборе технологий, границ компонентов, интерфейсов или требований к качеству. Команда определяет шаблон, порядок согласования и момент принятия записи; документ должен оставаться кратким и понятным будущим читателям.",
  "boundary_ru": "ADR сохраняет основания выбора, но сам по себе не доказывает его правильность. Наличие записи не заменяет исследования, проверки требований, тестирования или соблюдения обязательных стандартов.",
  "evidence": "A",
  "checked_at": "2026-10-10",
  "source_url": "https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions",
  "sources": [
    {
      "title": "Michael Nygard — Documenting Architecture Decisions",
      "url": "https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions"
    },
    {
      "title": "Microsoft — Maintain an architecture decision record",
      "url": "https://learn.microsoft.com/en-us/azure/well-architected/architect-role/architecture-decision-record"
    },
    {
      "title": "ADR: описание практики и шаблоны",
      "url": "https://github.com/architecture-decision-record/architecture-decision-record"
    }
  ]
}