---
name: Maestro Bundle
slug: maestro-bundle
category: Automation
description: Maestro Bundle routes requests into the right maestro tier and manages the SPEC, NOTES, and VERIFY bundle lifecycle. Use it when work needs a bundle to open, resume, close, or recall across sessions.
github: "https://github.com/ReinaMacCredy/maestro/tree/main/src/plugins/skills/maestro-bundle"
language: TypeScript
stars: 231
forks: 24
install: "npx degit https://github.com/ReinaMacCredy/maestro/tree/main/src/plugins/skills/maestro-bundle ~/.claude/skills/maestro-bundle"
installs_to: ~/.claude/skills/maestro-bundle
source_path: src/plugins/skills/maestro-bundle/SKILL.md
collection_size: 5
category_size: 1754
collection_url: "https://dirskills.com/collections/ReinaMacCredy/maestro"
added: 2026-09-03T06:04:20.193Z
last_synced: 2026-09-03T06:04:20.193Z
canonical_url: "https://dirskills.com/skills/maestro-bundle"
---

# Maestro Bundle

Maestro Bundle routes requests into the right maestro tier and manages the SPEC, NOTES, and VERIFY bundle lifecycle. Use it when work needs a bundle to open, resume, close, or recall across sessions.

**Install:**

```bash
npx degit https://github.com/ReinaMacCredy/maestro/tree/main/src/plugins/skills/maestro-bundle ~/.claude/skills/maestro-bundle
```

## README

<!-- maestro-skill-version: dev -->

# maestro-bundle

Routing brain for maestro method work. Decide the tier first, then follow the
matching skill; this skill owns the bundle lifecycle itself.

## Tier rule

Decide the tier from the request alone, before any recon: no bundle files, no
code reading, no store lookups until the tier is known.

- quickfix: the diff fits in one sentence and hits no Full trigger below. Do it
  directly, verify inline (run the smallest check that can falsify it), no
  skill, no record. If it grows past one sentence, stop, `maestro work add`,
  and continue as Light.
- Light: one session, one branch, and the acceptance fits in a sentence. Work
  directly with `maestro work add|start|done` (no bundle). The work item is the
  floor because `maestro ready`, attention, and the Supervisor's brief read the
  store, not a session task list.
- Full: any trigger below. Open a bundle.

Open a bundle when ANY trigger holds:
- the work spans multiple sessions or must survive a context reset
- multiple branches, worktrees, or agents touch the same scope
- the scope is high risk (schema change, wide refactor, irreversible step)
- a previous fix attempt for the same problem failed

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

## The trio contract

- `SPEC.md` is a pure contract: problem, solution, scope, anti-goals.
  Mid-flight decisions are NOT written into SPEC; record them with
  `maestro decision draft "<text>" --rationale "<why>" --work <id>` and link
  the decision ids from SPEC.
- `NOTES.md` is a pure handoff: current state, next action, base commit.
  It also names Authority transferred and retained, Failed approaches, and Do
  not repeat. Overwrite it; never append. History lives in `maestro trace` and
  decisions.
- `VERIFY.md` is scenarios + results; each scenario points at a work item's
  acceptance or claim instead of restating it.

## Verbs

```
maestro bundle open <id> [--work <id>]  # scaffold + active row
maestro bundle close <id>               # snapshot trio into the store, archive
maestro bundle list                     # states: active | archived only
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, ...)
```

## Resume protocol

On resume, read the active bundle's NOTES.md first, then `maestro bundle show`
for linked work and decisions. Never trust conversational memory over the
bundle; the files and the store are the spec.

## 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.

Use break-before-make when the writer on a moving scope changes: release the
lease and overwrite NOTES.md 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 before transferring ownership.
Design lane -> use the `maestro-design` skill. Implementation -> `maestro-work`.
Verification and close -> `maestro-verify`.