В «451° по Фаренгейту» люди сами променяли книги на телевизионные стены. Книги требовали думать, а стены — просто потреблять. Удобно, быстро и без напряга.

Мы в ИТ стоим на похожем перекрестке, не только из-за ИИ. Мы годами принимаем решения, не фиксируя «почему», копируем best practices без контекста, берем готовые архитектуры из интернета. Потребляем, и иногда забываем подумать. И искусственный интеллект — не причина, а катализатор, поскольку ускоряет процесс, который шел десятилетиями.

Привет, Хабр! Меня зовут Марат Мустафин, я архитектор в МТС Web Services. В этом материале хочу порассуждать о том, как не потерять способность думать в мире, где все подталкивает нас к потреблению готовых ответов.

Что мы теряем, когда перестаем фиксировать «почему»

Вот реальная ситуация. Команда выбирает Apache Kafka для брокера сообщений, решение принято за минуту — потому что «все так делают». Через год архитектор увольняется — новый архитектор смотрит на систему и не понимает… Почему Kafka, а не RabbitMQ? Почему REST, а не gRPC? Какие альтернативы рассматривались?

Контекст утерян и начинается дорогой рефакторинг — или жизнь в страхе сломать то, что работает непонятно как.

Я видел это своими глазами: система живет, пользователи довольны, но никто не знает, почему она устроена именно так. Архитектор ушел — и вместе с ним ушло знание. Осталась только магия, в которую никто не верит, но все боятся сломать.

Я уже вспоминал Азимова в материале про «Гиперион», но здесь это важно повторить под другим углом. В «Основании» Галактическая Империя разваливается, потому что никто уже не понимает, как работают атомные генераторы. Инженеры копируют древние чертежи и молятся, чтобы работало. Это ровно то, что происходит с системой без ADR: знание не зафиксировано, технология превратилась в магию:

Почему люди не фиксируют контекст

Мы знаем, что надо писать документацию, мы знаем, что ADR — это полезно. Но все равно не делаем. Почему?

Цейтнот. «Некогда писать ADR, надо закрывать спринт». Фиксация решений воспринимается как дополнительная работа, а не как часть работы. Но есть и более тонкая причина: мы часто создаем ложный цейтнот сами. Написать ADR — пять минут. Но мы говорим «некогда», потому что фиксация не дает немедленного дофамина. Закрытый таск — вот он, в Jira, красивый. А ADR — его ценность проявится через год, когда новый архитектор скажет спасибо. Мы выбираем немедленное подкрепление — и проигрываем вдолгую.

Иллюзия компетентности. «Я и так помню, почему выбрал Kafka». Через месяц детали стираются, через год ты уже не помнишь, какие альтернативы рассматривал, — но в моменте принятия решения кажется, что это навсегда.

Культура быстрых побед. Документация не дает немедленного результата — ее ценность видна только через месяцы, когда кто-то новый заходит в проект. Быстрые фичи ценятся выше, чем долгосрочная стабильность. Это как в романе Брэдбери: телевизионные стены дают мгновенное удовольствие, а книги требуют времени.

Как это работает на практике: три ADR из жизни

Теория — это красиво, но я хочу показать, как ADR работает на реальных примерах. У нас в стриме 1С МТС сейчас более 30 ADR. Каждый — это зафиксированное «почему». Вот три из них.

Пример 1. Выбор брокера сообщений: почему не Kafka

Помните пример из начала статьи — «выбрали Kafka, потому что все так делают»? Вот как выглядит осмысленный выбор.

У нас ~40 баз 1С, которые непрерывно обмениваются данными. Задержка синхронизации НСИ или потеря проводки при закрытии месяца — это инцидент с реальными последствиями. Когда встал вопрос о брокере сообщений, мы не стали гуглить «Kafka vs RabbitMQ 2025» и копировать первый ответ. Мы зафиксировали контекст: 80% трафика — это парные обмены между конкретными базами с гарантированной доставкой и квитанциями. Нет требований к потоковой аналитике, единому логу событий или хранению всех сообщений. Масштаб — тысячи сообщений в день.

Мы сравнили два варианта по семи критериям — от соответствия доменной модели до зрелости интеграции с 1С. И записали главное:

«RabbitMQ решает нашу задачу точнее. Концепция vhost — прямая техническая проекция нашей бизнес-модели: одна организация — один изолированный контур обмена. Kafka не имеет аналогичного механизма, и попытка его эмулировать вводит архитектурную сложность без компенсирующих выгод».

«Миграция несет непропорционально высокие риски и затраты. Переработка клиентской библиотеки 1С, адаптация 40+ баз, перестройка мониторинга — это 6–12 месяцев работы при отсутствии бизнес-требований, которые невозможно реализовать на текущей платформе».

Мы также записали осознанные trade-offs: RabbitMQ не хранит обработанные сообщения, а добавление нового потребителя НСИ сложнее, чем в Kafka. Это не идеальное решение — это правильное решение для нашего контекста.

Теперь представьте, что через два года придет новый архитектор и спросит: «А почему не Kafka?» Без ADR ответ был бы: «Ну, исторически так сложилось». С ADR — он за десять минут увидит контекст, альтернативы, критерии и обоснование. И либо согласится, либо скажет: «Контекст изменился, давайте пересмотрим», — но уже с пониманием, а не вслепую.

Пример 2. Уход от Jenkins: компромисс вместо революции

Jenkins у нас отвечал за все: сборка релизов, обновление баз, запуск тестов, автоматизация административных рутин. Вся команда обучена, пайплайны написаны, практики наработаны. Работает? Работает.

Но в корпоративном техрадаре Jenkins попал в статус HOLD. Рекомендация — переходить на GitLab CI. И тут начинается самое интересное: как не сломать то, что работает, выполняя стратегическое требование?

Мы рассмотрели три варианта:

  • полный переход на GitLab CI (плюс — новые компетенции; минус — полная переподготовка команды, GitLab CI неудобен для административной автоматизации);

  • оставить Jenkins как есть (плюс — ноль затрат; минус — команда не осваивает новый инструмент, проблемы с масштабируемостью);

  • компромисс: часть пайплайнов переезжает, часть остается.

Выбрали компромисс. В GitLab CI уходят сборки и тесты, в Jenkins остается административная автоматизация — то, для чего GitLab CI не предназначен. Через год возвращаемся к вопросу и принимаем повторное решение уже с опытом.

Без ADR это выглядело бы как «ну, мы используем и то, и другое, исторически так сложилось». С ADR — это осознанная стратегия с запланированной точкой пересмотра.

Пример 3. Миграция платформы 1С: как менять все, не сломав работающее

Самый масштабный ADR — перевод платформы 1С с Windows/MSSQL на Linux/PostgreSQL. Заменяется каждый компонент стека: ОС, СУБД, веб-сервер, балансировка. Системы — Business Critical, лицензии Microsoft — в статусе HOLD по стратегии импортозамещения. Но самое интересное решение было не «что выбрать», а «как мигрировать». Мы зафиксировали три варианта:

  • прямая миграция существующих контуров (быстрее уход от лицензий, но миграция боевых данных критичных систем со сложным откатом — высокий риск);

  • параллельное развертывание новых контуров на целевом стеке (контролируемый риск и простой откат, но двойные ресурсы на период миграции);

  • Kubernetes-нативная платформа (модно и масштабируемо, но 1С не контейнеризируется корректно, — отклонено).

Выбрали параллельное развертывание. И зафиксировали trade-offs, например: «Ручной failover ЦОД: 15–30 минут RTO (было ∼5 мин на MSSQL Always On). Митигация: отработанные runbook, ежеквартальные DR-тесты». Попробуйте сказать это без ADR. «Мы перешли на PostgreSQL» — и конец истории. А с ADR видно: мы осознанно приняли увеличение RTO с 5 до 30 минут и временное удвоение затрат на инфраструктуру — потому что для Business Critical систем контролируемый откат важнее скорости.

Через пять лет, когда архитектура снова изменится, новый архитектор откроет этот документ и поймет не только что было сделано, но и почему. Какие ограничения учитывались, какие компромиссы были приняты сознательно. Он не будет копировать чертежи и молиться — как инженеры Азимова. Он будет понимать.

Что с этим делать: TOGAF для обычных людей

Давайте честно: TOGAF звучит страшно. 500 страниц документации, сертификация, громкие аббревиатуры. Я не сертифицированный гуру, я архитектор, который взял из TOGAF только то, что реально работает.

Что именно?

ADR — страховка, которая окупается. Architecture Decision Record — короткий документ: контекст, альтернативы, решение, почему. Как вы видели выше, он может уместиться на одну страницу (Jenkins) или вырасти до десяти (миграция на PostgreSQL). Длина не важна — важно зафиксировать три вещи: какие варианты рассматривались, что выбрали и почему именно это.

Принципы помогают команде думать без архитектора. «Мы делаем так, потому что...» — это не директива, это обоснование. Хороший принцип — ответ на вопрос, который еще не задали. Плохой, на мой взгляд, — приказ, который выполняют не думая.

Трассировка требований. От бизнес-задачи до строки кода. Новый разработчик спрашивает, почему этот сервис существует, — ответ лежит в ADR, а не только в голове старожила, который уволился в прошлом квартале.

Каталог данных. Без карты данных вы — пожарный без плана здания и тушите вслепую. У нас такой каталог есть, и он не раз спасал от ошибок при интеграции между контурами.

По сути, все перечисленное — способ оставить след, сказать: «Я здесь был, я думал над этим, вот к чему пришел».

Почему это не заменит архитектора?

Архитектор знает контекст, которого нет в промте. ИИ может сгенерировать сто вариантов архитектуры, но он не знает, что команда DBA не имеет компетенций по PostgreSQL и требуется обучение. Не знает, что Jenkins попал в HOLD на техрадаре компании, но отлично работает для административной автоматизации. Не знает, что миграция 40+ баз — это 6–12 месяцев работы с риском регрессий при еженедельных релизах. Архитектор знает — и выбирает не «лучший» вариант, а тот, который сработает именно здесь.

Архитектор умеет сказать «нет». ИИ генерирует, а архитектор — фильтрует. Недавно коллега показал мне сгенерированную архитектуру — красивая, микросервисная, event-driven. Но для трех разработчиков и MVP это был, на мой взгляд, перебор. «Нет, давайте начнем с монолита». ИИ же не сможет так ответить, поскольку не чувствует контекста.

Архитектор несет ответственность. Когда система упадет в три ночи, ИИ не проснется. А архитектор — да. Ответственность нельзя делегировать алгоритму.

И еще один момент: ИИ выдает чистый, красивый и без следов результат. Откуда взялось решение? Какие альтернативы отброшены? Молчание. Так любой результат рано или поздно превращается в магию, которая означает только будущий техдолг.

Что в сухом остатке

Мир «451°» — это мир, где люди разучились думать, потому что думать стало необязательно. Телевизионные стены давали все: развлечения, ответы, иллюзию жизни. Книги требовали усилий — и поэтому проиграли.

В ИТ порой происходит то же самое. Готовые архитектуры из интернета, скопированные best practices, ответы ИИ без контекста — это наши телевизионные стены. Удобные, быстрые, не требующие усилий. А ADR, архитектурные принципы, каталоги данных — это книги. Они требуют времени, их ценность не мгновенна — но именно они хранят знание для тех, кто придет после.

Герой Брэдбери — пожарный Гай Монтэг — в финале уходит к людям-книгам, к тем, кто запоминал тексты наизусть, чтобы знание не погибло. Каждый хранил одну книгу, а вместе они были целой библиотекой.

ADR — это наши книги. Каждый — маленький, неказистый, написанный между спринтами. Но когда через два года кто-то спросит «почему система устроена именно так?», ответ будет. А если не будет, то технология снова превратится в магию. Ту самую, которую в мире Брэдбери сначала перестали понимать, потом перестали ценить, а в итоге — сожгли.

Как вы фиксируете архитектурные решения? Используете ADR, Confluence или держите все в голове? Делитесь в комментариях — интересно сравнить подходы.

Комментарии (10)


  1. XelaVopelk
    18.11.2026 07:56

    Архитектор несет ответственность. Когда система упадет в три ночи, ИИ не проснется. А архитектор — да.

    И что он будет делать в 3 ночи, если не секрет? Поднимать лежачую систему в общем то будет разработка и архитектора позовут уж совсем в крайнем случае или если архитектор сильно "в коде".


    1. P1ngZer0
      18.11.2026 07:56

      Зависит от компании конечно, в небольших или средних командах архитектор просто самый опытный разраб, который так же сидит на дежурствах. А вот в энтерпрайзе уровня телекома его до утра даже искать никто не станет, в три ночи спасать прод лезут девопсы и разрабы с логами, пока архитектор спит. В лучшем случае он с утра придет и посмотрит, насколько правильно сработал его план восстановления на бумаге


  1. mist56
    18.11.2026 07:56

    Что делать, когда через неделю разработки становится очевидно, что в ADR 30% бред?


    1. XelaVopelk
      18.11.2026 07:56

      У архитектора есть руководитель. Делать то же самое как, когда любой другой плохо выполняет свою работу.
      С другой стороны такое тоже возможно в случае, если никто не знает как работает система в т.ч. текущий архитектор. Обычно это в ADR пишется в рисках. Если в процессе разработки выясняется новая информация, то техрешение должно уйти на доработку.


      1. mist56
        18.11.2026 07:56

        Т.е. опять натягиваем старые человеческие процессы в изменившуюся реальность. А реальность такова, что эффективность агентов напрямую завязана на логическую чистоту контекста и любой по факту оказавшийся неправильным ADR начинает этот контекст загрязнять и мешать работать. Документация не то что нужна, она жизненно необходима для работы. Но вот статичная документация, только что бы тешить чьё то ЧСВ имхо прямой вред.


  1. XelaVopelk
    18.11.2026 07:56

    Когда встал вопрос о брокере сообщений, мы не стали гуглить

    вот тут непонятно. Если библиотека 1с-rabbit у вас в проде, значит и кролик в проде в 1с инфраструктуре. И у человека читающего эту ADR возникнет сразу же вопрос "а почему вообще возник такой вопрос? Какие минусы у работы 1с выявлены, что мы поставили вопрос об альтернативе в виде кафки?". Так то выглядит, что "кафка" это фиктивная альтернатива, чтобы написать бумагу.


  1. BeLord
    18.11.2026 07:56

    Написание любой документации это база для любой задачи, следовательно при расчете времени выполнения задачи нужно заложить документацию и "будет счастье".

    Ремарка 1. Почему документацию не пишут - не умеют/не любят/понимают, что нормальная документация фиксирует косяки (нужное подчеркнуть, свое предложить).

    Ремарка 2. Экономика проекта живет отдельно, а разработка/внедрение отдельно, когда будет понимание, что отсутствие документации= убытки, то документацию будут делать.

    Ремарка 3. Плохие привычки, это задача решена быстро, все молодцы. Лично для меня быстро это пустой звук. Задача может быть решена способом 1 за день и Х рублей, способом 2 за неделю и Y рублей, это уже показатель. Задача способом 1 цена владения за 3 года Z рублей, способом 2 цена владения за 3 года Z*10 рублей - это уже аргумент.


  1. P1ngZer0
    18.11.2026 07:56

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


    1. XelaVopelk
      18.11.2026 07:56

      Когда у тебя одна система, возможно. Хотя я вот ни раз ну видел во внутрикорпоративной разработке репы, которую можно наградить такими эпитетами. Но когда у тебя пучок сервисов на разных языках от разных команд и департаментов, закрытые покупные системы, внешние системы, от которых есть только описание api, которые как-то друг с другом взаимодействуют,… есть мутные хотелки инфраструктурщиков и безопасников… В этом случае правильная модульность в твоём репозитории тебе мало поможет. Как не поможет архитектору, которому надо как-то разбираться в этом зоопарке.


  1. A1x_Deb0
    18.11.2026 07:56

    Чем больше читаешь такие статьи, тем больше понимаешь, что люди, проектировавшие лет 20...30 назад и люди проектирующие сейчас - это два разных мира. Если почитать стандарты разработки и качества ПО, то можно обнаружить поразительные вещи. Например ISO "ISO/IEC/IEEE 29148:2011 Systems and software engineering - Life cycle processes - Requirements engineering", :.

    5.2 Requirements fundamentals
    5.2.4 Requirements construct

    Well-formed stakeholder requirements, system requirements, and system element requirements shall be developed. This will contribute to requirements validation with the stakeholders, and ensure that the requirements accurately capture stakeholder needs.

    A well-formed requirement is a statement that

    • can be verified,

    • has to be met or possessed by a system to solve a stakeholder problem or to achieve a stakeholder objective,

    • is qualified by measurable conditions and bounded by constraints, and

    • defines the performance of the system when used by a specific stakeholder or the corresponding capability of the system, but not a capability of the user, operator, or other stakeholder.

      This description provides a means for distinguishing between requirements and the attributes of those requirements (conditions, assumptions, design decisions and constraints).

      По сути стандарт говорит о том, что нормально ведите требования и вопрос "почему так сделано" у вас не появится. Если в проекте ведется нормально работа с артефактами, то двухсторонняя трассировка требование - реализация у вас будет работать автоматически.

    Архитектор знает контекст, которого нет в промте.

    А в промте пишется "сделай хорошо, не делай плохо" ? Так даже для этого надо задать критерии "хорошо \ плохо". И даже для ИИ задекларировать и метрики и процесс.

    Трассировка требований. От бизнес-задачи до строки кода. Новый разработчик спрашивает, почему этот сервис существует, — ответ лежит в ADR

    Ответ "почему этот сервис должен быть" нет в ADR, а в требованиях и архитектуре.
    А вот что интересно в ADR, так это " The ADR documents all key decisions, including alternatives that you ruled out, for architecturally significant requirements. " ( ADR документирует все ключевые решения, включая альтернативы, которые вы исключили, для архитектурно значимых требований. )
    Или "почему именно такая реализация", если весь проект сделан по другому, может там быть, Но, по логике, для этого сервиса должны быть свои требования (не-)функциональные, объясняющие такой выбор решения.

    Если раньше, это все спихивали на "лучше работающее, чем написанная документация" в том или ином виде и обходились неформальными коммуникациями или подход "код как документация"", то сейчас этот фокус с ИИ обходится все дороже и все сложнее.

    Такими темпами, скоро и глоссарий "изобретут"