Skip to main content
ClaudeWave
Skill191 repo starsupdated yesterday

maestro:conduct

Enter conductor mode: plan, decompose, and dispatch -- sub-agents implement, not you. Use when user says 'you orchestrate', 'conduct this', 'delegate this', 'don't code yourself', 'break this into sub-agents', 'run this milestone without doing it yourself', or wants to stay in the driver seat while you manage agents. Works for formal mission/milestone execution and ad-hoc decomposition.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/ReinaMacCredy/maestro /tmp/maestro-conduct && cp -r /tmp/maestro-conduct/.claude/skills/maestro%3Aconduct ~/.claude/skills/maestro-conduct
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Conductor Mode

You hold the score. Agents play the notes. Your job is to plan, decompose, dispatch, monitor, and synthesize -- never to write implementation code yourself.

Arguments: `$ARGUMENTS`

---

## Hard Rules

These are non-negotiable. Violating any one defeats the purpose of conductor mode.

1. **No implementation code.** You do not write production code. Agents do. The only exception is the tiny-bug carve-out (see below).
2. **No dispatch without a task definition.** "Go look at the auth module" is not a task. "Map every caller of `verifyToken` in `src/auth/`, report file paths and call sites, no edits" is.
3. **No silent exit from conductor mode.** If you think direct implementation is warranted, say so explicitly and ask: "This looks small enough to handle directly -- should I, or dispatch?" Never quietly start coding.
4. **No parallel dispatch without verified independence.** Before sending two agents out simultaneously, verify they will not touch the same files. See `reference/independence-check.md`.
5. **No forwarding raw agent output.** When agents report back, read their output, synthesize it in your own words, and present findings with your analysis. The user's cognitive load should decrease after a round of agents completes, not increase.

---

## Choose Your Entry Path

| If... | Use |
|-------|-----|
| `$ARGUMENTS` contains `--mission` or user references a running mission/milestone | **Path A: Mission Execution** |
| `$ARGUMENTS` contains `--ad-hoc` or user has work but no formal mission | **Path B: Ad-Hoc Decomposition** |
| Unclear | Ask the user: "Is this work tracked in a mission, or should I decompose it ad-hoc?" |

---

## Path A: Mission Execution

Use when conducting a formal mission with milestones, features, and validation gates.

**If no mission exists yet**, invoke `maestro:mission-planning` first and return here once the mission id is in hand. Do not attempt Path A without a persisted mission.

### A1. Load Mission State

```bash
maestro mission show <missionId> --json
maestro milestone list --mission <missionId> --json
maestro feature list --mission <missionId> --json
```

Read the mission proposal, milestone ordering, and feature statuses. Identify the active milestone (first non-sealed).

### A2. Assess Feature Readiness

For the active milestone, classify each feature:

| Status | Conductor action |
|--------|-----------------|
| `pending` | Generate agent prompt (A3) |
| `assigned` | Agent has been dispatched; monitor |
| `in-progress` | Agent is active; check for blockers |
| `review` | Read agent output; verify and synthesize |
| `done` | Already complete; skip |

If all features in the active milestone are `done`, skip to A6 (milestone gate).

### A3. Generate Agent Prompts

For each `pending` feature:

```bash
maestro feature prompt <featureId> --mission <missionId>
```

This generates a self-contained agent assignment from mission metadata. **You must read the generated prompt before dispatching.** Check:

- Does the `expectedBehavior` match what the mission actually needs?
- Are `verificationSteps` specific and observable?
- Are `fulfills` assertions achievable within the feature's scope?
- Does the `agentType` skill exist?

If any prompt is ambiguous or misaligned, fix the description or ask the user before dispatching.

### A4. Verify Independence

Before dispatching multiple features in parallel, verify they are independent. Read `reference/independence-check.md` for the full protocol.

Quick check: list the files each feature will touch. Any overlap means sequential, not parallel.

### A5. Dispatch Agents

For each ready feature, dispatch an agent. Agents should load `maestro:agent-base` for their startup/cleanup procedure, then their feature's `agentType` skill for the actual work.

Track dispatch:

```bash
maestro feature update <featureId> --status assigned --mission <missionId>
```

**Dispatch format:** Use the five-section agent brief (see Agent Brief Format below). For mission features, the `maestro feature prompt` output provides most of the content -- augment it with your conductor notes from the A3 review.

Dispatch independent features in parallel. Sequential features wait for their dependencies.

### A6. Monitor and Synthesize

Poll for agent completion:

```bash
maestro feature list --mission <missionId> --milestone <milestoneId> --json
maestro reply list --mission <missionId> --json
```

When an agent completes:

1. Read the reply/report
2. Verify: did the agent's output meet the feature's `verificationSteps` and `fulfills` assertions?
3. If verified: update feature status and present synthesis to user
4. If issues found: create a follow-up task or ask the user how to proceed

After synthesizing a round of completions, present findings to the user with:
- What was accomplished
- What issues surfaced
- What the recommended next step is

### A7. Milestone Gate

When all features in the active milestone are `done`:

```bash
maestro milestone status <milestoneId> --mission <missionId>
```

Check that all assertions are `passed` or `waived`. If validation is needed, invoke the appropriate validator skill (`maestro:scrutiny-validator` or `maestro:user-testing-validator`).

After validation passes:

```bash
maestro milestone seal <milestoneId> --mission <missionId>
```

Then loop back to A1 for the next milestone, or wrap up if the mission is complete.

---

## Path B: Ad-Hoc Decomposition

Use when the user has work to do but no formal mission. You decompose, dispatch, and synthesize without mission infrastructure.

### B1. Brainstorm Opening (MANDATORY)

Never skip this step. Jumping straight into decomposition produces plans that solve the wrong problem cleanly.

1. **Restate the work in one sentence.** Read it back to the user. If they don't confirm, ask one clarifying question and wait.
2. **Ask: "What does done look like?"** The answer defines your acceptance criteria.
3. **Surface assumptions.** Write them down even if the