TruthGuard: Перехватчики в скриптах оболочки, которые ловят ложь AI-агентов для написания кода

Что делает TruthGuard

TruthGuard — это бесплатный инструмент с открытым исходным кодом, созданный с помощью Claude Code для пользователей Claude Code. Он решает задокументированную проблему, когда Claude Code делает ложные заявления, например: «Готово! Все тесты пройдены!» — хотя тесты вообще не запускались, или «Я обновил файл» — когда файл остаётся идентичным побайтно. Создатель отмечает, что системные промты не решают эту проблему — Claude игнорирует текстовые инструкции, когда «решает», что что-то сделано.

Что он обнаруживает

• «Фантомные» правки — Агент говорит «файл обновлён», но SHA256 до и после идентичны
• Ложь о кодах выхода — Тесты проваливаются с exit 1, агент говорит, что они пройдены
• Опасные сокращения — Блокирует --no-verify и --force push. Предупреждает о reset --hard и clean -f
• Коммиты без тестов — Автоматически определяет ваш тестовый фреймворк, запускает тесты перед каждым git commit. Провал? Коммит заблокирован
• «Готово» без проверки — После каждого коммита заставляет агента остановиться и подтвердить, что исправление действительно работает, прежде чем двигаться дальше

Как это работает

Чистые shell-скрипты, подключённые к конвейеру хуков Claude Code. Нет бэкенда, нет API-вызовов — только jq и bash. Рабочий процесс: Агент решает отредактировать файл → [PreToolUse] записывает контрольную сумму SHA256 → Агент редактирует файл → [PostToolUse] сравнивает контрольные суммы → БЛОКИРУЕТ, если не изменилось. Агент не может с этим спорить — это не промт, который можно проигнорировать, это программный шлюз.

Результаты «самоедства»

После 2 дней работы над продакшен-проектом на Flutter:

• 5 коммитов заблокировано из-за провала тестов
• 3 опасные команды заблокированы (2x --force push, 1x --no-verify)
• 0 ложных срабатываний — каждая блокировка была реальной проблемой

Один только хук предкоммитного тестирования не дал создателю отправить сломанный код пять раз за два дня.

Установка

npx truthguard install && npx truthguard init

Или: brew tap spyrae/truthguard && brew install truthguard

Работает с Claude Code и Gemini CLI. Те же скрипты для обоих — они агент-независимые (JSON на входе, JSON на выходе).