Данные были публичными, а путь агента — нет. Поэтому его мок стал моей документацией.

Разработчик недавно внес вклад в open-source проект, пытаясь исправить проблемы с генерацией запросов ИИ-агента. Поскольку агент использовал аутентифицируемый эндпоинт, недоступный для стороннего разработчика, тот создал локальный мок схемы для тестирования. Это привело к серьезной проблеме: предложенная схема содержала имена полей, отличающиеся от реальной базы данных. Эти некорректные данные попали в документацию проекта, превратив предположения в официальное руководство. Автор подчеркивает риски предоставления путей воспроизведения, которые не соответствуют реальной архитектуре системы. Главный вывод для мейнтейнеров заключается в необходимости предоставления канонических, воспроизводимых контрактов для привилегированных зависимостей. Это позволяет участникам тестировать код на реальном интерфейсе без необходимости получения внутренних учетных данных, предотвращая случайное распространение неверных предположений в документации проекта.