# commit-guardian

Субагент выполняет 10 проверок перед коммитом в Git и блокирует запись, если найдены утечки ключей, ошибки сборки или тестов.

- субагент · `type=agent` · Claude Code · 208 установок
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/git/commit-guardian.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/commit-guardian

## Что делает

Агент действует как автоматический барьер качества для подготовленных изменений. Он строго запрещает прямые коммиты в ветки `main` или `master`, проверяет наличие токенов и секретов вроде AWS или OpenAI, запускает билд для .NET, Node.js, Python, Go или Rust, прогоняет тесты и валидирует форматирование.

Процедура также анализирует изменения на атомарность, ищет забытые отладочные метки и проверяет текст коммита по правилам Conventional Commits. Если сообщение не вписывается в лимит 72 символов или нарушает структуру, агент предложит исправленный вариант.

Субагент категорически не запускает `git push`, не использует флаг `--no-verify` и останавливает работу при любой блокирующей ошибке, требуя вмешательства разработчика.

## Установка

### Claude Code (родная платформа)

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --agent git/commit-guardian
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/commit-guardian.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/commit-guardian.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/commit-guardian.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/git/commit-guardian.md

## Когда брать
- предотвратить утечку приватных ключей и паролей в историю репозитория
- заблокировать коммиты напрямую в ветки `main` и `master`
- проверить формат коммит-сообщений по схеме Conventional Commits
- прогнать сборку и тесты для подготовленных файлов перед фиксацией
- найти забытый отладочный код и неиспользуемые импорты

## Примеры запросов агенту
- Проверь staged файлы через commit-guardian и сделай коммит
- Запусти протокол проверок commit-guardian перед сохранением изменений
- Оцени изменения в индексе и помоги составить коммит по Conventional Commits

## Похожие
- [ce-commit](https://affpapa.org/nevibecode/skills/ce-commit.md) — скилл · 3400 установок
- [commit-message-storyteller](https://affpapa.org/nevibecode/skills/commit-message-storyteller.md) — скилл · 392 установки
- [deployment-engineer](https://affpapa.org/nevibecode/agents/deployment-engineer.md) — субагент · 6079 установок
- [launchdarkly-flag-cleanup](https://affpapa.org/nevibecode/agents/launchdarkly-flag-cleanup.md) — субагент · 171 установка
- [pr-test-analyzer](https://affpapa.org/nevibecode/agents/pr-test-analyzer.md) — субагент · ★ 44967
- [Technical Debt Remediation Plan](https://affpapa.org/nevibecode/agents/technical-debt-remediation-plan.md) — субагент · ★ 40478
- [TDD Red Phase - Write Failing Tests First](https://affpapa.org/nevibecode/agents/tdd-red-phase-write-failing-tests-first.md) — субагент · ★ 40478

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 804 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md