Почему длинные промпты не работают
Самая частая ошибка при работе с AI: написать всё в одном неструктурированном абзаце. Контекст, ограничения, задачу, формат вывода, всё свалить в кучу. Claude 4.x выполняет то, что вы просите, буквально. Если в промпте каша, в ответе будет каша.
Исследования от Anthropic и DreamHost показали: структурированный короткий промпт из 4-5 строк работает лучше длинного на 20 строк. Потому что модель чётко видит что от неё хотят, а не вынуждена интерпретировать поток сознания.
Четыре блока
INSTRUCTIONS: роль и правила. Кто ты, чего не делать. Например: Ты senior backend-разработчик. Не используй ORM, пиши сырые SQL-запросы.
CONTEXT: данные, файлы, ограничения. Проект на FastAPI, Python 3.12, PostgreSQL 16. Есть существующий модуль auth в src/auth/.
TASK: конкретное задание. Создай эндпоинт /users с пагинацией через cursor. Валидация через Pydantic v2.
OUTPUT FORMAT: формат вывода. Только код, без объяснений. TypeScript strict. Один файл.
Два совета которые реально помогают
Первый: объясняйте почему правила существуют, а не просто перечисляйте их. Claude обобщает лучше, когда понимает мотивацию. Вместо "Не используй any" напишите "Не используй any, потому что в этом проекте strict TypeScript и любой any ломает CI".
Второй: давайте AI явное разрешение сказать "не уверен". Модели галлюцинируют реже, когда им разрешено не знать. Добавьте в инструкции: "Если не уверен в синтаксисе или API, скажи прямо, не додумывай".