Откат: Реализация на основе хуков утечек верификационных циклов Claude

Clawback — это проект на GitHub, который реализует циклы проверки из утечки исходной карты Claude как механические хуки, а не промпты. Этот подход решает проблему, когда проверка на основе промптов (например, "you are FORBIDDEN from completing without running tsc" в iamfakeguru/claude-md) может быть пропущена моделью под давлением контекста.

Архитектура хуков

Система разделяет проблему на два уровня:

• Хуки (механические, нельзя пропустить):
  • Стоп-хук: Запускает проверку типов и линтинг, когда Claude пытается завершить работу. Если проверка не проходит, выход с кодом 2, вынуждая Claude продолжать исправления. Три последовательных неудачных блока запускают автоматическое прерывание.
  • PostToolUse: Автоматически форматирует и проверяет код после каждого редактирования файла.
  • PreToolUse: Блокирует редактирование .env и lock-файлов до того, как Claude их коснётся.
  • PostCompact: Повторно внедряет состояние git и gotchas.md после сжатия контекста.
• CLAUDE.md (поведенческий): Для того, что хуки не могут обеспечить, включая поэтапное выполнение (≤5 файлов за этап), разделение планирования и сборки, осознание деградации контекста и логирование ошибок.

Технические детали

Инструмент автоматически определяет стек, ища файлы конфигурации: tsconfig.json, go.mod, Cargo.toml, pyproject.toml и composer.json. Он не требует настройки и не имеет зависимостей. Clawback работает вместе с проектом CLAUDE.md от iamfakeguru, а не вместо него.

Реализация основана на утёкших циклах проверки, которые были скрыты за USER_TYPE === 'ant' в исходной карте. Репозиторий на GitHub доступен по адресу https://github.com/LZong-tw/clawback.