ТЗ на Telegram-бота: bot-spec.md для агента
Команды, состояния диалога, тексты, неожиданный ввод, согласия и ошибки до того, как агент напишет код
Какую задачу решает
Составить ТЗ на Telegram-бота
Что будет на выходе
Документ bot-spec.md: команды, состояния, ошибки, согласия
- Кому подойдёт
Автор канала или эксперт, который хочет бота, но не знает, как его описать агенту
- Тема
- Вайбкодинг
- Инструменты
- любой ИИ-чат
Бот для записи, заявок или выдачи лид-магнита агент напишет быстро. Ломается он потом, в местах, о которых никто не подумал: человек на середине записи нажал /start, прислал голосовое вместо телефона, вернулся через неделю и продолжил с того же шага, или просто отписался, а бот продолжает слать ему напоминания.
Промпт ниже соберёт bot-spec.md: команды и кнопки, состояния диалога и переходы между ними, тексты сообщений, реакцию на неожиданный ввод, согласие на обработку данных и что делать при ошибках. Агент получает ТЗ, по которому понятно, как бот ведёт себя в каждой точке разговора.
Описываешь, что бот должен делать и для кого, отвечаешь на вопросы ИИ и получаешь bot-spec.md: команды, карту состояний, тексты каждого шага, обработку ошибок и неожиданного ввода, согласия и критерии приёмки.
Что получишь
- ⌨️Команды и кнопки
/start, /help, /cancel и твои, плюс какие кнопки показываются на каждом шаге и что делает каждая.
- 🧭Карту состояний
На каком шаге сейчас человек, что бот от него ждёт и куда переходит при каждом ответе.
- 🧯Ошибки и неожиданный ввод
Стикер вместо даты, текст вместо кнопки, упал сервер, человек пропал на середине.
- ✅Согласия и данные
Когда спрашиваем согласие, что храним, как человек может удалить свои данные.
Как использовать
- 1Опиши один главный сценарий
Что человек хочет получить от бота за один заход: записаться, оставить заявку, забрать файл. Остальное — потом.
- 2Отправь шаг 1
Ответь на вопросы ИИ про данные, уведомления и что делать, если человек ушёл посередине.
- 3Получи bot-spec.md
Шаг 2 выдаёт файл целиком. Перечитай тексты сообщений вслух: так ли ты пишешь клиентам.
- 4Отдай агенту
«Собери бота по bot-spec.md, сначала главный сценарий и /cancel, потом напоминания». Проверь по критериям приёмки.
Если хочешь сначала разложить логику бота на шаги без кода, начни с гайда «Псевдокод для вайбкодинга: спроектируй Telegram-бота до генерации кода».
Рядом по теме: статья Как сделать Telegram-бота с ИИ — весь путь от BotFather до сервера, Справочный бот в MAX — если нужен второй мессенджер, и Как написать ТЗ для ИИ-агента — как мы сами описывали бота VIBERZ и что пришлось дописать.
Дальше — для участников
Регистрация бесплатная и занимает минуту. Часть закрытых материалов откроется сразу, без карты.
Что дальше
- Telegram AI-бот для FAQ: MVP с реальным сценарием — если бот должен отвечать на вопросы клиентов.
- Стресс-тест ассистента: поймай на выдумках и почини — как проверить бота с ИИ до запуска.
- Telegram-бот за 30 минут: 3 промпта — бесплатно: агент соберёт по ТЗ бота с меню и заявкой в личку.
- Telegram-бот за два вечера: 8 файлов для Claude Code — по шагам до бота с базой заявок, рассылкой и сервером, 990 ₽.
- Чтобы пройти путь от идеи до работающего экрана или бота с агентом, есть курс Первый экран за 990 ₽.