Что такое Anti-Mirage и как бороться с галлюцинациями?

Anti-Mirage — набор правил, которые предотвращают галлюцинации до того, как они попадут в код. Claude любит «фантазировать» — это его главная слабость при генерации кода.

Типичные миражи

• Несуществующий файл — «Отредактируй src/utils/helpers.py» (его нет)
• Несуществующая функция — «Вызови user.get_full_name()» (метода нет, он называется get_name)
• Устаревший API — «Используй requests.get_async()» (нет такого метода)
• Фантомный пакет — «Установи fastapi-cache3» (не существует в PyPI)
• Фантомное поле БД — «WHERE user.role = admin» (поля role нет в схеме)

Правила проверки

• Перед ссылкой на файл — mgrep или ls/find
• Перед вызовом функции — mgrep "functionName" в кодовой базе
• Перед импортом пакета — проверить package.json/pyproject.toml
• Перед ссылкой на поле БД — проверить schema/migrations
• Перед использованием API — документация через context7
• Перед упоминанием конфига — проверить .env.example

Интеграция

Добавь правила в rules/anti-mirage.md проекта. Anti-mirage check выполняется автоматически как часть Quality Gates и никогда не пропускается — даже по команде skip review. Это слишком дёшево и слишком ценно.