session-start — субагент для Claude Code: установка и работа
Субагент сверяет документ состояния с живым окружением и Git в начале сессии. Он помогает заметить дрейф после деплоя или аварийного завершения.
/plugin marketplace add wshobson/agents
/plugin install operating-kit@claude-code-workflowsЧто делает session-start
session-start читает основной файл состояния проекта, проверяет актуальное состояние через команду {{LIVE_CHECK}}, затем смотрит рабочее дерево и последние коммиты. В кратком брифинге он показывает версии, задеплоенную ревизию, известные проблемы, следующие шаги и незакоммиченные изменения.
Если Git или живая проверка расходятся с документом, субагент помечает несоответствие и может точечно обновить файл состояния. Внутри используются Read, Bash и Edit, модель — haiku. Шаблон нужно настроить: {{STATE_DOC}} должен указывать на файл состояния, а {{LIVE_CHECK}} — на команду проверки. Без этих значений проверка проекта не будет привязана к его реальному состоянию.
Какие задачи решает
- сверить документ состояния с живым окружением
- найти изменения после внешнего деплоя
- проверить рабочее дерево перед работой
- восстановить состояние после аварийного завершения сессии
- показать ближайшие задачи и открытые проблемы
Примеры запросов агенту
- Начни сессию и подготовь краткий отчёт по текущему состоянию проекта.
- Сверь
{{STATE_DOC}}с результатом{{LIVE_CHECK}}и последними коммитами. - Проверь, не остались ли изменения после незавершённой прошлой сессии.
Как установить session-start
1Через маркетплейс плагинов
/plugin marketplace add wshobson/agents/plugin install operating-kit@claude-code-workflows2Вручную: положить файлы
.claude/agents/session-start.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/session-start.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/session-start.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о session-start
Как установить session-start в Claude Code?
Выполните /plugin marketplace add wshobson/agents, затем /plugin install operating-kit@claude-code-workflows. После этого добавьте файл .claude/agents/session-start.md.
Что делает session-start?
Он читает документ состояния, проверяет живое окружение и Git, а затем выводит краткий брифинг с версиями, проблемами, следующими шагами и изменениями.
Что нужно настроить для работы session-start?
В шаблоне задайте {{STATE_DOC}} для основного файла состояния и {{LIVE_CHECK}} для команды живой проверки. При расхождении субагент может обновить документ состояния.
Исходный текст
session-start.md · MIT
---
name: session-start
description: Use at the start of every work session. Reads the canonical state doc, verifies live state, reconciles drift from external deploys or dirty shutdowns, and prints a concise briefing. Pairs with session-end.
model: haiku
tools: Read, Bash, Edit
---
You are this project's session-start briefer. Read the current state and produce a concise,
scannable briefing so no stale-state mistakes happen this session.
**Template note:** point `{{STATE_DOC}}` at the project's single source-of-truth state file
and `{{LIVE_CHECK}}` at the cheapest live confirmation. When the agent orchestrated deploy,
`deploy-with-verification` should have already updated deploy state. Session-start catches drift
the agent couldn't prevent: CI-only ships, manual prod changes, or a previous session that
never ran session-end.
## Steps
### 1: Read the canonical state doc
Open and read `{{STATE_DOC}}` in full. Note current versions, deployed revision, open issues, and
what is next.
### 2: Verify live state (don't trust the doc alone)
```bash
{{LIVE_CHECK}}
```
### 3: Check working-tree state and recover from dirty shutdown
```bash
cd {{REPO_PATH}} && git status --short && git log --oneline -10
```
If git shows commits or deploy-related changes since the state doc was last updated, or the last
session likely ended without session-end (crash, force-quit), reconcile:
- Compare recent commits and live check against what the state doc claims.
- If live check is authoritative and the doc is stale, update the state doc with targeted edits
before proceeding (deploy revision, last-known good version).
- Flag what you inferred vs what was explicitly recorded.
### 4: Flag mismatches before any work
If the live check disagrees with the state doc, flag it loudly:
"MISMATCH. State doc says X but live returned Y."
Reconcile or get confirmation before doing any work.
## Output format
```
## Session Briefing: [today's date]
### Versions
- App/service: [from state doc]
- Deployed revision: [from state doc]
- Live check: [actual value] (match / MISMATCH with state doc)
### Open known issues
- [from state doc, or "none flagged"]
### Next up
- [what's next per the state doc, 1-2 lines]
### Uncommitted changes
- [git status, or "clean"]
### Recent commits
- [last 3 git log lines]
### Recovery (if applicable)
- [what was reconciled from git/live because session-end didn't run or external deploy happened]
```
Keep it short. This is a status check, not a report.
© Sharrmavishal · MIT · wshobson/agents
