К основному содержанию
скилл CX Codex

maestro-bundle — скилл для Claude Code: что делает и как установить

Скилл maestro-bundle управляет жизненным циклом связок SPEC, NOTES и VERIFY в фреймворке Maestro и передаёт контекст между сессиями агентов.

MIT ★ 238 обновлён 2026-10-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ReinaMacCredy/maestro --skill maestro-bundle -a claude-code
Открыть на GitHub

Что делает maestro-bundle

Скилл маршрутизирует задачи по уровням Maestro и ведёт комплект из трёх обязательных артефактов: спецификации, заметок и проверки. Для трека Full он создаёт рабочую область командой maestro bundle open <id>, связывает её с задачей через флаг --work и формирует структуру файлов без ручного создания разрозненных заметок в корне проекта.

Внутри заложены правила передачи контекста и сжатия сессий. Когда меняется владелец задачи, ветка разделяется или диалог перегружен ложными попытками, скилл инициирует maestro handoff <bundle-id>. Команда собирает NOTES.md из решений, откатов и контрольных точек. При сжатии контекста агент не получает предупреждений, поэтому скилл фиксирует статус задачи в формате checkpoint: перед каждой сменой шага.

Создавать файлы SPEC-*, NOTES-* или VERIFY-* прямо в корневом каталоге запрещено правилами трио. Набор утилит сохраняет снимки завершённых связок через maestro bundle close <id> и ставит работу на паузу с помощью аргумента --reason.

Какие задачи решает

  • Развернуть структуру SPEC, NOTES и VERIFY под сложную задачу
  • Собрать контекст и решения перед передачей сессии другому агенту
  • Привязать утверждённые архитектурные решения Hub к текущему бандлу
  • Восстановить ход прерванной задачи после сжатия контекста

Примеры запросов агенту

  • Открой новый бандл auth-flow и привяжи его к задаче 42
  • Сделай handoff для бандла auth-flow перед передачей сессии
  • Покажи статус и связанные решения для maestro bundle billing-sync

Как установить maestro-bundle

1Через Skills CLI (Vercel)

npx skills add ReinaMacCredy/maestro --skill maestro-bundle -a claude-code

2Вручную: положить файлы

~/.claude/skills/maestro-bundle/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/maestro-bundle/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о maestro-bundle

Как установить maestro-bundle в Claude Code?

Выполните в терминале команду npx skills add ReinaMacCredy/maestro --skill maestro-bundle -a claude-code.

Что делает maestro-bundle?

Он автоматизирует жизненный цикл рабочих бандлов Maestro: разворачивает артефакты спецификации и проверки, ставит задачи на паузу, фиксирует чекпоинты и формирует отчёты для передачи сессии.

Когда скилл требует передачу контекста вместо сжатия истории?

Скилл запускает протокол передачи через handoff при смене исполнителя, выделении отдельной git-ветки, изменении роли или накоплении тупиковых попыток решения в контексте.

Исходный текст

SKILL.md · MIT
---
name: maestro-bundle
description: Route work into the right maestro tier and drive the SPEC/NOTES/VERIFY bundle lifecycle - open, resume, close, recall.
review-date: 2026-11-28
---
<!-- maestro-skill-version: dev -->

# maestro-bundle

Use [WORKFLOW.md](~/maestro/WORKFLOW.md) for method rules and routing.
This skill owns record creation, resume, and handoff procedures.

## Tier rule

Apply [Tiers](~/maestro/WORKFLOW.md#tiers) after bounded reconnaissance.
For tracked work use `maestro work add|start|done`. When Full is warranted,
open the bundle in the store whose checkout will change, even when design
runs in the Hub. List Hub decisions as `hub:<id>`; `maestro bundle show`
renders them. Note the bundle on the Hub map and the map on its work item.

```
maestro bundle open <id> --work <workId>   # scaffold SPEC/NOTES/VERIFY, link work
```

## The trio contract

Follow [Bundle contract](~/maestro/WORKFLOW.md#bundle-contract-tier-full).
Use `maestro handoff <bundle-id>` to render NOTES.md from work, decisions,
handbacks, failures, and the latest checkpoint. Fill only placeholders the
store cannot prove, including original authorization and retained gates.
Use `maestro bundle show <id>` to read the contract and linked decisions.
Never create root `SPEC-*`, `NOTES-*`, or `VERIFY-*` files.

## Verbs

```
maestro bundle open <id> [--work <id>]  # scaffold + active row
maestro bundle close <id>               # snapshot trio into the store, archive
maestro bundle pause <id> [--reason]    # active stays open, out of the way
maestro bundle resume <id>              # paused back to active
maestro bundle list                     # states: active | paused | archived
maestro bundle show <id>                # trio + linked work + decisions
maestro bundle save <dir>               # ingest a foreign trio dir as archived
maestro search "<term>"                 # recall: hits labeled (bundle, ...)
```

## Authorization boundaries

Follow [Authorization boundaries](~/maestro/WORKFLOW.md#authorization-boundaries).
Put the original user instruction or retrievable reference on the work item
so the successor can verify the grant, rather than relying on an agent's summary.

## Routing

Use [Routing](~/maestro/WORKFLOW.md#routing); a skill transition is internal,
not another user approval gate.

## Resume protocol

Follow [Resume](~/maestro/WORKFLOW.md#resume). For Light, read the work and
checkpoint without opening a bundle. For Full, locate and read the existing
bundle, then reconcile it with the checkout before continuing.

## Concurrency and git

Follow [Concurrency and git](~/maestro/WORKFLOW.md#concurrency-and-git).
Record the work owner and task-owned paths in the handoff, not just the branch.

## Compact or hand off

Hand off instead of compacting when:

- the owner changes
- a dependency becomes its own branch
- the role changes
- the context is full of false starts

Compact only when ownership, scope, and role stay stable and the history still
helps the same writer continue. Compaction gives no warning turn in either
harness, so the checkpoint must already exist: keep a `checkpoint:` work note
(state / next / avoid, latest wins) on each held item, rewritten at every
meaningful change of state or next action; the SessionStart brief prints it back after
the compaction. Nothing summarized is trusted over it.

Use break-before-make when the writer on a moving scope changes: release the
lease and refresh the handoff before the new session starts. The
handoff packet must preserve the base, Current State, Next Action, Authority
transferred and retained, Failed approaches, and Do not repeat.

## Hand-off

Run `maestro handoff <bundle-id>` to seed untouched NOTES.md sections when a bundle exists.
Then decide which of three cases this is; the destination differs:

1. **Continuation with a bundle.** A future session, in any tool, continues
   this bundle in this workspace. The handoff IS the rendered NOTES.md
   covering every section the trio contract names, with a `Driver:` line
   naming the tool expected to resume. The bundle stays active; the next
   session's resume protocol must find it.
2. **Transfer.** The work leaves this workspace, to a person, another repo,
   or an agent that will not resume the bundle. Write the standalone document
   below, then close the bundle per `maestro-verify`'s close order, citing
   the handoff target.
3. **No bundle.** For tracked work, save the continuation packet as a
   `checkpoint:` work note with original authorization and retained gates.
   If an untracked quickfix needs continuation, create a Light work item.
   For a transfer outside this workspace, provide a standalone document in
   the OS temporary directory, report its path, and transfer it to the recipient;
   a local path alone is not accessible from another machine.

The standalone document (cases 2 and 3) names the suggested skills for the
next agent, references specs, decisions, commits, and diffs by path or id
instead of duplicating them, and redacts secrets and personal data.

Design lane -> use the `maestro-design` skill. Implementation -> the matched playbook (`maestro recipe show <name>`).
Verification and close -> `maestro-verify`.

© ReinaMacCredy · MIT · ReinaMacCredy/maestro

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
maestro-e2e raphaelbarbosaqwerty Скилл maestro-e2e для написания и отладки E2E-тестов на Maestro: логины, регистрация, навигация, диалоги разрешений. Работает с iOS, Android, Flutter, React Native и вебом. CX Codex +1 543установок engagement-workflow Indranil Banerjee Скилл engagement-workflow ведёт маркетинговую кампанию через 12 этапов от брифа до плана роста. Помогает пошагово фиксировать результаты и возобновлять работу при сбоях. CX Codex +1 ★ 1 596звёзд репо execution josstei Скилл execution управляет запуском фаз реализации в оркестраторе Maestro через нативных субагентов с проверкой конфликтов файлов. CX Codex +1 ★ 489звёзд репо gsd-pause-work open-gsd Скилл gsd-pause-work для Claude Code создаёт файл .continue-here.md при остановке работы посреди фазы, сохраняя контекст и прогресс сессии. CX Codex +1 582установок checkpoint Affaan Mustafa Команда checkpoint фиксирует контрольные точки в Git во время сессии Claude Code и сравнивает текущее состояние файлов, тестов и сборки с сохранённым срезом. CX Codex +1 ★ 6 739звёзд репо list carlrannaberg Команда list находит сохранённые чекпоинты Claude Code в git stash и выводит их список с датой, веткой и описанием. CX Codex +1 ★ 763звёзд репо

Из того же набора10

Весь набор →
verify-maestro Скилл verify-maestro проверяет правки в репозитории Maestro в изолированном окружении: ставит сборку во временный HOME, прогоняет сценарии CLI и сохраняет лог для отчёта. CX Codex +1 ★ 238звёзд репо maestro-questionnaire Скилл maestro-questionnaire превращает нерешённый вопрос в Markdown-опросник для человека, у которого есть нужные ответы. Подходит для сбора информации асинхронно или на встрече. CX Codex +1 ★ 238звёзд репо maestro-coach Скилл maestro-coach для Claude и Codex, который разбирает непонятный вопрос по шагам и объясняет концепт за решением на реальном коде вашего репозитория. CX Codex +1 ★ 238звёзд репо maestro-verify Скилл maestro-verify сверяет проверки с критериями приёмки, фиксирует вердикт и помогает закрыть рабочий пакет. Нужен перед передачей результата или закрытием задачи. CX Codex +1 ★ 238звёзд репо maestro-design Скилл maestro-design для разрешения блокирующих вопросов перед началом разработки: выбор архитектуры, моделирование, прототипирование и фиксация решений. CX Codex +1 ★ 238звёзд репо maestro-graph Скилл maestro-graph для Claude Code и Codex, который проводит задачу по заранее написанному графу: спускает агентов на каждый узел, собирает их результаты и переходит к следующему шагу. CX Codex +1 ★ 238звёзд репо maestro-work Скилл maestro-work для Claude Code задаёт общий порядок работы плейбуков: бриф, правила для исполнителя и формат передачи результата. Он включается при делегировании задачи и ведении её записи в Maestro. CX Codex +1 ★ 238звёзд репо maestro-council Скилл maestro-council проводит совет по решению, которое дорого откатывать: изолированные участники, проверка общей посылки, перекрёстный допрос и один обязательный вердикт. CX Codex +1 ★ 238звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой