Prompt debt возникает, когда команда добавляет инструкции для агента быстрее, чем проверяет их необходимость.
В проект команда добавляет AGENTS.md, правила для конкретной модели, обходы старых ошибок, советы по инструментам и дублирующиеся запреты. Через несколько обновлений никто уже не знает, какая строка влияет на результат, а какая только увеличивает контекст.
Удалять такой долг полезно, но сначала инструкции нужно разделить по роли.
Адаптер среды объясняет конкретному агенту, где лежат команды, как запускать проверки и в каком формате возвращать результат. После смены инструмента этот слой можно заменить.
Workflow-инструкция задаёт порядок работы: прочитать контекст, зафиксировать решение, выполнить тест, сохранить доказательство. Её можно упрощать, если эксперимент показывает, что шаг не влияет на безопасность и воспроизводимость.
Product truth описывает поведение, которое нужно пользователю: границы сценария, бизнес-правила, состояния ошибки и восстановления. Это не настройка модели.
Полномочия и приёмка определяют доступ, запрещённые действия, владельца решения и право принять результат. Агент не должен терять эти ограничения вместе с устаревшим prompt-шаблоном.
Для чистки подходит абляция: убрать одну инструкцию, повторить зафиксированные сценарии и сравнить не красоту ответа, а наблюдаемое поведение. Проверка должна показать, сохранил ли агент обязательные артефакты, ссылки на источники, ограничения доступа и границу UAT.
Если удаление фразы не меняет эти свойства в серии прогонов, у команды появляется основание сократить инструкцию. Если после удаления агент пропускает конфликт источников или сам принимает результат, строка защищала важный контракт, даже если выглядела как техническая деталь.
Есть и обратная ошибка: хранить product truth только внутри prompt-файла конкретного агента. Тогда смена модели требует миграции требований, а несколько адаптеров начинают описывать продукт по-разному.
Более устойчивое разделение выглядит так:
источники и решения → сценарии и критерии → общий workflow → адаптер конкретного агента
Prompt debt можно удалять. Продуктовую правду, permissions, evidence contract и UAT нужно переносить в независимые артефакты и проверять отдельно. Иначе оптимизация контекста незаметно меняет сам объект, который агент должен построить.
