Архитектура файлов — чтобы ИИ не терялся в вашем проекте

В прошлом уроке вы собрали сайт-портфолио. Пока он небольшой, агент будет легко читать его целиком и понимать, что и где лежит. Но представьте: вы решили добавить блог. Или фильтры по проектам. Или живую форму обратной связи. В проекте станет в разы больше кода, и агент начнет в нем путаться.

Похожая проблема уже встречалась в уроке 8. Тогда контекст чата переполнялся, и агент начинал забывать, о чем вы с ним говорили. Мы решили ее на уровне чатов: один чат — одна задача. Сегодня решим на уровне самого проекта и наведем порядок в коде и документации.

Есть и еще одна проблема. Каждую новую функцию нужно куда-то встроить, и агент должен понимать, в каком файле что лежит. Без понятной структуры вы будете объяснять это ему каждый раз вручную или ждать, пока он сам разберется, перечитывая файлы подряд. Хуже того, агент может прочитать один кусок файла, уйти работать с ним и забыть про остальное. Тогда он сломает одно, пытаясь починить другое.

Поэтому с архитектурой лучше разобраться сейчас, пока проект еще маленький. Начать с нормальной структуры проще, чем переделывать потом, когда все уже разрослось.

Один файл — одна задача