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

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

Скилл maestro-design для разрешения блокирующих вопросов перед началом разработки: выбор архитектуры, моделирование, прототипирование и фиксация решений.

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

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

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

maestro-design выбирает подход в зависимости от типа неизвестного: grill для взаимосвязанных решений пользователя, research для поиска фактов в документации и коде, prototype для проверки моделей состояния, domain-modeling для фиксации терминологии, wayfinder для многосессионных задач в тумане. Каждый проход закрывает хотя бы одну развилку.

Скилл работает только с дизайн-артефактами и не трогает production-код. Решения записываются через maestro decision draft с обоснованием и отвергнутыми альтернативами, затем фиксируются maestro decision lock. Для сложных развилок с широким радиусом поражения запускается протокол council: нейтральный бриф, изолированные места, один раунд перекрёстного допроса и единогласный вердикт с записью dissent. Перед любым предложением скилл ищет прецеденты в хранилище через maestro search и maestro bundle show.

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

  • выбрать между несколькими архитектурами и зафиксировать обоснование
  • проверить модель состояния прототипом перед разработкой
  • найти факт в API или чужом коде, не спрашивая у пользователя
  • записать hard-to-reverse решение с dissent через council
  • разметить терминологию и границы domain model

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

  • Запусти grill для выбора между REST и GraphQL, мне нужно решить несколько связанных вопросов
  • Найди через research, поддерживает ли библиотека pg потоковую репликацию
  • Сделай prototype состояния заказа, чтобы проверить, не забыл ли я статусы

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о maestro-design

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

Выполни npx skills add ReinaMacCredy/maestro --skill maestro-design -a claude-code, затем проверь ~/.claude/skills/maestro-design/SKILL.md.

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

Разрешает блокирующие вопросы дизайна: выбор архитектуры, моделирование, поиск фактов, прототипирование. Фиксирует решения через maestro decision и не трогает production-код.

Когда нужен режим council?

Для hard-to-reverse развилок с широким blast radius: нейтральный бриф, изолированные места, перекрёстный допрос, единогласный вердикт с записью dissent.

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

SKILL.md · MIT
---
name: maestro-design
description: Resolve material unknowns blocking the next authorized slice, using research, grilling, prototypes, models, or wayfinding. Record durable decisions and apply the shared workflow tier rule.
review-date: 2026-11-28
---
<!-- maestro-skill-version: dev -->

# maestro-design

Use when a material choice blocks the next slice. Read
[Decisions and readiness](~/maestro/WORKFLOW.md#decisions-and-readiness) and
[Authorization boundaries](~/maestro/WORKFLOW.md#authorization-boundaries).
Design is read-only toward production code and authorizes nothing.

## Mode per unknown

Identify what kind of unknown blocks progress, then load only the reference
that resolves it:

| The unknown | Mode | Reference |
|---|---|---|
| Decisions only the user can make, several and interdependent | grill | [references/grilling.md](references/grilling.md) |
| A decision owned by someone not in the conversation | route to `maestro-questionnaire` | |
| A fact in docs, APIs, or source outside this repo | research | `maestro recipe show investigation` |
| "Does this state model feel right?" or "What should it look like?" | prototype | `maestro recipe show prototype` |
| Fuzzy terminology, or a hard-to-reverse choice worth recording | model | [references/domain-modeling.md](references/domain-modeling.md) |
| The effort exceeds one session and is wrapped in fog, or the user does not know what to do next | wayfind | [references/wayfinder.md](references/wayfinder.md) |

Facts are yours to find; material product and scope choices are the user's.
Never ask the user for anything you could look up. Modes compose: grill runs with the glossary in
hand; wayfind dispatches grill, research, and prototype per child work item.
Each design pass must close at least one fork; a pass that closes none
surfaces the blocker to the user instead of looping.

## Intake

Pin the problem before choosing a method:

> For [who], reach [observable outcome] within [boundary], because [impact],
> without [excluded effect].

Route uncertainty to a lane:

| Current uncertainty | Lane |
|---|---|
| state unknown | scout, no-write |
| several architectures | two or three decision lanes |
| contract clear | delivery |
| candidate needs breaking | challenge |
| hard-to-reverse fork | council |

Weigh the ROI of independent judgment on five questions:

1. Would wrong framing be costly?
2. Is the decision hard to reverse?
3. Is the domain new to the owner?
4. Can independent judgment produce a materially different option?
5. Is human attention fragmented?

Mostly no: the direct session. Mixed: a Lead plus one peer. Mostly yes:
several lanes. Yes on every question including hard to reverse: a council.
Before launching any lane, pin the branch and commit, active writers, and
dirty paths.

## Recall pass first

Before proposing anything, search the store for precedent:

```
maestro search "<topic keyword>"        # hits labeled work/decision/note/bundle
maestro bundle show <id>                # deep-read a bundle hit
maestro decision list                   # locked choices that bind this scope
```

A past bundle that settled the same fork is evidence; cite it instead of
re-deriving the argument.

## Working method

- Read the current `maestro work show`, linked decisions, notes, and source.
- Present a blocking user-owned fork with a concrete recommendation;
  resolve reversible implementation details within the approved scope directly.
- Record durable decisions under WORKFLOW.md's threshold:
  `maestro decision draft "<choice>" --rationale "<why, with the rejected alternative>" --work <id>`
  then `maestro decision lock <id>`. Supersede an old decision with
  `--supersedes`; never rewrite its history.
- Keep acceptance, non-goals, and authority visible on the work item.
- A Full-tier `maestro bundle open <id> --work <workId>` tells the reviewer
  above you that a design has begun, and the answer may be a question-back
  pass opened on it: a read-only seat that reads the draft SPEC, the decisions
  not yet locked, and the code the SPEC cites, and returns one to three
  questions, each naming the claim it doubts and the evidence that would settle
  it. It reaches no verdict and edits nothing. Before `maestro decide` locks a
  point one of those questions doubts, answer that question - a work note on
  the design item, or a change to the SPEC - and carry the answer into the
  decision's `--why`. A point locked over an unanswered question is a decision
  taken without the evidence it asked for.
- Do not edit code during a design-only engagement.

## Council

A hard-to-reverse fork with wide blast radius runs the `maestro-council`
protocol: neutral brief, sealed seats, one premise verifier on unanimity,
bounded verifiers, one cross-examination round, an audit by tier, and one
binding verdict recorded with `maestro decision draft --rationale` carrying
the dissent. The candidate under review stays frozen; a new finding creates
a new candidate.

## Readiness gate and exit

Check readiness of the next bounded slice, not the number of open questions
about the whole project. Keep later questions visible without blocking an
independent slice. If the problem itself is unclear, wayfind. Forks already
settled are synthesized, never re-asked. An external claim entering a decision
(API behavior, library semantics, versions) comes from research against
primary sources, never from memory.

Then exit by [Tiers](~/maestro/WORKFLOW.md#tiers):

- Light: design ends with a work item with clear acceptance,
  `maestro work add "<title>" --acceptance "<observable result>" --kind <kind>`,
  plus any durable decisions. Kind routes the policies: `feature`, `task`,
  `bug`, `chore`, `implement` are execution units; `idea` and `research` are
  scope notes under a parent and never hold it open. The why lives in the
  title or acceptance; when it needs a paragraph, add
  `maestro work note <id> "why: <paragraph>"`, and record findings from the
  research mode as `research: <finding>` notes (what `policy-research` reads
  when enabled). No SPEC is required; the work is verified inline by
  its playbook (`maestro recipe show <name>`). A quickfix never reaches design.
- Full: `maestro bundle open <id> --work <workId>`, opened in the
  store whose checkout will change (a walk run in the Hub room still opens
  its bundle where the code lives; note the bundle on the Hub map and the map
  on the bundle's work item), then fill SPEC.md as a pure contract: Problem,
  Solution, Scope, Anti-goals (each traces to a real risk in this repo and gets a matching
  VERIFY.md check; an anti-goal that cannot be checked is a wish, not a
  constraint), Decisions (ids only, Hub decisions as `hub:<id>`;
  `maestro bundle show <id>` renders them). Plan checks using
  [Testing discipline](~/maestro/WORKFLOW.md#testing-discipline), including
  existing checks and necessary new tests, not a test quota. Draft VERIFY.md
  from acceptance, relevant risks, and anti-goals; seed NOTES.md with Current
  State, Next Action, original authorization, and `Base:`.

A SPEC that locks a decision on a derived artifact - a module map, a dependency
graph, a measured table - ships that artifact in the bundle beside SPEC.md,
under `## Derived artifacts`, with the script or command that produced it and a
plain statement of what the method over- or under-approximates. The conclusion
is not the evidence: a stated table nobody can re-run reads as settled
precisely because it is stated with confidence, and a VERIFY check that asks a
later reviewer to re-derive what the design claimed to have settled is the sign
the artifact is missing. l7, d880: an 11-module split was locked on a hand
tally that had asserted away a real cycle and missed the per-module counts by
up to 56 lines, and only reconstruction - the thing the design existed to make
unnecessary - exposed it.

If the next slice's acceptance or authority needs guessing, resolve that
blocker. Otherwise continue implementation when the user's original request
already authorizes it; do not ask again merely because design is complete.
For a design-only request, finish with the proposed scope and implementation
gate. A SPEC authorizes nothing.

For unattended/away-mode design constraints, read
`maestro recipe show unattended`.

© ReinaMacCredy · MIT · ReinaMacCredy/maestro

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
figma-design manutej Скилл figma-design для Claude Code помогает разбирать задачи по Figma: от компонентов и Auto Layout до прототипов и плагинов. Активируется при работе с макетами и дизайн-системами. CX Codex +1 544установок claude-design jiji262 Скилл claude-design для Claude Code: генерирует дизайн-артефакты в HTML — лендинги, слайды, прототипы, постеры, вайрфреймы. Превращает расплывчатый запрос в готовый макет. CX Codex +1 2 400установок deliberation chrono-meta Скилл deliberation для Claude Code, который превращает спор о решении в трёхслойную структуру: новатор предлагает, адвокат дьявола оспаривает, медиатор собирает синтез. CX Codex +1 ★ 33звёзд репо solution-architect zebbern Субагент solution-architect для Claude Code, Codex и Cursor сравнивает архитектурные варианты и рекомендует один с учётом ограничений. Включается, когда требования понятны, но решений несколько. CX Codex ★ 4 719звёзд репо design-code-architecture wondelai Скилл design-code-architecture для Claude Code, Cursor и других платформ проводит вас через восемь фаз архитектурного проектирования — от границ и доменной модели через выбор данных до отказоустойчивости. CX Codex +1 2 700установок design-flow julianoczkowski Скилл design-flow ведёт от уточняющих вопросов до готовых компонентов: шесть фаз подряд, каждая с подтверждением перед следующей. CX Codex +1 5 500установок

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

Весь набор →
maestro-questionnaire Скилл maestro-questionnaire превращает нерешённый вопрос в Markdown-опросник для человека, у которого есть нужные ответы. Подходит для сбора информации асинхронно или на встрече. CX Codex +1 ★ 238звёзд репо maestro-coach Скилл maestro-coach для Claude и Codex, который разбирает непонятный вопрос по шагам и объясняет концепт за решением на реальном коде вашего репозитория. CX Codex +1 ★ 238звёзд репо maestro-bundle Скилл maestro-bundle управляет жизненным циклом связок SPEC, NOTES и VERIFY в фреймворке Maestro и передаёт контекст между сессиями агентов. CX Codex +1 ★ 238звёзд репо maestro-verify Скилл maestro-verify сверяет проверки с критериями приёмки, фиксирует вердикт и помогает закрыть рабочий пакет. Нужен перед передачей результата или закрытием задачи. 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звёзд репо maestro-improve Скилл maestro-improve превращает накопленные уроки в минимальные правки доктрины и правил проекта. Помогает фиксировать опыт сессий без потери истории. CX Codex +1 ★ 238звёзд репо

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

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