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.
git clone --depth 1 https://github.com/ReinaMacCredy/maestro /tmp/maestro-conduct && cp -r /tmp/maestro-conduct/.claude/skills/maestro%3Aconduct ~/.claude/skills/maestro-conductSKILL.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
>-
>-
Use when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos. Examples: \"Index this repo\", \"Reanalyze the codebase\", \"Generate a wiki\"
Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: \"Why is X failing?\", \"Where does this error come from?\", \"Trace this bug\"
Use when the user asks how code works, wants to understand architecture, trace execution flows, or explore unfamiliar parts of the codebase. Examples: \"How does X work?\", \"What calls this function?\", \"Show me the auth flow\"
Use when the user asks about GitNexus itself — available tools, how to query the knowledge graph, MCP resources, graph schema, or workflow reference. Examples: \"What GitNexus tools are available?\", \"How do I use GitNexus?\"
Use when the user wants to know what will break if they change something, or needs safety analysis before editing code. Examples: \"Is it safe to change X?\", \"What depends on this?\", \"What will break?\"
Use when the user wants to rename, extract, split, move, or restructure code safely. Examples: \"Rename this function\", \"Extract this into a module\", \"Refactor this class\", \"Move this to a separate file\"