С чего начать первый проект с ИИ

Опишите одну конкретную задачу пользователя, договоритесь с агентом о границах первой версии и заранее решите, как проверите результат. Рабочая версия должна сохранять данные и проходить весь обещанный путь после повторного запуска. Красивые экраны и зелёные отчёты агента полезны, но не заменяют эту проверку.

Один проверяемый путь: следующий шаг — после проверки предыдущего

  1. Описать путь

    Действия пользователя и результат каждого действия

  2. Согласовать

    Агент пересказывает задачу и задаёт вопросы до кода

  3. Собрать

    Один небольшой, но завершённый путь без скрытых заглушек

  4. Проверить и расширить

    Пройти путь вручную, сохранить рабочую версию, затем добавлять функции

Почему мою первую попытку пришлось начать заново

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

Первая попытка

Начал с большой расплывчатой идеи

  • Слишком общее описание для агента
  • Много лишнего в основе, особенно в базе данных
  • Часть возможностей осталась заготовками
  • Через несколько дней проще было начать заново
Вторая попытка

Начал с ограниченного объёма

  • Сначала ограничил, что входит в версию
  • Проверил основу
  • Лишь затем добавлял функции

Во второй попытке я сначала ограничил объём, проверил основу и лишь затем стал добавлять функции. Я не программист и не предлагаю универсальную архитектуру. Это опыт человека, который учился ставить агенту проверяемые задачи. Под агентом здесь понимаю инструмент, способный менять файлы проекта и запускать проверки; небольшая локальная модель может требовать гораздо более подробного участия человека.

Опишите путь пользователя вместо общей идеи

Я бы сразу указал: пока пользуюсь один и только на компьютере; семейный доступ, напоминания и подписка в первую версию не входят. Агенту проще работать, когда известны действия, ограничения и наблюдаемый результат. До кода полезно попросить его коротко пересказать задачу и назвать недостающие решения. Например, доступ с телефона заметно меняет объём работы.

Как отличить рабочую версию от макета

MVP — полезная идея: небольшой продукт помогает проверить замысел. Проблема возникает, когда слово «минимальный» скрывает недоделанный основной путь. Проверьте себя на простом примере.

Проверьте себя

Кнопка «Войти» пропускает любое имя. Можно ли так оставить в первой версии?

Критерии первой версии дневника

  • Карточка питомца создаётся и открывается после повторного запуска.
  • Запись добавляется с датой и появляется в истории.
  • Исправление: изменённый текст сохраняется, а старая ошибка исчезает.
  • Хранение: после закрытия или обновления записи остаются на месте.

Не обязательно заранее строить поддержку всех будущих функций. Достаточно понимать, где лежат данные и что сейчас действительно работает. Если агент предлагает временную имитацию, попросите показать её и объяснить, как она влияет на обещанный путь.

Как передать дизайн агенту

Для интерфейса мне помогает выбранный визуальный пример: сначала сравниваю несколько направлений, затем фиксирую шрифт, цвета, кнопки и основные отступы. Вместо «сделай красиво» говорю, что именно изменить в макете или готовом экране.

  • Пустое состояние: что видит человек до первой записи.
  • Длинные имена и записи: не выходит ли текст за границы карточки.
  • Ошибка сохранения: понятно ли, что запись не сохранилась.
  • Узкий экран: требуется ли он этой версии и как ведёт себя интерфейс.

Макет показывает идеальные данные. После реализации я открываю приложение сам и описываю конкретный дефект: «заголовок вылезает за карточку». Такой отзыв агент может воспроизвести и проверить.

Git, ошибки и данные: три разные задачи

Git хранит историю проекта, но не возвращает автоматически удалённые записи из базы. Если агент предлагает Docker, стоит отдельно уточнить, где данные будут храниться после пересоздания контейнера. Для маленького первого проекта сам Docker может быть не нужен.

Как проверить, что агент закончил

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

Ручная приёмка: пройти путь как пользователь

  1. Шаг 1Основной путь

    Создайте карточку и запись, затем исправьте запись.

  2. Шаг 2Перезапуск

    Обновите страницу или закройте и заново запустите программу; убедитесь, что изменения остались.

  3. Шаг 3Пограничные случаи

    Попробуйте пустое поле, длинный текст и ситуацию без результатов поиска.

  4. Шаг 4Сбои

    Проверьте сообщения о сбоях и повторите сценарий после исправления.

Как сообщить о сбое и продолжить в новом чате

Фраза «всё сломалось» оставляет агенту мало зацепок. Полезнее указать последовательность действий, ожидаемый и фактический результат. После исправления нужно снова пройти именно этот путь. Перед передачей скриншотов уберите ключи, пароли и чужие данные.

Как сообщить агенту о сбое

Мало зацепок

«Всё сломалось»

  • Непонятно, какие действия привели к сбою
  • Нет ожидаемого и фактического результата
  • Агенту нечего воспроизвести
Можно воспроизвести

Шаги, ожидание и факт

  • «Добавляю запись и нажимаю сохранить — она видна»
  • «После обновления страницы записи нет. Повторил дважды»
  • «Вот сообщение из консоли»

Короткая передача состояния

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