Ra200717 июн в 21:28

Clean Architecture и AI: как я перестроил проект на 200К строк, чтобы агенты не ломали код

Средний

11 мин

14K

Искусственный интеллектПрограммирование * JavaScript * TypeScript *

Кейс

+20

Комментарии 12

TENEVIK 17 июн в 21:48

200к строк это небольшой проект, это излишество, он целиком влезает в контекст опуса

а для более крупных надо просто заранее продумывать архитектуру

Genius_Russian_Coders 18 июн в 01:10

Та же проблема в проекте ~150К строк. Bounded contexts + контракты помогают, но AI всё равно не видит сайд-эффекты на стыках модулей. Как решаете?

TENEVIK 18 июн в 23:30

150к строк полностью влезает в контекст нейронки

Ra2007 22 часа назад

Сайд-эффекты на стыках это как раз больное место. У нас агент не видел, что репозиторий дёргает вебхук, пока это не было явно в типе порта. Помогли две вещи: эффект стал частью контракта (порт описывает что он триггерит, а не только что возвращает), и интеграционные тесты ровно на стыках модулей, которые агент обязан прогнать. Дрейф ловится там, а не в юнит-тестах.

Ra2007 22 часа назад

Дело не в том, влезает проект в контекст или нет. Даже когда модель видит все 200к разом, она лезет через границу: чинит баг, дёрнув приватную функцию из соседнего модуля, потому что так короче. Архитектура нужна не чтобы уместить в окно, а чтобы агент не обходил контракт даже когда видит весь код. Продумать заранее согласен, но тут legacy, который уже есть, с нуля переписать не вариант.

codecity 17 июн в 23:34

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

Ra2007 22 часа назад

Да, именно физический уровень. У нас границы вынесены в отдельные пакеты, импорт из чужого внутреннего модуля просто не напишется, eslint-boundaries рубит на корню. Пока контракт можно обойти по-человечески, агент рано или поздно это сделает, причём в самый неудобный момент. Когда обойти физически нельзя, выбора у него не остаётся.