# session-orchestrator

session-orchestrator — хук для Claude Code и Codex, который структурирует сессию агента: планирование, поэтапное выполнение, контроль качества и закрытие с трекингом задач.

- хук · `type=hook` · Claude Code, Codex · ★ 1596 у репозитория
- Автор: hashgraph-online
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/Kanevry/session-orchestrator/hooks/hooks-codex.json
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 3 файла скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/hooks/session-orchestrator

## Что делает

Хук работает на Claude Code и Codex, поставляется в составе плагина session-orchestrator от hashgraph-online. Он перехватывает события жизненного цикла сессии и навешивает на каждое из них цепочку `.mjs`-скриптов, которые выполняются синхронно через `run-node.sh` (или `codex-win.cjs` на Windows).

При старте сессии `on-session-start.mjs` выводит меню команд — `/session`, `/plan`, `/discovery`, `/evolve` — и инициализирует состояние. На `PreToolUse` по каждому вызову `Bash` последовательно проходят семь хранителей: `pre-bash-destructive-guard.mjs` блокирует опасные операции, `pre-bash-staging-fence.mjs` ограничивает запись за пределы стейджинга, `pre-bash-memory-propose-audit.mjs` аудирует предложения в память, `pre-bash-sessions-ledger-guard.mjs` ведёт журнал сессий, `pre-tool-state-md-path-guard.mjs` следит за путями к файлам состояния, `pre-bash-issue-budget.mjs` контролирует бюджет задач, `enforce-commands.mjs` проверяет допустимость команды. После выполнения `Bash` `post-bash-write-verify.mjs` подтверждает запись, а `loop-guard.mjs` срабатывает на любой инструмент и прерывает зацикливание агента.

Интеграция с GitLab и GitHub позволяет закрывать задачи прямо из сессии. Таймаут каждого хука — 5 секунд. Установка сводится к правке `.claude/settings.json`: хуки регистрируются там вручную.

## Установка

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

**Вручную: положить файлы**
- Файл: `.claude/settings.json` — Блок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/Kanevry/session-orchestrator/hooks/hooks-codex.json

## Когда брать
- заблокировать деструктивные `Bash`-команды до их выполнения
- не дать агенту зациклиться на одном инструменте
- вести журнал задач и закрывать GitHub/GitLab-ишью из сессии
- ограничить запись файлов за пределами стейджинг-зоны
- восстановить контекст после `compact` или `resume` без потери плана

## Примеры запросов агенту
- Начни сессию по задаче из нашего трекера: `/session feature`
- Создай план для новой фичи: `/plan new`
- Запусти анализ кодовой базы: `/evolve analyze`

## Похожие
- [conventional-git](https://affpapa.org/nevibecode/skills/conventional-git.md) — скилл · 5400 установок
- [gh-switch](https://affpapa.org/nevibecode/skills/gh-switch.md) — скилл · 2200 установок
- [create-pr](https://affpapa.org/nevibecode/skills/tartinerlabs-create-pr.md) — скилл · 424 установки
- [create-branch](https://affpapa.org/nevibecode/skills/tartinerlabs-create-branch.md) — скилл · 413 установок
- [git-workflows](https://affpapa.org/nevibecode/skills/git-workflows.md) — скилл · 114 установок
- [greploop](https://affpapa.org/nevibecode/skills/greploop.md) — скилл · 3100 установок

Из того же набора: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 карточка

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

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