Описывай симптомы, не диагноз. Иначе агент будет подтверждать твою гипотезу, а не искать причину.
Описание
Разработчик описывает симптомы, а не свою гипотезу о причине. Это аналог общения с врачом: симптомы — пациент, диагноз — врач. Если задать ошибочное направление, агент будет подтверждать его, а не искать настоящую причину.
Предусловия
- Есть воспроизводимый симптом (страница не открывается, тест падает, запрос возвращает не то)
- Сессия в Plan Mode (см. UC-001 · Plan Mode)
Постусловия / гарантия успеха
- Агент сформировал собственную гипотезу о причине
- Гипотеза подкреплена проверками (curl, чтение конфигов, DevTools)
Основной сценарий
- Разработчик описывает наблюдаемое поведение в общих терминах («не открывается сайт проекта», «не работает фронт»)
- Агент сам формулирует гипотезы, выполняет проверки (порт, конфиг, лог)
- Агент возвращает анализ причины и предлагает решение
- Разработчик подтверждает направление или просит рассмотреть альтернативы
Расширения / альтернативные потоки
- 3a. Если агент предлагает менять дефолт фреймворка — разработчик задаёт встречный вопрос «нормально ли это», избегая наводящих формулировок
Исключения и риски
Бизнес-правила и ограничения
- Не сообщать агенту свою гипотезу о причине ошибки до того, как он сделает анализ
- Не подсказывать конкретное решение, если задача — разобраться в проблеме
Примечания
Дорогие топовые модели лучше сопротивляются навязанным гипотезам, дешёвые и старые — хуже; это дополнительный аргумент в пользу осознанного выбора модели (UC-010 · Выбор модели под задачу).
Частые вопросы
Это противоречит совету «давай агенту больше контекста»?+
Нет. Контекст ≠ гипотеза. Дайте всё про симптом и окружение, но не предлагайте свою версию причины. Это разные вещи.
А если я уверен в причине?+
Тогда не нужен агент — правьте сами. Агент полезен там, где есть неопределённость; и навязанная гипотеза эту неопределённость убивает раньше времени.
Топовые модели меньше подвержены этому?+
Да. Дорогие топовые модели (Opus, GPT-5, Gemini Ultra) лучше сопротивляются навязанным гипотезам, дешёвые и старые — хуже. Это аргумент в пользу осознанного выбора модели.
Как сформулировать задачу нейтрально?+
Шаблон: «При [действии] происходит [симптом]. Ожидал [ожидание]. Разберись, в чём причина». Никаких «думаю, дело в...» до того, как агент проведёт диагностику.