В прошлом уроке вы собрали сайт-портфолио. Пока он небольшой, агент будет легко читать его целиком и понимать, что и где лежит. Но представьте: вы решили добавить блог. Или фильтры по проектам. Или живую форму обратной связи. В проекте станет в разы больше кода, и агент начнет в нем путаться.
Похожая проблема уже встречалась в уроке 8. Тогда контекст чата переполнялся, и агент начинал забывать, о чем вы с ним говорили. Мы решили ее на уровне чатов: один чат — одна задача. Сегодня решим на уровне самого проекта и наведем порядок в коде и документации.
Есть и еще одна проблема. Каждую новую функцию нужно куда-то встроить, и агент должен понимать, в каком файле что лежит. Без понятной структуры вы будете объяснять это ему каждый раз вручную или ждать, пока он сам разберется, перечитывая файлы подряд. Хуже того, агент может прочитать один кусок файла, уйти работать с ним и забыть про остальное. Тогда он сломает одно, пытаясь починить другое.
Поэтому с архитектурой лучше разобраться сейчас, пока проект еще маленький. Начать с нормальной структуры проще, чем переделывать потом, когда все уже разрослось.
Сейчас в нашем проекте все сложено в одну кучу: форма обратной связи, карточки проектов, меню и анимации — все перемешано в одних и тех же файлах. Когда вы попросите агента поправить форму, ему придется читать весь проект. Иначе он просто не найдет, где эта форма лежит.
Если разбить проект на…