# Architecture Decision Records

> Фиксировать значимые архитектурные решения в ADR: контекст, варианты, выбранное решение, trade-offs и последствия.

- Skill: `maslennikov-anton/architecture-decision-records` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add maslennikov-anton/architecture-decision-records`
- Raw SKILL.md: https://api.skillmd.com/api/skills/maslennikov-anton/architecture-decision-records/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Maslennikov-Anton (https://skillmd.com/u/maslennikov-anton)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/maslennikov-anton/architecture-decision-records

---


# Architecture Decision Records

Этот skill нужен для случаев, когда решение уже влияет на архитектуру, процесс разработки или операционную модель и его нужно зафиксировать так, чтобы команда потом могла понять не только что выбрали, но и почему.

## Когда использовать

Используй skill, если нужно зафиксировать:

- выбор архитектурного подхода или шаблона интеграции;
- новый основной стек, storage, queue, runtime или API-подход;
- важное security-решение;
- значимую смену направления с явными trade-offs;
- решение, которое потом придется защищать, пересматривать или supersede.

## Базовый workflow

1. Опиши контекст, ограничения и decision drivers.
2. Выдели реальные варианты, которые рассматривались.
3. Зафиксируй выбранное решение и аргументацию.
4. Отдельно опиши последствия: хорошие, плохие, риски, follow-up.
5. Обозначь статус решения и связи с другими ADR.

## Ключевые правила

- ADR не должен быть пересказом финального решения без контекста.
- Для каждого варианта нужны осмысленные trade-offs, а не декоративный список.
- Решение должно быть привязано к ограничениям и ожидаемым последствиям.
- Если решение временное или спорное, это нужно писать явно.
- Если решение потом отменят, новый ADR должен ссылаться на предыдущий, а не стирать историю.

## Карта reference-файлов

- `references/adr-template.md` -> шаблон ADR и короткие правила заполнения

## Формат ответа

Когда просят оформить ADR, возвращай:

1. Название решения и статус.
2. Контекст и decision drivers.
3. Рассмотренные варианты и trade-offs.
4. Принятое решение и rationale.
5. Последствия, риски и follow-up шаги.