govctl CLI
CLI хранит RFC, ADR и задачи в TOML внутри репозитория и не дает агенту закрыть работу без пройденных проверок
- 276 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Правит файлы в папке gov/ и запускает проверки, заданные в конфигурации проекта
- Интеграция добавляет в Claude Code и Codex навыки, хуки и ревьюеров
- Команда self-update заменяет собственный бинарник
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/govctlОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Правит файлы в папке gov/ и запускает проверки, заданные в конфигурации проекта
- Интеграция добавляет в Claude Code и Codex навыки, хуки и ревьюеров
- Команда self-update заменяет собственный бинарник
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
govctl — консольная программа для команд, которые строят ПО вместе с ИИ-агентами и хотят видеть за каждым изменением документ. В папке `gov/` репозитория она хранит RFC (что должно выполняться), ADR (почему выбрано это решение), рабочие задачи с критериями приемки, проверочные «стражи» и кейсы соответствия, которые связывают сценарии с версиями требований. Агент работает через стабильные команды: `govctl rfc get`, `govctl adr edit`, `govctl work move` и другие. Артефакты лежат в файлах TOML, поэтому правки видны в diff и ревью. Задача закрывается, когда проходят настроенные стражи, и слова агента о завершении ничего не решают. Команда `govctl search` ищет по всем артефактам, а `govctl conformance trace` показывает, какой проверкой подкреплено требование. Команда `govctl agent install claude` или `govctl agent install codex` ставит навыки, хуки и ревьюеров: `/discuss`, `/gov`, `/quick`, `/commit`. Для существующих проектов есть `/migrate`, который постепенно находит недокументированные решения и записывает их как ADR.
Для кого. Для команд и одиночных разработчиков, которые поручают код Claude Code или Codex и хотят ревьюируемый след решений и условия завершения работы.
Подходит, если
- Идея не должна уходить прямо в код: сначала RFC и ADR, потом рабочая задача
- Решения теряются в истории чата, и их нужно хранить в репозитории рядом с кодом
- Завершение работы должно зависеть от запуска проверок, например, clippy или тестов
- Старый проект надо постепенно описать: недокументированные решения превращаются в ADR
- Требование из RFC нужно связать с тестовым сценарием и проверкой
Не подходит, если
- Проект маленький или одноразовый: RFC и ADR добавят больше бумаги, чем пользы
- Нужен веб-интерфейс или MCP-сервер: автор намеренно обходится без них, управление идет через CLI и файлы
- Вы работаете с другим агентом: готовые навыки и хуки собраны для Claude Code и Codex
- Кейсы соответствия должны сами запускать тесты: они только объявляют связь с проверкой
Пример запроса к агенту
/discuss Стратегия кеширования: набросай RFC и ADR про выбор бэкенда кеша, потом заведи рабочую задачуОграничения
Готовая интеграция с агентами есть для Claude Code и Codex. Хуки добавляют компактный контекст только в проектах с governance и советуют, а не блокируют прямую правку артефактов. Кейсы соответствия объявляют трассируемость и сами тесты не запускают. Поиск строит одноразовый локальный индекс в `.govctl/`, источником правды остаются файлы TOML. Установка из исходников требует Rust и `cargo`, готовые бинарники ставит `cargo binstall`. Дорогие проверки стоит включать только на задачах, где они нужны, а общий набор оставить коротким.
Как отключить. Удалите плагин агента через его менеджер плагинов, бинарник командой `cargo uninstall govctl`, а папки `gov/` и `.govctl/` уберите из репозитория, если governance больше не нужна.
Частые вопросы
Как подключить govctl к Claude Code и Codex?
Для Claude Code выполните `govctl agent doctor claude`, затем `govctl agent install claude`. Для Codex то же с `codex`. После обновления govctl запускайте `govctl agent update` и начинайте новую сессию агента.
Чем RFC отличается от ADR в govctl?
RFC описывает, что должно быть истинным: поведение и ограничения. ADR записывает, почему выбрано конкретное проектное решение. Рабочие задачи выполняются поверх обоих.
Что такое стражи проверки?
Это исполняемые проверки, которые запускаются при завершении задачи. Общий набор задается в `gov/config.toml` через `default_guards`, дорогие проверки добавляют на конкретные задачи, а отказаться от стража можно с указанием причины.
Нужен ли govctl MCP-сервер?
Нет. Артефакты лежат в файлах TOML в `gov/`, а агенты работают с ними через команды `list`, `show`, `get` и `edit`. Автор сознательно не прячет governance за веб-приложением или MCP.
Как внедрить govctl в проект, который уже идет?
Выполните `govctl init`, затем запустите в агенте `/migrate`. Он находит недокументированные решения и записывает их как ADR, не требуя начинать проект заново.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыRust SDK для агентов программирования и готовый CLI abstract: REPL, 34 инструмента, MCP, граф памяти, Anthropic и OpenAI, вывод JSON для CI
CLI, который хранит инструкции для агента в одном месте и раскладывает их по нужным конфигам Claude Code, Cursor, Codex, Copilot и еще двух десятков инструменто
Режимы работы для ИИ-агента: облегченный на каждый день и /man с планом, проверкой и ревью для крупных задач
agr — менеджер пакетов для скиллов агентов: ставит их из любого Git-репозитория в Claude Code, Cursor и Codex по манифесту с версиями, как npm или uv
Кодинг-агент для терминала и рабочего стола: не засчитывает «готово» без тестов или diff и работает с DeepSeek, GLM, Kimi, Claude, Codex и Gemini
Плагин Grid Dynamics загружает в сессию кодового агента общие инженерные стандарты, архитектуру и рабочие процессы команды
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
Коротко о README
README объясняет идею: заменить цепочку «промпт, код, споры» цепочкой «RFC или ADR, задача, код под проверкой». Затем идут быстрый старт с `cargo install`, команды агента, примеры работы с артефактами, поиск, циклы выполнения, стражи, кейсы соответствия и миграция существующих репозиториев.