Я запустил проект создания системы управления корпоративной архитектурой, в которой объекты и связи живут с полной историей изменений, как код в git: ветки, коммиты, сравнение состояний, слияние. Работаем вдвоём: я и ИИ‑агент. Я ставлю задачи, принимаю решения и отвечаю за результат; он пишет документы и код — и он же был соавтором архитектуры, которую я собрал в диалоге с ним ещё до того, как завёл репозиторий. Начну с постановки задачи: именно она связала мне руки сильнее, чем любое последующее архитектурное решение.
Рубрика «adr»
Я написал, чего в системе не будет. Это оказалось важнее всего остального
2026-09-28 в 9:40, admin, рубрики: adr, postgresql, версионирование модели, границы системы, ии-агенты, корпоративная архитектура, Постановка задачи, требованияУстав и летопись кодинг-агентов
2026-08-04 в 14:27, admin, рубрики: adr, agents.md, codex, llm, openspec, Spec Driven Development, вайб-кодинг, кодинг-агенты, хореографияПри ИИ-ассистированной разработке (или, если угодно, вайб-кодинге) довольно быстро проявляются одни и те же проблемы:
-
деградация контекста (модель “забывает” детали);
-
саботаж команд или неаккуратное следование;
-
трудности переноса контекста (в новую сессию или агента);
-
ограничение контекстного окна и суммаризации (контекст ограничен возможностями модели, а контроль за суммаризацией, как один из способов решения проблемы, затруднителен);
-
малая наглядность и проверяемость процесса разработки.
ADR, архитектурные тесты и кейсы из прода: ресурсы, которые реально меняют код
2026-02-18 в 13:15, admin, рубрики: adr, architecture, best practices, clean architecture, cqrs, DDD, Microservices, software architecture, software design, system designУ меня была привычка. Вижу классную статью про архитектуру — сохраняю. Репозиторий с примерами DDD — в закладки. Видео про CQRS — в плейлист «Посмотреть потом».
Вы знаете, чем кончаются плейлисты «Посмотреть потом».
В какой‑то момент закладок стало 300+. Половина ссылок битые, треть дублируют друг друга, остальное - статьи, которые казались гениальными в два часа ночи. Я сел и вычистил всё до 106 ресурсов. Собрал их в awesome-list на GitHub.
Но статья не про список. Статья про три вещи, которые я для себя открыл в процессе и которые почему-то мало обсуждают.
Что не попало и почему
Spec-Driven Development: контроль AI-кодогенерации
2026-01-15 в 13:46, admin, рубрики: adr, ai agent, Specification, архитектураПроблема
Большие MR
4000 строк в одном MR. Три часа на ревью, 12 замечаний, исправления - ещё 800 строк. На четвёртом заходе я закрыл вкладку и понял: проблема не в коде, а в том, что никто не знал, что именно нужно было написать.
Если ты работаешь с большими кодовыми базами, ситуация знакомая. Большие MR - симптом. Когда непонятно, что именно нужно сделать, разработчик пишет больше кода, чем требуется. Добавляет на всякий случай. Покрывает сценарии, которые никто не просил. MR растёт не потому что задача большая, а потому что границы размыты.
Проблемы понимания MVC в ASP.NET MVC и не только
2017-11-20 в 7:30, admin, рубрики: .net, adr, ASP, ASP.NET, asp.net mvc, mvc, архитектура приложений, Веб-разработка, паттерны, Проектирование и рефакторинг, проектирование сайтов, Разработка веб-сайтовСлучалось ли вам делать рефакторинг "толстых" контроллеров? Приходилось ли создавать многоэтажные модели представлений? Добавлять в представление данные и переписывать при этом код контроллера? Казалось ли вам, что что-то идёт неправильно?
Причина в том, что многие MVC-фреймворки не вполне следуют шаблону MVC, а люди, использующие их, сами того не замечая, ещё больше отклоняются от него. Казалось бы, он довольно прост, и описан в Википедии, но раз за разом возникают проблемы его понимания.