Andon — плагин
Плагин ловит ложное «готово» от агента: хук Stop требует доказательств, а каждый дефект превращается в постоянную защиту
- 168 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки Stop, UserPromptSubmit и PreToolUse выполняют скрипты Python на каждом шаге агента и могут блокировать ответ
- Журналы проверок и память проекта хранятся в файлах, которые попадают в репозиторий, если их не исключить
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/andonОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки Stop, UserPromptSubmit и PreToolUse выполняют скрипты Python на каждом шаге агента и могут блокировать ответ
- Журналы проверок и память проекта хранятся в файлах, которые попадают в репозиторий, если их не исключить
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Andon переносит приемы бережливого производства на работу с ИИ-агентом. Название взято от шнура на линии Toyota, за который тянут, чтобы остановить конвейер. Плагин ставится в Claude Code и Codex и включает три хука. Хук Stop, проверка заявлений, находит фразы о завершении вроде «миграция готова, тесты исправлены» и сверяет их с записями о проверке. В режиме предупреждения он просит доказательство, в режиме блокировки возвращает решение остановиться. Хук UserPromptSubmit читает `memory/MEMORY.md` проекта в начале сессии. Хук PreToolUse защищает от конвейеров с тестами, которые скрывают статус, и по умолчанию выключен. В набор входят команды `/andon:wrap`, `/andon:orient` и `/andon:log-mistake` и пять агентов: researcher, auditor, memory-steward, builder и chief-of-staff. Команда `andon-log-claim "что утверждаю" "как проверил"` записывает проверенное заявление, которое затем читает хук. Проект идет по четырем слоям: файл памяти, цикл завершения и ориентации, шнур Stop и дисциплина дорожек. В `DEFECT_LEDGER.md` каждый дефект записан цепочкой причина, мера, результат с датой пересмотра. Просроченная мера роняет тесты.
Для кого. Тем, кто работает в агенте каждый день и устал от повторов одной и той же ошибки и от «готово» при красных тестах.
Подходит, если
- Агент объявляет работу завершенной, а тесты не запускались, и хук Stop должен потребовать доказательство
- Проект возобновляют через три месяца, и агент по `memory/MEMORY.md` сразу знает стек, правила и решения
- Повторяющуюся ошибку записывают командой `/andon:log-mistake` и закрывают мерой, например хуком или тестом
- В конце сессии `/andon:wrap` сохраняет итоги, чтобы следующая начиналась с ориентации через `/andon:orient`
Не подходит, если
- Нужна только память между сессиями: автор прямо советует взять более легкий репозиторий с памятью
- Нужен хук в Cursor, Cline, Windsurf или Aider: для них шаблоны копируют вручную, а работа хуков не проверялась
- Нужна проверка фактического выполнения: агент сам пишет запись о проверке, и совпадение слов может принять посторонний результат
Пример запроса к агенту
Поставь Andon, оставь проверку заявлений в режиме предупреждения и покажи, как хук реагирует на фразу «миграция готова»Ограничения
Хук сопоставляет слова заявления и записи о проверке, поэтому по словам он может принять посторонний результат или выдуманную запись. Автор советует держать режим предупреждения, пока вы не проверили поведение на своей работе, и только потом включать блокировку. В Codex хуки работают после того, как вы доверите их в `/hooks`, предупреждающий текст в `codex exec` не показывается. Режимы доказательств `tool` и `both` читают только транскрипт Claude Code. Плагин и ручная установка хуков не должны стоять одновременно. Нужны Python 3 и каталог проекта с `memory/`.
Как отключить. В Claude Code выполните `/plugin uninstall andon@primefold-tools`, в Codex отключите плагин и хуки в `/hooks`. Папка `memory/` и журналы остаются в проекте как обычные файлы.
Частые вопросы
Как поставить Andon в Claude Code?
Выполните `/plugin marketplace add PrimeFoldTools/andon`, затем `/plugin install andon@primefold-tools`. Хук Stop включится в режиме предупреждения, хук ориентации тоже, защита от скрытых статусов тестов остается выключенной.
Как поставить Andon в Codex?
Выполните `codex plugin marketplace add PrimeFoldTools/andon` и `codex plugin add andon@primefold-tools`, затем в `codex` введите `/hooks` и доверьте три хука. Без доверия Codex хуки не запускает.
Что делает хук проверки заявлений?
Находит в ответе агента фразы о завершении и сверяет их с записями, которые делает `andon-log-claim`. В режиме предупреждения он просит доказательство, в режиме блокировки возвращает решение остановиться.
Чем Andon отличается от репозиториев с памятью?
Память хранит урок, а Andon закрывает дефект мерой, которая мешает повторить ошибку: хуком или тестом. Память в нем только первый слой из четырех.
Можно ли проверить хук без установки?
Да. Склонируйте репозиторий и запустите команду из раздела «Reproduce it in 30 seconds»: `claim_check_hook.py` в режиме `warn` получит фразу о завершении и вернет `continue: true` с просьбой доказательства.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныProcoder — бинарный файл на Go с гейтом перед коммитом, контроллерами качества и журналом уроков, чтобы агент не сдавал сырое
Общие настройки Claude Code для команды: хуки против опасных команд, проверка перед завершением и скиллы от спецификации до ревью
Плагин из 33 скиллов с воротами: вопрос к задаче, сверка фактов с источниками, тесты вперед, обзор второй моделью
Плагин для Claude Code: передает задачу локальному no_human и проверяет ветку ревьюером, не видевшим сессию кодера
Плагин заставляет агента объяснять свой код и перед пушем задавать вопросы, чтобы вы понимали, что вливаете.
lessloc через хуки удерживает агента на минимуме кода: отказывает в заглушках и мусоре, возвращает недоделанную работу
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Andon (эта карточка) | нет | 168 | |
| HOL Guard | да | 1 094 | проверяет команды, чтение секретов и вызовы MCP до выполнения, а здесь ловится ложное завершение работы и ведется журнал дефектов |
| Superpowers | нет | 316 679 | набор скиллов процесса разработки, а здесь хуки доказательств и меры против повторных ошибок |
Коротко о README
README ставит задачу не повторять одну и ту же ошибку ИИ дважды и дает быстрый старт с файлом памяти без кода. Затем показан хук в работе за тридцать секунд, установка как плагин для Claude Code и Codex, таблица поддерживаемых приложений, журнал дефектов и четыре слоя системы. В конце перечислено содержимое репозитория.