Так кому писать ADRs?

Следующая заметка про записи архитектурных решений  продолжает темы, затронутые в

Я хочу поделиться результатами недавнего опроса в тг.-канале Архитектура ИТ-решений и некоторыми размышлениями над комментариями к нему. На данный момент опрос собрал почти тысячу голосов, причем варианты не были взаимоисключающими (каждый участник мог выбрать несколько, картинка будет ниже). Читать далее Так кому писать ADRs?

Навык архитектурных решений

Появление стандарта агентских навыков agent skills привело к том, что все, кто раньше рассказывал про prompt engineering переключились на создание навыков. ИТ-архитекторы не исключение. Правда научить модели хорошо рисовать архитектурные диаграммы пока получается не всегда. Даже любимую С4 model, даже в Mermaid или PlantUML (см. Hallucinations as Code). А вот попросить написать запись архитектурного решения ADR — да запросто. Вообще-то, agent skills был придуман немного для другого, но кого это остановит. Давайте обо всем по порядку. Читать далее Навык архитектурных решений

Chat Completions API vs Response API

Почти год прошел с появления нового программного интерфейса Response API от Open AI, который должен был вытеснить Chat Completions API, но воз, похоже, и ныне там. Если вы встраивали LLM-сервисы в свои приложения, то наверняка заметили, что про их APIs принято говорить только хорошее. Огромное количество позитивных новостей встречает появление нового или улучшение существующего программного интерфейса. Мало кто осмелится усомниться в их конструкции. Наверное, похожий трепет вызывали первые радиоприемники, приземляющие сигнал из эфира в кухни и комнаты обывателей. Адептов даже не смущают откровения разработчиков о том, что некоторый API, а именно, тот самый Chat Completions API — де-факто текущий стандарт для взаимодействия с LLM-ами, был разработан практически «за выходные» (твит см. ниже, подробности здесь: https://x.com/athyuttamre/status/1899541471532867821). Кстати, появление этого “откровения” и было приурочено к выходу год назад другого интерфейса, названного Response API. Об этих двух APIs и пойдет речь сегодня. Читать далее Chat Completions API vs Response API

Старый добрый RSS/ATOM

В нашей вселенной telegram все еще работает и это позволяет мне оттягивать прикручивание e-mail рассылки к этому блогу. Пока блог жил на wordpress.com этот функционал был почти из коробки. После переезда на открытый хостинг возможность самостоятельной рассылки мейлов остается, но выглядит так себе идеей. А подключение платного сервиса e-mail рассылок требует некоторого внимания. В общем, здесь мы пока живем без писем. Но может быть в параллельной вселенной telegram уже давно заблокировали. И для подписчиков оттуда я хочу напомнить про старый добрый RSS. Да-да, в CMS системы WordPress, до сих пор по умолчанию доступен RSS. Достаточно закинуть в любимую читалку потоков новостей тривиальную ссылку https://mxsmirnov.com/feed/ для RSS 2.0 или https://mxsmirnov.com/feed/atom/ для ATOM, впрочем, не важно. Для любого блога wordpress, по умолчанию, доступна ссылка

https://имя_сайта/feed/

На всякий случай отдельно добавил в область виджетов. Пользуйтесь! Читать далее Старый добрый RSS/ATOM

Модели контролируют соблюдение ADRs

Пока в научных лабораториях и постфактум

В феврале 2026 появилось исследования Evaluating Large Language Models for Detecting Architectural Decision Violations, выявляющее, способность больших языковых моделей контролировать соблюдение архитектурных решений. И способность такую у LLM исследователи, в общем и целом, подтвердили. Можно ли доверять результатам такого исследования? Априори нет. Давайте разберемся с дизайном

В качестве исходной выборки взяли известный список репозиториев с github из исследования Using Architecture Decision Records in Open Source Projects – An MSR Study on GitHub Я недавно о нем рассказывал в своем видео Модернизация процесса проектирования (ссылка с 25 минуты)

Обновили список, выяснив какие из репозиториев доступны на текущий момент , выбрали из них те, где больше 30 тыс. строчек кода, больше тысячи коммитов и где ADRs напоминали какой-либо из известных форматов. В общем, в итоге получилось 109 репозиториев и 980 файлов ADRs, внутри которых исследователи насчитали 1317 решений, а дальше началась магия. Читать далее Модели контролируют соблюдение ADRs

Hallucinations as Code

Debugging AI-Generated Diagrams

Великолепный текст Why Your AI-Generated C4 Diagrams Look Terrible (And How to Fix Them) опубликовал пару дней назад David R Oliver. Добрую половину занятия про Diagram as Code из моего нового курса Проектирование ИТ-решений с использованием Cursor AI можно было бы сделать на основе этого материала. Выводы автора абсолютно созвучны моим наблюдениям о том, когда использовать Mermaid, а когда PlantUML, с чем большие языковые модели справятся, а когда им надо немного помочь. И список ссылок в статье потрясающий.

А еще автор не поленился сделать несколько agent skills для генерации diagram as code и выложил их сюда: github.com/DavidROliverBA/Daves-Claude-Code-Skills

Для тех, кто поленится читать оригинальный текст, соберу конспект из основных рекомендаций. Они подходят для любой модели (ну, для тех, что я посмотрел, по крайней мере) и могут быть полезны как при использовании сред (IDE) так и в чатах Читать далее Hallucinations as Code

Кто мы без хардов?

Я обещал уделить внимание этому ресурсу (и этому формату) и стараюсь выполнить свои обещания. Сегодня мы поговорим о soft skills… а вот и нет! Вернее отчасти. Разговоры о гибких навыках насколько популярны, настолько же и бессмысленны. Разговоры о hard skills – конкретных технических знаниях и умениях, необходимых для выполнения профессиональных задач, которые можно четко измерить, проверить (тестами, дипломами) и продемонстрировать на практике, настолько нечасты, что в Википедии даже нет страницы для этого термина. Мы поговорим о некоторых навыках, которые лежат, как бы, посередине. Причиной моего акцента на этом послужили несколько недавних заметок в блоге Gregor Hohpe, но давайте обо все по порядку Читать далее Кто мы без хардов?

Расшифровка рассказа о курсе «Проектирование ИТ-решений с использованием Cursor AI»

Я транскрибировал текст прошедшего вебинара про курс «Проектирование ИТ-решений с использованием Cursor AI» , но решил не выкладывать целиком 28 страниц текста, а выбрать некоторые ключевые моменты. Получилось существенно меньше Читать далее Расшифровка рассказа о курсе «Проектирование ИТ-решений с использованием Cursor AI»

Проектирование ИТ-решений с использованием Cursor AI

Презентация нового учебного курса:

Скачать слайды можно отсюда: https://disk.yandex.ru/i/6Q8j5eQ9oQr5YQ

Если нужен транскрипт, то напишите в комментарии

Enterprise RAG

Я немного подсел на идею разработки корпоративных Retrieval-Augmented Generation (RAG) приложений и решил до конца года провести несколько виртуальных встреч книжного клуба по книжке Тайлера Суарда Enterprise RAG. Scaling Retrieval Augmented Generation (книжка неоднозначная, может придется её дополнить и другими текстами, к тому же она пока не дописана и распространяется по программе Manning Early Access Program, но должна появиться уже в декабре 2025-го; на текущий момент завершены 6 из 10 глав; в общем, все как мы любим).

В двух словах, о чем речь: Читать далее Enterprise RAG