Для AI-разработки не нужно двадцатистраничное ТЗ. Но фраза «сделай красивый дашборд» — тоже не постановка задачи. Хороший бриф помещается на страницу и отвечает на несколько конкретных вопросов.
- Описывать результат пользователя, а не интерфейс ради интерфейса
- Сразу перечислять данные и права
- Добавлять 3–5 проверочных сценариев до генерации кода
1. Кто будет пользоваться
Не «сотрудники компании», а конкретная роль: менеджер, РОП, бухгалтер, сервис-инженер. Один и тот же экран для разных ролей почти всегда перегружается.
2. Какую работу человек делает сейчас
Опишите текущий обходной путь буквально: «открывает список сделок, выгружает Excel, сверяет с 1С, вручную отмечает просрочки». Именно здесь находится экономический смысл приложения.
3. Как должен выглядеть хороший результат
- что пользователь должен увидеть или получить;
- какое действие он должен выполнить дальше;
- что считается ошибкой;
- какие данные обязательны;
- когда результат нужно обновлять.
4. Какие данные нужны
| Вопрос | Пример |
|---|---|
| Откуда берём | CRM: сделки и компании |
| Что читаем | стадия, сумма, ответственный, дата активности |
| Что меняем | ничего — первый прототип READONLY |
| Что приходит извне | статус оплаты из 1С через готовую интеграцию |
| Кто имеет доступ | РОП видит весь отдел, менеджер — только свои сделки |
5. Какие три сценария нужно проверить
Минимум нужен счастливый путь, пустые/неполные данные и пограничная ситуация. Если калькулятор считает маржу — проверьте обычную сделку, нулевую себестоимость и отсутствующее поле. Если отчёт фильтрует сотрудников — убедитесь, что после фильтра пересчитываются все показатели, а не только таблица.
6. Что не должно происходить
Ограничения часто важнее пожеланий: приложение не меняет сделки, не показывает чужие данные, не создаёт дубли, не отправляет сообщение без подтверждения. Это надо написать до разработки, а не после инцидента.
Готовый короткий шаблон
Пользователь: [роль]. Сейчас он делает: [ручной процесс]. Нужен результат: [что получает]. Данные: [источники и поля]. Действия: [что можно читать/менять]. Ограничения: [что запрещено]. Готово, если проходят сценарии: [3–5 тестов].
Перед тем как закрыть задачу
- ✓Названа конкретная роль
- ✓Описан текущий ручной процесс
- ✓Есть измеримый результат
- ✓Перечислены данные
- ✓Заданы права и запреты
- ✓Есть минимум три тест-кейса
AI может быстро написать код. Поэтому качество постановки задачи становится не менее, а более важным: плохую логику теперь можно автоматизировать очень быстро.
