Manager
Два режима: запись переносит итог сессии в задачу, чтение отвечает, что с задачей сейчас.
Развилка: где лежат задачи
Сначала прочитай файл правил штаба и файл правил отдела (AGENTS.md или CLAUDE.md).
- Задачи лежат в файлах (
tasks/): работай по разделу «Уровень 1», остальной документ не нужен.
- Задачи в GitHub issues: работай с раздела «Уровень 2: задачи в GitHub issues».
- Строки о том, где лежат задачи, нет: предложи её дописать, например «Задачи отдела лежат в
tasks/», и спроси человека до первой записи.
Уровень 1: задачи в файлах
Запись, в конце сессии:
Найти задачу. Ищи задачу этой сессии в tasks/ отдела (путь из правил: где лежат задачи). Файла нет: создай tasks/<ГГГГ-ММ-ДД>-<slug>.md с разделами:
# <название задачи>
## Результат
## Контекст
## Как проверить
## Текущее состояние
## Следующий шаг
## Результат и решение человека
Обновить файл задачи. Перепиши «Текущее состояние» (что сделано и где лежит) и «Следующий шаг» (одно действие). «Результат и решение человека» заполняет человек; агент переносит туда только его слова из сессии.
Файл дня. Допиши строку со ссылкой на файл задачи в файл дня штаба: путь из правил штаба, по умолчанию tasks/<ГГГГ-ММ-ДД>.md в штабе. Формат строки: - <отдел>: <что сделано> → ../<отдел>/tasks/<файл>.md.
Саммари в чат:
✓ сделано: ...
✎ ждёт человека: ...
дальше: ...
Чтение: «что по <задаче>» ищется по tasks/ отделов из карты отделов штаба; ответ берётся из разделов «Текущее состояние» и «Следующий шаг».
Уровень 2: задачи в GitHub issues
Источник правды по задаче — GitHub issue: тело, состояние, лейблы, эпик. Доска (GitHub Project) показывает, что активно на неделе, и обновляется вслед за issue.
- Запись — в конце сессии: прочитать, что сделано; найти существующие issues; обновить их прогрессом и комментарием о работе; соблюсти инварианты эпика, W-label и доски; новый issue создать, только когда ни один не подошёл.
- Чтение — в любое время: «что по <задаче>» → поиск по репозиториям из конфига, сжатое состояние найденных issues с эпиком, лейблами, колонкой доски и последней активностью.
Все операции с issue (прочитать, изменить, записать, синк доски) идут через manager: он держит контракт записи, инварианты и синк доски.
Что читать дальше
Справочники лежат рядом со скиллом. Читай целиком тот, что нужен на текущем шаге; каждый начинается с оглавления.
| Шаг |
Справочник |
| Любой вызов: выбрать режим, режим работы по умолчанию, язык ответа, цикл планирования, когда применять, pre-flight |
references/modes.md |
| Запись: алгоритм синка, авторизация, связь коммита и issue, артефакты планирования, колонка доски, чистка плана при закрытии, «обновить или создать», комментарий как запасной канал |
references/write-mode.md |
| Чтение: алгоритм, пакетное чтение доски, доказательство эпика, связанный контекст, ложные совпадения |
references/read-mode.md |
Поиск существующих issue: ключи, критерий совпадения, пакетный GraphQL и защиты jq |
references/search.md |
Эпик: что считается эпиком, как найти, агрегирующий эпик, видимый корень, блок Related, проверка до синка |
references/parent-epic.md |
| W-label: текущая неделя, дата события, дрейфы, бэклог, быстрое создание лейбла |
references/w-labels.md |
Заголовок нового issue: формула {действие} {объект}, правила, примеры |
references/titles.md |
| Тело issue: критерий готовности, шаблоны тела, обновления и комментария |
references/templates.md |
| Что показать пользователю: план, отчёт, ответ на чтение |
references/output.md |
| Интеграция с CRM (если включена в конфиге) |
references/crm.md |
| Частые ошибки — сверка перед выполнением плана |
references/mistakes.md |
Настройка: Manager Config
До первого использования задай это в AGENTS.md проекта (предпочтительно) или в CLAUDE.md (совместимость). Конфига агента у проекта ещё нет — запусти corp-doctor, он создаст или починит его. Владелец, репозитории, пути и номера досок берутся только отсюда.
## Manager Config
### GitHub owner
Имя пользователя или организация GitHub для поиска issue:
- owner: your-github-handle
### Repos to scan (cross-repo issue search scope)
Репозитории, в которых manager ищет:
- ~/Projects/main
- ~/Projects/ops
- ~/Projects/marketing
### Tasks index file (optional)
Путь к курируемому индексу текущей недели. Manager читает его ПЕРВЫМ, до любого `gh search`, чтобы сузить запросы:
- tasks_index: ~/docs/tasks.md
(если файла нет — manager работает без индекса, поиск идёт по всем repos)
### Tasks directory (optional)
Путь к файлам дня и планам недели, которые создаёт weekly-planning:
- tasks_dir: ~/docs/tasks/
### Domain → repo routing
| Domain | Repo |
|--------|------|
| коммерция / B2B-сделки | crm |
| запуски продуктов | main |
| эксплуатация / инфраструктура | ops |
| контент | marketing |
### GitHub Projects integration
Место на доске — инвариант (см. «Железные инварианты»). Объяви свои доски:
- weekly_project: <number> # общая доска «всё активное на этой неделе» по всем репозиториям
- weekly_project_owner: your-github-handle
- status_field: Status # поле single-select, в котором хранится колонка
- status_in_progress: In progress # имя (или id) опции активной колонки
- domain_projects (optional): # доски по доменам, если они у тебя есть
| Domain | Project number |
| коммерция | <number> |
| продукт | <number> |
Закешируй здесь найденные ID полей и опций (`gh project field-list <N> --owner OWNER --format json`), чтобы manager не запрашивал их каждый запуск.
### W-label convention (optional)
- enabled: true
- format: W{NN} (ISO week)
(если false — manager создаёт issues без W-label)
### Standing write authorization
- mode: ask-each-time | execute-after-plan
(по умолчанию: ask-each-time — показать план и спросить. execute-after-plan — выполнить записи после показа краткого плана. В обоих режимах спрашивай при настоящей неоднозначности или жёстком блокере)
### CRM integration (optional)
- crm_path: ~/Projects/crm
- crm_pointer_format: [[<slug>]]
(если не используется — секция игнорируется; см. references/crm.md)
corp-doctor — скилл первичной настройки и починки этого конфига. Тип работы живёт в лейблах, эпике и на доске (см. references/titles.md).
Железные инварианты
Каждый issue, который трогает manager, соблюдает первые три; активный issue текущей недели — ещё 4–6:
- W-label — текущая или будущая неделя либо неделя события с датой, если W-label включён в конфиге. Лейбла нет в репозитории — создай его.
- Эпик — ровно один, через GitHub Sub-issues API. Каждый issue, который сам не эпик, привязан к эпику. См. references/parent-epic.md.
- Трек задают заголовок и эпик. Лейблы — только W-label и лейблы типа работы.
- Место на доске — активный issue текущей недели стоит на доменной доске (если она есть) и на недельной доске. W-label без места на доске =
Project drift.
- Эпик виден на доске — для активного дочернего issue текущей недели эпик сам стоит на нужной доске с непустой колонкой статуса.
- Комментарий о работе — в записи, когда над issue в этой сессии шла реальная работа: комментарий в таймлайн с итогом и ссылками на коммиты; он пишется в дополнение к смене колонки, лейбла или места на доске. Синк только лейбла или доски без работы над задачей обходится без комментария.
Эпика нет ни в одном репозитории — manager до синка показывает это в плане и предлагает создать новый эпик или выбрать существующий. После синка у каждого issue есть эпик.
1---2name: manager-33description: >-4 Связывает сессию с задачами штаба в файлах tasks/ или в GitHub issues.5 Запись — «синкни сессию»: итог сессии в задачу и файл дня. Чтение —6 «что по <задаче>»: текущее состояние задачи.7metadata:8 source: https://skillmd.com/skills/serejaris/manager-39---1011# Manager1213Два режима: **запись** переносит итог сессии в задачу, **чтение** отвечает, что с задачей сейчас.1415## Развилка: где лежат задачи1617Сначала прочитай файл правил штаба и файл правил отдела (`AGENTS.md` или `CLAUDE.md`).1819- Задачи лежат в файлах (`tasks/`): работай по разделу «Уровень 1», остальной документ не нужен.20- Задачи в GitHub issues: работай с раздела «Уровень 2: задачи в GitHub issues».21- Строки о том, где лежат задачи, нет: предложи её дописать, например «Задачи отдела лежат в `tasks/`», и спроси человека до первой записи.2223## Уровень 1: задачи в файлах2425Запись, в конце сессии:26271. **Найти задачу.** Ищи задачу этой сессии в `tasks/` отдела (путь из правил: где лежат задачи). Файла нет: создай `tasks/<ГГГГ-ММ-ДД>-<slug>.md` с разделами:2829 ```markdown30 # <название задачи>3132 ## Результат33 ## Контекст34 ## Как проверить35 ## Текущее состояние36 ## Следующий шаг37 ## Результат и решение человека38 ```39402. **Обновить файл задачи.** Перепиши «Текущее состояние» (что сделано и где лежит) и «Следующий шаг» (одно действие). «Результат и решение человека» заполняет человек; агент переносит туда только его слова из сессии.413. **Файл дня.** Допиши строку со ссылкой на файл задачи в файл дня штаба: путь из правил штаба, по умолчанию `tasks/<ГГГГ-ММ-ДД>.md` в штабе. Формат строки: `- <отдел>: <что сделано> → ../<отдел>/tasks/<файл>.md`.424. **Саммари в чат:**4344 ```45 ✓ сделано: ...46 ✎ ждёт человека: ...47 дальше: ...48 ```4950Чтение: «что по <задаче>» ищется по `tasks/` отделов из карты отделов штаба; ответ берётся из разделов «Текущее состояние» и «Следующий шаг».5152## Уровень 2: задачи в GitHub issues5354Источник правды по задаче — GitHub issue: тело, состояние, лейблы, эпик. Доска (GitHub Project) показывает, что активно на неделе, и обновляется вслед за issue.55561. **Запись** — в конце сессии: прочитать, что сделано; найти существующие issues; обновить их прогрессом и комментарием о работе; соблюсти инварианты эпика, W-label и доски; новый issue создать, только когда ни один не подошёл.572. **Чтение** — в любое время: «что по <задаче>» → поиск по репозиториям из конфига, сжатое состояние найденных issues с эпиком, лейблами, колонкой доски и последней активностью.5859Все операции с issue (прочитать, изменить, записать, синк доски) идут через manager: он держит контракт записи, инварианты и синк доски.6061### Что читать дальше6263Справочники лежат рядом со скиллом. Читай целиком тот, что нужен на текущем шаге; каждый начинается с оглавления.6465| Шаг | Справочник |66|-----|------------|67| Любой вызов: выбрать режим, режим работы по умолчанию, язык ответа, цикл планирования, когда применять, pre-flight | [references/modes.md](references/modes.md) |68| Запись: алгоритм синка, авторизация, связь коммита и issue, артефакты планирования, колонка доски, чистка плана при закрытии, «обновить или создать», комментарий как запасной канал | [references/write-mode.md](references/write-mode.md) |69| Чтение: алгоритм, пакетное чтение доски, доказательство эпика, связанный контекст, ложные совпадения | [references/read-mode.md](references/read-mode.md) |70| Поиск существующих issue: ключи, критерий совпадения, пакетный GraphQL и защиты `jq` | [references/search.md](references/search.md) |71| Эпик: что считается эпиком, как найти, агрегирующий эпик, видимый корень, блок `Related`, проверка до синка | [references/parent-epic.md](references/parent-epic.md) |72| W-label: текущая неделя, дата события, дрейфы, бэклог, быстрое создание лейбла | [references/w-labels.md](references/w-labels.md) |73| Заголовок нового issue: формула `{действие} {объект}`, правила, примеры | [references/titles.md](references/titles.md) |74| Тело issue: критерий готовности, шаблоны тела, обновления и комментария | [references/templates.md](references/templates.md) |75| Что показать пользователю: план, отчёт, ответ на чтение | [references/output.md](references/output.md) |76| Интеграция с CRM (если включена в конфиге) | [references/crm.md](references/crm.md) |77| Частые ошибки — сверка перед выполнением плана | [references/mistakes.md](references/mistakes.md) |7879## Настройка: Manager Config8081До первого использования задай это в `AGENTS.md` проекта (предпочтительно) или в `CLAUDE.md` (совместимость). Конфига агента у проекта ещё нет — запусти `corp-doctor`, он создаст или починит его. Владелец, репозитории, пути и номера досок берутся только отсюда.8283```markdown84## Manager Config8586### GitHub owner87Имя пользователя или организация GitHub для поиска issue:88- owner: your-github-handle8990### Repos to scan (cross-repo issue search scope)91Репозитории, в которых manager ищет:92- ~/Projects/main93- ~/Projects/ops94- ~/Projects/marketing9596### Tasks index file (optional)97Путь к курируемому индексу текущей недели. Manager читает его ПЕРВЫМ, до любого `gh search`, чтобы сузить запросы:98- tasks_index: ~/docs/tasks.md99(если файла нет — manager работает без индекса, поиск идёт по всем repos)100101### Tasks directory (optional)102Путь к файлам дня и планам недели, которые создаёт weekly-planning:103- tasks_dir: ~/docs/tasks/104105### Domain → repo routing106| Domain | Repo |107|--------|------|108| коммерция / B2B-сделки | crm |109| запуски продуктов | main |110| эксплуатация / инфраструктура | ops |111| контент | marketing |112113### GitHub Projects integration114Место на доске — инвариант (см. «Железные инварианты»). Объяви свои доски:115- weekly_project: <number> # общая доска «всё активное на этой неделе» по всем репозиториям116- weekly_project_owner: your-github-handle117- status_field: Status # поле single-select, в котором хранится колонка118- status_in_progress: In progress # имя (или id) опции активной колонки119- domain_projects (optional): # доски по доменам, если они у тебя есть120 | Domain | Project number |121 | коммерция | <number> |122 | продукт | <number> |123124Закешируй здесь найденные ID полей и опций (`gh project field-list <N> --owner OWNER --format json`), чтобы manager не запрашивал их каждый запуск.125126### W-label convention (optional)127- enabled: true128- format: W{NN} (ISO week)129(если false — manager создаёт issues без W-label)130131### Standing write authorization132- mode: ask-each-time | execute-after-plan133(по умолчанию: ask-each-time — показать план и спросить. execute-after-plan — выполнить записи после показа краткого плана. В обоих режимах спрашивай при настоящей неоднозначности или жёстком блокере)134135### CRM integration (optional)136- crm_path: ~/Projects/crm137- crm_pointer_format: [[<slug>]]138(если не используется — секция игнорируется; см. references/crm.md)139```140141`corp-doctor` — скилл первичной настройки и починки этого конфига. Тип работы живёт в лейблах, эпике и на доске (см. [references/titles.md](references/titles.md)).142143## Железные инварианты144145Каждый issue, который трогает manager, соблюдает первые три; активный issue текущей недели — ещё 4–6:1461471. **W-label** — текущая или будущая неделя либо неделя события с датой, если W-label включён в конфиге. Лейбла нет в репозитории — создай его.1482. **Эпик** — ровно один, через GitHub Sub-issues API. Каждый issue, который сам не эпик, привязан к эпику. См. [references/parent-epic.md](references/parent-epic.md).1493. **Трек задают заголовок и эпик.** Лейблы — только W-label и лейблы типа работы.1504. **Место на доске** — активный issue текущей недели стоит на доменной доске (если она есть) и на недельной доске. W-label без места на доске = `Project drift`.1515. **Эпик виден на доске** — для активного дочернего issue текущей недели эпик сам стоит на нужной доске с непустой колонкой статуса.1526. **Комментарий о работе** — в записи, когда над issue в этой сессии шла реальная работа: комментарий в таймлайн с итогом и ссылками на коммиты; он пишется в дополнение к смене колонки, лейбла или места на доске. Синк только лейбла или доски без работы над задачей обходится без комментария.153154Эпика нет ни в одном репозитории — manager до синка показывает это в плане и предлагает создать новый эпик или выбрать существующий. После синка у каждого issue есть эпик.