Footgun

Ваш AI-агент знает, как работает API. Footgun подсказывает, как оно может сломаться.

Footgun — это актуальный реестр проверенных ловушек, о которых умалчивает документация: незаметно устаревшие функции, скрытые ограничения, настройки, которые сохраняются, но ничего не меняют. Прежде чем писать код, ваш агент проверяет реестр. Изучите все ловушки на getfootgun.com.

Это помогает?

В 17 задачах программирования, связанных с недавними изменениями API, Claude Code запускали по 5 раз для каждой задачи. С Footgun он с первого раза справился с кодом в 82% случаев, а без него — в 52%. При этом стоимость каждого рабочего результата была на 18% ниже. Для более старых API, которые модель уже знает, разницы не было. Методика и полные результаты доступны на getfootgun.com/benchmark.

Что мы обнаружили в 200 приложениях, созданных с помощью AI

В 89 из 200 приложений используются GitHub Actions, рассчитанные на Node 20, хотя GitHub теперь запускает их на Node 24. В 93 приложениях есть как минимум одна проблема, которая уже вызывает сбой или приведёт к нему в будущем. В подсчёт включались только правила, которые проверили на реальном коде. Методика и результаты доступны на getfootgun.com/scan.

Установка в Claude Code

/plugin marketplace add getfootgun/footgun
/plugin install footgun@footgun

Искать ловушки и отправлять новые записи можно без учётной записи. Перед тем как стать доступными другим пользователям, отправленные ловушки проверяются по официальным источникам. Чтобы подтверждать ловушки, создайте API-ключ на getfootgun.com/account и введите его по запросу плагина.

Плагин также добавляет команду /footgun:scan, которая проверяет проект на вашем компьютере и ищет известные ловушки в используемых вами версиях пакетов. Ваш код не покидает компьютер: отправляются только загрузка правил и анонимный счётчик обнаруженных проблем. Отключите настройку плагина share_learnings, чтобы прекратить отправку счётчика и исправлений, которые агент выявляет и отправляет. Настройка auto_context добавляет краткую заметку об этих ловушках в начале каждого сеанса. По умолчанию она включена; задайте ей значение false, чтобы отключить её.

Командная строка

В cli/ находится тот же сканер, доступный как команда и опубликованный в npm под именем @getfootgun/footgun: npx @getfootgun/footgun scan [path] (Node 20 или новее). Добавьте --json, чтобы получить вывод в машиночитаемом формате, или --fail-on breaks, чтобы завершить задачу CI с ошибкой.

Другие MCP-клиенты

claude mcp add --transport http footgun https://getfootgun.com/api/mcp

В Cursor, Codex и других клиентах укажите адрес https://getfootgun.com/api/mcp (streamable HTTP). Чтобы отправлять и подтверждать ловушки, добавьте заголовок Authorization: Bearer .

Данные

В data/traps//.json хранятся все общедоступные проверенные ловушки: симптомы, причина, решение, дата последней проверки и оценка достоверности. В data/providers.json перечислены поддерживаемые инструменты. Данные экспортируются с getfootgun.com и обновляются при добавлении, подтверждении или удалении ловушек.

Лицензия

Данные о ловушках в data/ распространяются по лицензии CC BY 4.0. Указывайте авторство: «Footgun, getfootgun.com». Файлы плагина распространяются по лицензии MIT (см. LICENSE).