Maestro Design

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

maestro-design

Use when a material choice blocks the next slice. Read Decisions and readiness and 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:

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:

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.