Первый эпик готов, сейчас расскажу о том, что сделано и какие были проблемы Что сделали:

Развернули проект с нуля — установили все библиотеки, подняли Docker, настроили роутинг. Написали схемы базы данных, типизацию, миграции. Добавили скрипт который заполняет базу тестовыми данными (карточки теории, практики, пользователь и т.д.)

Реализовал вход для себя через Telegram и Magic Link (по ссылке на почту) — без пароля. Также сделал защиту от подбора email, путем ограничения попыток входа, чтобы никто лишний не мог попасть внутрь.

—

Какие проблемы возникли:

Архитектура базы данных — агенты сделали так, что за один тест из 20 вопросов в базу улетало бы 20 отдельных записей от одного пользователя. При тысячах пользователей (я оптимист 😄) база раздулась бы до огромных размеров.

Хорошо, что я сам залез в БД посмотреть что там, а то было бы неприятно потом это обнаружить. Договорились, что в начале каждой важной задачи кратко обсуждаем архитектуру, я "окаю" и только потом агенты идут писать код.

Установка зависимостей — Claude не смог установить Next T3 Stack и shadcn/ui самостоятельно — там интерактивное меню при установке, которое он не может пройти. Он попросил меня сделать это руками. T3 я установил, а про shadcn я не увидел и не установил его 😄

В итоге во время первой стори смотрю — агент начал сам писать UI-компоненты с нуля. Спрашиваю — а что за дела? Отвечает — ну shadcn не установлен, вот и пишу сам.

В итоге я ручками установил, сказал ему и всё стало окей.

Git flow — в BMAD не предусмотрено из коробки. Объяснил Claude что нужно, он сам нашёл подходящий workflow и настроил. Теперь есть три ветки: main, dev и ветка под каждую фичу. Фича готова — сливается в dev. Эпик готов — сливается в main. Windows-окружение — агенты регулярно пытались запускать Linux-команды, которые на Windows не работают. После разбора полётов добавили часто используемые команды и паттерны в CLAUDE.md — теперь агенты знают правила.

—

Первый эпик закрыт. Идём дальше.

В следующем эпике делаем UI и функционал админки.