# herald

Субагент herald готовит релизы проектов: анализирует коммиты по SemVer, обновляет номера версий в конфигах и формирует записи в CHANGELOG.md.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 3951 у репозитория
- Автор: parcadei
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/parcadei/Continuous-Claude-v3/tree/HEAD/.claude/agents/herald.md
- Обновлён: 2026-01-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/herald

## Что делает

herald автоматизирует релизную рутину через модель Sonnet. Агент смотрит историю `git log` от предыдущего тега до `HEAD`, выявляет ломающие изменения по маркеру `BREAKING` и группирует коммиты по типам: фичи, багфиксы, документация и правки производительности.

После анализа агент вычисляет новый номер версии по семантическому версионированию и обновляет файлы проекта. Он выполняет `npm version` для Node.js или редактирует `pyproject.toml` для Python, а также ведёт `CHANGELOG.md` по стандарту Keep a Changelog. Полный отчёт с чеклистом и командами публикации herald сохраняет в `.claude/cache/agents/herald/output-{timestamp}.md`.

Если в репозитории нет тегов git или нарушен формат коммитов, субагенту труднее определить правильный шаг версии.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/parcadei/Continuous-Claude-v3/tree/HEAD/.claude/agents/herald.md

## Когда брать
- разобрать коммиты после прошлого тега и сгруппировать их по типам
- поднять версию пакета в `package.json` или `pyproject.toml`
- составить запись для `CHANGELOG.md` по стандарту Keep a Changelog
- подготовить команды для создания git-тега и публикации пакета

## Примеры запросов агенту
- Подготовь patch-релиз для текущего репозитория и обнови CHANGELOG.md.
- Определи следующую версию по коммитам с последнего тега и подними версию в package.json.
- Собери отчёт о релизе с описанием ломающих изменений и инструкцией по миграции.

## Похожие
- [release](https://affpapa.org/nevibecode/commands/florianbruniaux-release.md) — команда · ★ 6529 у репозитория
- [release-skills](https://affpapa.org/nevibecode/skills/release-skills.md) — скилл · 26100 установок
- [release-manager](https://affpapa.org/nevibecode/skills/borghei-release-manager.md) — скилл · 132 установки
- [release-bumper](https://affpapa.org/nevibecode/skills/release-bumper.md) — скилл · 105 установок
- [semantic-versioning](https://affpapa.org/nevibecode/skills/devops-skills-semantic-versioning.md) — скилл · 379 установок
- [add-to-changelog](https://affpapa.org/nevibecode/commands/add-to-changelog.md) — команда · 277 установок

Из того же набора: [parcadei/continuous-claude-v3](https://affpapa.org/nevibecode/by/parcadei/continuous-claude-v3.md) — 161 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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