Harmonist — набор агентов с жесткими хуками
Harmonist
Набор агентов-специалистов и хуков для Cursor, который не дает ассистенту закончить ход без ревью и записи в память
- 2 252 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Хуки запускают скрипты Python и bash на каждый запуск субагента, правку файла и остановку сессии
- Скрипт интеграции записывает AGENTS.md, память и хуки в проект, а память содержит заметки о ваших решениях
Установка
- Работает в
Ручная установка
git clone https://github.com/GammaLabTechnologies/harmonist.git && python3 harmonist/agents/scripts/integrate.py --pack harmonist --project .Выполнять в корне проекта. Вариант для Cursor: вставить в агента текст из integration-prompt.md.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хуки запускают скрипты Python и bash на каждый запуск субагента, правку файла и остановку сессии
- Скрипт интеграции записывает AGENTS.md, память и хуки в проект, а память содержит заметки о ваших решениях
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Harmonist кладется в проект подпапкой и превращает ассистента в команду. Файл AGENTS.md задает протокол оркестратора, каталог из 193 агентов в 16 категориях подсказывает, кому передать работу, а память хранится в проверяемых записях. Главное отличие в хуках. Хук остановки смотрит, запускались ли ревьюеры вроде qa-verifier и обновлен ли файл session-handoff.md. Если нет, он возвращает ассистенту сообщение и не дает ходу завершиться. Запись в память идет только через скрипт memory.py: он проверяет схему, отсеивает дубликаты и ищет в тексте около 30 видов секретов, от ключей AWS до токенов Telegram. Содержимое пакета учтено в файле MANIFEST.sha256. Перед копированием в проект скрипт обновления сверяет хеши и отклоняет подмененный файл агента.
Для кого. Для команд, которые работают в Cursor или подключают пакет к Claude Code через адаптер и хотят собрать вокруг ассистента команду узких агентов с общей памятью.
Подходит, если
- Заставить ассистента запускать ревью безопасности перед правкой кода авторизации
- Передавать контекст между сессиями через проверяемую память с идентификаторами корреляции
- Подобрать под проект узких специалистов: аудит Solidity, мини-программы WeChat или Roblox Luau
- Вести длинную задачу, где следующая сессия должна видеть незакрытые инциденты прошлой
- Развернуть оркестрацию без Docker и баз данных
Не подходит, если
- Нужен один небольшой скрипт или разовая правка: хуки и протокол замедлят работу больше, чем помогут
- Ассистент не умеет вызывать субагентов: протокол опирается на их запуск и отметки в сессии
- Нужен готовый серверный фреймворк оркестрации с очередями и панелью: Harmonist состоит из markdown, скриптов Python и bash
Пример запроса к агенту
Подключи Harmonist к проекту, выбери агентов под Next.js и PostgreSQL и покажи, какие хуки будут включены.Ограничения
Основная интеграция сделана под Cursor. Для Claude Code, Copilot, Windsurf, Aider, Gemini CLI и других есть адаптеры, но жесткая проверка хода зависит от того, какие хуки поддерживает конкретный редактор. Нужны Python 3.9 или новее и Git, bash необязателен.
Папка пакета остается в проекте подпапкой, ее нельзя распаковывать в корень. Скрипт интеграции создает AGENTS.md, память в .cursor/memory, хуки и файл версии .cursor/pack-version.json, поэтому изменения лучше смотреть в диффе до фиксации.
Каталог агентов широкий, и часть ролей рассчитана на китайский рынок. Доступность GitHub для установки из России зависит от вашей сети.
Как отключить. Удалите хуки и записи пакета из папки .cursor и файл AGENTS.md, затем папку harmonist из проекта. Что установлено, видно по файлу .cursor/pack-version.json.
Частые вопросы
Как подключить Harmonist к проекту в Cursor?
Склонируйте репозиторий в корень проекта подпапкой, откройте проект в режиме агента и вставьте содержимое файла harmonist/integration-prompt.md. Ассистент спросит про домен и роли и соберет AGENTS.md. Когда он закончит, начните новый чат.
Можно ли поставить Harmonist без Cursor?
Да, через командную строку: `python3 harmonist/agents/scripts/integrate.py --pack harmonist --project .`. На Windows тот же скрипт запускают через py -3, WSL не нужен.
Что будет, если ассистент раз за разом не проходит хук остановки?
Хук возвращает ход не больше трех раз. После этого он записывает инцидент, и следующая сессия показывает его при старте.
Чем Harmonist отличается от обычных фреймворков агентов?
Фреймворки вроде LangChain, CrewAI и AutoGen дают примитивы оркестрации, а соблюдение правил оставляют промпту. В Harmonist правила проверяют хуки редактора, содержимое пакета сверяется по хешам, а в память не пускают записи с секретами.
Нужна ли база данных или Docker?
Нет. Пакет состоит из markdown, стандартной библиотеки Python и bash, сторонних зависимостей нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныМногоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других
Скилл и хуки, которые удерживают кодового агента в рамках задачи и убирают лишнюю защиту, ненужные контрольные суммы и расползание объема
CLI, через который агенты в разных терминалах переписываются, следят друг за другом и запускают друг друга
oah раскладывает более 80 скиллов, пять ролей и команды /commit, /review, /test-tdd по папкам Claude Code, Cursor, Codex и других
Переносимая папка .agent с памятью, скиллами и протоколами, которая подключается к разным кодовым агентам и не теряет знания при смене инструмента
Сто готовых команд агентов для Claude Code: в каждой специалисты, скилл-оркестратор и доменные скиллы, на английском и корейском
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Harmonist — набор агентов с жесткими хуками (эта запись) | нет | 2 252 | |
| oh-my-claudecode | нет | 40 377 | оркестрация нескольких агентов для Claude Code с командами и автопилотом, без проверки хода хуками и сверки хешей |
| agency-agents-zh | нет | 21 684 | каталог ролей-экспертов в виде промптов, без хуков, памяти и протокола оркестратора |
Коротко о README
Исходная мысль проекта: просьба в промпте не гарантирует соблюдения правил, поэтому их проверяют хуки редактора. Рядом с пакетом лежат руководство GUIDE_EN.md, схема агентов и интеграции для десяти редакторов.