04Архитектура
Architecture Decision Record (ADR)
Зафиксировать архитектурное решение: контекст, варианты, выбор и trade-offs.
Напиши ADR для решения: {{decision}}.
Шаблон
# ADR-NNN: [короткое название]
**Дата:** YYYY-MM-DD
**Статус:** Proposed | Accepted | Superseded by ADR-XXX | Deprecated
**Авторы:** ...
## Контекст
Опиши проблему которую решаем. Без вариантов решения.
- Какие требования?
- Какие ограничения (бюджет, время, навыки, существующая система)?
- Какие предположения?
- Какие риски в воздухе?
3-5 абзацев.
## Варианты
Рассмотри 2-4 варианта. Для каждого:
### Вариант A: [название]
- **Описание:** что это
- **Плюсы:**
- ...
- ...
- **Минусы:**
- ...
- ...
- **Стоимость:** время / деньги / поддержка
- **Риски:** что может пойти не так
### Вариант B: ...
### Вариант C: ...
## Решение
Мы выбрали **Вариант X**.
**Почему именно этот:**
- ...
- ...
**Что мы СОЗНАТЕЛЬНО приняли:**
- Минус 1 — мы можем с этим жить, потому что ...
- Минус 2 — будем митигировать тем что ...
## Последствия
### Положительные
- ...
### Отрицательные
- ...
### Что становится труднее
- ...
### Что становится легче
- ...
## Ревизия
Когда стоит пересмотреть это решение:
- Если [условие 1]
- Если [условие 2]
## Связанные ADR
- ADR-XX: ...
## Открытые вопросы
- ...
Принципы хорошего ADR
- Контекст важнее решения. Через год важно понять ПОЧЕМУ, а не ЧТО.
- Покажи отвергнутые варианты. Без них не понятно почему выбран этот.
- Назови минусы выбранного. Решений без минусов не бывает. Если их нет — ты их не разглядел.
- Дата + автор обязательны. Через год: "что мы знали в этот момент?"
- Не редактируй после принятия. Если решение изменилось — новый ADR со ссылкой "supersedes XX".
Анти-паттерны
- "Мы выбрали X потому что X лучше" — без сравнения
- Только плюсы выбранного варианта
- Контекст одной строкой
- ADR на изменения внутри модуля (это не архитектурное решение)
Похожие промты
design / design-system
Документация компонента
Документация по компоненту: API, варианты, состояния, доступность, использование.
design-systemdocumentationcomponents
Открыть
Начальный15-30 мин
agents / orchestration
Multi-agent: координатор и специалисты
Архитектура из координатора и специализированных агентов: передача контекста, дедупликация, race conditions.
agentsorchestrationmulti-agent
Открыть
Продвинутый30-60 мин
agents / orchestrationFeatured
Переезд в новый чат: handoff контекста
Когда контекст переполнен и пора в новый чат — не «начать заново», а сгенерировать один артефакт HANDOFF, после которого новая сессия стартует с продакшен-готовым пониманием всего что было.
handoffcontextsession
Открыть
Средний15-30 мин (один раз перед переездом)