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

Какие бывают архитекторы

Соревнуюсь c DeepSeek в подготовке слайдов с рассказами об ИТ-архитектуре. Лет 15 назад, я предложил вот такую шутливую картинку, чтоб проще было разобраться в архитектурных ролях.

а сегодня попросил нарисовать нечто подобное дипсика (источник не указывал). Вот что получилось: Читать далее Какие бывают архитекторы

Architecture Vision и High Level Design (HLD)

Вот что мне насочинял DeepSeek. Вроде получилось неплохо

Вот таблица, которая наглядно сравнивает Architecture Vision и High Level Design (HLD):

Критерий Architecture Vision High Level Design (HLD)
Цель документа Описание «зачем» и «куда». Стратегический документ, объясняющий цели и преимущества. Описание «как». Технический документ, показывающий, как система будет работать.
Уровень детализации Высокоуровневое описание целей, преимуществ и общего направления. Более детальное описание компонентов системы и их взаимодействия.
Аудитория Руководство, заинтересованные стороны (Stakeholders), бизнес-пользователи. Технические специалисты, разработчики, архитекторы.
Содержание — Цели и задачи.
— Текущее состояние (Baseline).
— Целевое состояние (Target Architecture).
— Преимущества и выгоды.
— Ключевые заинтересованные стороны.
— Риски и ограничения.		 — Основные компоненты системы.
— Взаимодействие между компонентами.
— Технологии и инструменты.
— Высокоуровневые потоки данных.
Когда используется На начальном этапе проекта, чтобы получить одобрение от руководства и заинтересованных сторон. После утверждения Architecture Vision, чтобы начать техническую реализацию.
Пример «Цель — автоматизировать процессы. Преимущество — сокращение времени обработки заказов на 50%.» «Веб-интерфейс будет отправлять данные в базу данных через REST API.»
Аналогия Общее описание путешествия: «Мы поедем в Париж, чтобы увидеть Эйфелеву башню.» Детали маршрута: «Мы поедем на поезде из Москвы в Париж, остановимся в гостинице рядом с Эйфелевой башней.»

Итог

  • Architecture Vision — это стратегический документ, который задаёт направление и отвечает на вопросы «зачем» и «куда».
  • High Level Design (HLD) — это технический документ, который показывает, как двигаться в этом направлении, отвечая на вопрос «как».

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

Архитектура решений. Сложные компромиссы

В предновогоднем тексте я заметил, что современный учебный курс по архитектуре решений не может обойтись без хорошего примера. И даже предложил в качестве такого примера известную архитектурную кату Отряд сисопов (Sysop Squad). Но не удосужился перечислить обязательные или крайне желательные характеристики такого примера. Сегодня я постараюсь исправить этот пробел и сформулировать список таких характеристик. Возможно, он будет полезен не только мне и будущему новому курсу, но и пригодится кому-нибудь при подборе задач для собеседования архитектора решений или как набор критериев при подборе других архитектурных кат именно для тренировки навыков Solution Architecture. Итак, приступим Читать далее Архитектура решений. Сложные компромиссы

Навстречу 2025-му. Свершения и прогнозы

В ходе предновогоднего стрима я уже отметил, что времена само-сбывающихся пророчеств в ИТ, похоже, прошли. В нулевые достаточно было консультантам объявить приход сервис-ориентированной архитектуры и вот уже все о ней только и говорят. Похожая ситуация складывалась и в десятые годы, только в роли провидцев теперь уже выступали интернет-гиганты. Они рассказывали про свой опыт построения высоконагруженных приложений или же просто публиковали как open source то или иное свое решение. Потом это тоже закончилось, а жанр рождественских гаданий превратился в отчеты о сделанном в году уходящем и изложение планов на год наступающий. Подчинюсь и я этому жанру. Читать далее Навстречу 2025-му. Свершения и прогнозы

За что не любят архитекторов предприятия

Иногда я буду делать небольшие критические обзоры текстов разных авторов. Сегодня мне попалась заметка David R Oliver C4+1 — The Services Layer. В статье много есть к чему придраться, но я постараюсь только по существу. Читать далее За что не любят архитекторов предприятия