Псевдокод для вайбкодинга: спроектируй Telegram-бота до генерации кода

Почему стоит начать не с кода

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

Результат: понятная схема состояний и псевдокод для AI-разработчика. Отличие от обычного ТЗ: мы явно описываем ветвления и исключения, чтобы агент не «додумывал» сценарии самостоятельно.

1. Определи границы

Учебный MVP: бот по команде /start предлагает одну кнопку «Получить материал», показывает правила обработки данных при необходимости и отправляет материал по подтверждённому действию.

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

2. Простая машина состояний

START
  → пользователь впервые?
      да → показать краткое описание и кнопку
      нет → показать меню и возможность повторной выдачи
  → нажата кнопка «Получить материал»?
      нет → ждать действие, не рассылать сообщения
      да → доступен материал?
          нет → сообщить об ошибке, показать действие «Попробовать позже»
          да → отправить материал, записать успешную выдачу без лишних данных
  → END

Это схема логики, ещё без кода. Идентификаторы пользователей храни только если это требуется функции; сроки хранения и доступы определяй отдельно.

Как выглядит кусок такого псевдокода

Вот одна развилка — момент, когда человек нажал «Получить чек-лист»:

ЕСЛИ пользователь не подписан на канал:
    показать кнопки «Подписаться» и «Проверить»
    состояние → ждём_подписку
ИНАЧЕ ЕСЛИ чек-лист уже выдавали:
    отправить ссылку ещё раз, в базу ничего не писать
ИНАЧЕ:
    отправить файл, записать дату выдачи
ПРИ ОШИБКЕ Telegram API:
    повторить через 5 секунд, после третьей неудачи написать админу

Десяток строк, а в них уже есть ответы на вопросы, которые агент иначе решил бы сам: выдавать ли повторно, что хранить, кого звать при сбое. Такой текст понимает и человек без опыта программирования, и Claude Code или Cursor, которые потом пишут по нему код. А если бот всё равно поведёт себя странно, ты сразу видишь, какая ветка не сработала.

Рядом по теме: статья Как сделать Telegram-бота с ИИ, Telegram-бот для FAQ, который не выдумывает ответы, статья Как написать ТЗ для ИИ-агента и бесплатный чек-лист «Перед запуском» — согласие на данные и защита базы до первых пользователей.