Архитектура

Бизнес-логика проекта

Структура модулей и тесты с агентом.

Вернуться в примеры

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

Вечер один: узкий запрос, затем diff, затем одна вторая правка по теме «Бизнес-логика проекта». Не смешивайте её в том же диалоге с оплатой, деплоем или «перепиши проект».

Бизнес-логика проекта: как выглядит результат

Какие границы у модулей

Сначала закройте это: Папки по смыслу: domain, api, db — как принято у вас, не как «красиво модели». Пока пункта нет в diff, к следующей правке не переходите.

Дальше держите условие «3–5 тестов на главное правило (например, нельзя создать заказ без позиции)». Если агент принёс соседнюю задачу, отклоните diff и повторите запрос без неё.

Отдельной границей остаётся вот что: README на полстраницы: что система делает и чего не делает. Это не пожелание на потом.

В списке ещё пункт «Запрет в rules: не переименовывать модули без просьбы, не тащить новый фреймворк». Короткий diff с ним полезнее длинного «я ещё улучшил».

Всё это умещается в первое сообщение. Вторую тему в него не добавляйте, даже если она кажется соседней.

Папка и первый запрос

Откройте пустую папку через File → Open Folder. Не домашний каталог и не рабочий стол: иначе агент читает чужие файлы и правит не тот проект.

Первое сообщение для «Бизнес-логика проекта» — на один экран:

Первый запрос агенту

Плохо звучит «сделай нормально». Хорошо звучит просьба, которая начинается с «Папки по смыслу: domain, api, db — как принято у вас, не как «красиво модели»». После ответа откройте результат сами. Если страница, бот или команда молчит — вставьте агенту текст ошибки, а не слово «не работает».

Каркас модулей

В diff ищете главный файл, не пачку новых зависимостей. Следующее сообщение указывайте через @ на этот файл, чтобы агент не создал копию рядом.

Главный файл

В файле должна читаться тема «Бизнес-логика проекта». Ключей, паролей и чужих репозиториев рядом быть не должно. Лишний фреймворк — повод отклонить diff.

Один инвариант тестом

Вторая задача одна. Не просите заодно тесты, деплой и новый дизайн.

Вторая правка

Дайте инвариант текстом: «сумма заказа = сумма позиций, иначе 400». Потом @ на модуль и тесты. Не просите «сделай архитектуру как в FAANG».

Если агент тащит репозиторий в один файл — остановите и укажите границы. Diff должен быть коротким.

Если на эту правку открылось больше пары файлов, оставьте только то, что относится к «Бизнес-логика проекта».

Если агент уехал в сторону

Откатите лишнее. Для этой темы хватает трёх фраз:

  • «верни только файлы из первого запроса, соседние проекты не трогай»;
  • «не добавляй пакет и аналитику, если их не было в списке: Папки по смыслу: domain, api, db — как принято у вас, не как «красиво модели»»;
  • «секреты не пиши в код и не проси прислать их в чат».

Короткий diff лучше длинного, который заодно переименовал половину репозитория.

Какие файлы нормальны

После вечера достаточно папки модулей, тест на инвариант и README на полстраницы. node_modules и сборки в git не кладите.

Тексты и подписи меняйте отдельно: «замени формулировки, структуру файлов не трогай». Тема вечера остаётся прежней: Бизнес-логика проекта.

Когда структура готова

Проверьте сами то, что обещает описание: Структура модулей и тесты с агентом. Когда это видно без чата агента, можно открыть связанные материалы: Rules, Chat vs Agent, как начать.

Следующий пример из каталога начинайте новым чатом.

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