Дисциплина промптов
Inputs определяют outputs. Как ставить задачу агенту — контекст, конкретика, примеры, итерации — чтобы получать то, что нужно, а не правдоподобную воду.
Самый частый источник плохих результатов — не «тупой агент», а расплывчатый запрос. Агент не читает мысли, он читает текст. Старое правило живо: garbage in — garbage out.
Дисциплина промптов — это не магические заклинания, а несколько простых привычек.
Давай контекст, а не только вопрос
Сравни:
❌ напиши тесты для логина
✅ напиши e2e-тест на Playwright для формы логина (/login):
проверь успешный вход и ошибку при неверном пароле.
Селекторы бери по data-testid. Стиль — как в tests/auth/*.spec.tsВторой вариант задаёт цель, ограничения, формат и пример для подражания. Агенту больше не нужно угадывать — и он перестаёт фантазировать.
Уточняй отрицанием: «это не X, а Y»
Мощный приём, когда агент уходит не туда: явно скажи, чего не надо.
«Мне нужен не общий обзор фреймворка, а конкретно — как замокать сетевой запрос в этом тесте.»
Отсечь неверное направление часто полезнее, чем долго описывать верное.
Конкретика побеждает абстракцию
- Вместо «сделай нормально» → что значит «нормально»: какие кейсы, какой результат, какие крайние случаи.
- Вместо «почини баг» → что происходит, что ожидалось, как воспроизвести.
- Покажи пример желаемого (few-shot): «вот как у нас выглядит тест-кейс: … сделай так же для X». Один пример экономит абзац объяснений.
Итерируй, а не начинай заново
Не понравился ответ — уточни в том же диалоге, а не открывай новую сессию. В текущем окне уже накоплен контекст: прочитанные файлы, договорённости, твой стиль. Начав заново, ты всё это теряешь (см. как устроено контекст-окно).
На сложной задаче не бросайся сразу в код — попроси сначала план. Это отдельная практика: планирование и фичи.
Коротко
Цель + ограничения + пример + «чего не надо». Чем меньше агенту приходится угадывать, тем меньше он выдумывает.
Проверь себя
1. Какой запрос даст более предсказуемый результат?
2. Агент упорно уходит не в ту сторону. Что часто помогает быстрее всего?
3. Ответ не устроил. Что лучше сделать?
Как Claude Code устроен
Агентная петля, контекст-окно и предсказание токенов — почему агент «забывает», иногда врёт и каждый раз отвечает по-разному. Правильная картина в голове.
Планирование и фичи
Сначала план, потом код. Почему стоит дробить работу на маленькие законченные куски и сверять подход до правок — а не просить «сделай всё сразу».