Контракты промптов
Выбирай структуру результата заранее
Структура организует информацию и направляет внимание. Markdown, JSON и XML хорошо работают, потому что это насыщенные информацией форматы, широко представленные в обучающих данных. Выбери форму до того, как детали начнут конкурировать за внимание.
# Задача: Подготовь запись архитектурного решения о переводе генерации отчётов с синхронных запросов на асинхронные задания.
## Контекст- При пиковой нагрузке корпоративные отчёты завершаются по тайм-ауту.- Клиенты ожидают возможность скачивать отчёты и уведомления по электронной почте.- Поддержке нужен понятный статус задержавшихся заданий.
## Ограничения- Сохрани существующий контракт API во время развёртывания.- Веди журнал аудита для каждого созданного отчёта.- Обеспечь откат без потери выполняющейся работы.
## Варианты1. Асинхронные задания с очередью2. Пакетная генерация по расписанию3. Сохранить синхронный процесс и оптимизировать запросы
## Верни- Рекомендацию с компромиссами- План развёртывания и отката- Пробелы наблюдаемости и критерии валидации
Структура делает решение пригодным для ревью: почему это важно, что нельзя сломать, какие варианты рассмотрены и как будет проверяться успех.
Добавляй ограничения как защитные рамки
Без ограничений модель заполняет пробелы предположениями. Задавай границы явно.
Без ограничений
Перенеси обработку файлов в фоновые задания.
С ограничениями
Разработай план миграции обработки файлов с синхронных запросов API на асинхронные задания.
Ограничения:
- Сохрани текущий контракт ответов API во время развёртывания.
- Не допускай видимых пользователю регрессий в отображении хода загрузки и восстановлении после ошибок.
- Сохрани журналы аудита и гарантии идемпотентности.
- Не меняй схему без плана заполнения существующих данных и отката.
Верни затронутые системы, этапы миграции, риски, необходимые доказательства и решения, требующие одобрения человека.
Ограничения:
- Сохрани текущий контракт ответов API во время развёртывания.
- Не допускай видимых пользователю регрессий в отображении хода загрузки и восстановлении после ошибок.
- Сохрани журналы аудита и гарантии идемпотентности.
- Не меняй схему без плана заполнения существующих данных и отката.
Верни затронутые системы, этапы миграции, риски, необходимые доказательства и решения, требующие одобрения человека.
Версия без ограничений подталкивает агента немедленно начать реализацию. Версия с ограничениями задаёт допустимые условия работы ещё до появления кода.