Documentação

Documentação › Maestro

Maestro

O Maestro é um Claude Code ou um Codex que decide quando vale dividir o trabalho. Ele recruta outros terminais com papéis, prepara notas, portais e desenhos, acompanha cada um e fecha o time quando termina.

O que é o Maestro

MacWindowsLinuxdesde a 1.0.0

O Maestro é um Claude Code ou um Codex que decide sozinho quando vale dividir o trabalho. Em tarefas pequenas ele trabalha só; quando há partes independentes (frontend e backend, fazer e revisar, testar), ele recruta agentes ligados a ele e dirige o time.

O Maestro recruta um Dev e um Revisor e passa a primeira tarefa

Passo a passo

  1. Ligue o Maestro num cartão do Claude Code ou do Codex: no Novo terminal, ou no botão da varinha da barra do cartão (“Tornar Maestro”).
  2. Peça a tarefa como sempre. Se quiser, diga quantos agentes usar, ou peça para ele trabalhar sozinho.
  3. Os recrutas aparecem abaixo dele, ligados por cabos, cada um com o selo do seu papel. Eles recebem a primeira tarefa e respondem ao Maestro quando terminam.
  4. O Maestro acompanha o time, conta o andamento para você e fecha os recrutas quando o trabalho deles acaba.

Os recrutas usam a mesma IA do Maestro; outra só se você pedir (“revise com o Codex”). Shells para builds e servidores ele sempre pode abrir. O time costuma ser pequeno, de dois a cinco.

Veja tambémLigar o MaestroComo ele recrutaComandos do Maestro

Ligar o Maestro

MacWindowsLinuxdesde a 1.0.0

O Maestro se liga por cartão, em três lugares: no Novo terminal, no botão da barra do cartão e no menu do botão direito. O agente é avisado na hora.

O botão do Maestro aceso na barra e o selo no cartão
O botão do Maestro aceso na barra e o selo no cartão

Passo a passo

  1. No Novo terminal (⌘TCtrl+Shift+T), escolha Claude Code ou Codex e ligue “Maestro”.
  2. Num cartão já aberto, clique no botão da varinha na barra (“Tornar Maestro”) ou use o botão direito › “Maestro”.
  3. O cartão ganha o selo “Maestro” e um aviso confirma. O agente recebe uma mensagem dizendo que agora é o Maestro.
  4. Para desligar, use o mesmo botão (“Deixar de ser Maestro”) ou o menu. Os recrutas continuam no canvas, ligados a ele.
Novo terminal⌘TCtrl+Shift+T

Só Claude Code e Codex viram Maestro. Um workspace pode ter mais de um.

Veja tambémNovo terminal

Como ele recruta

MacWindowsLinuxdesde a 1.0.0

Cada recruta é um terminal novo, ligado ao Maestro, com um papel que ele inventa para aquele time. Além de agentes, ele cria notas, portais, árvores de arquivos e quadros Draw, liga os cartões entre si e os agrupa.

Um Maestro com três recrutas, uma nota de plano e um Draw
Um Maestro com três recrutas, uma nota de plano e um Draw

Passo a passo

  1. Os recrutas entram abaixo do Maestro, no grupo dele, com o selo do papel no cabeçalho. Passe o mouse no selo para ler as instruções daquele papel.
  2. Cada papel ganha uma cor: laranja, azul, vermelho, roxo, verde, ciano, rosa ou cinza. Dois recrutas com o mesmo papel têm a mesma cor.
  3. O que vale para o time inteiro vai numa nota, ligada a quem precisa. Para ver o site, ele abre um portal; para desenhar a arquitetura, um Draw; para olhar arquivos, uma árvore.
  4. Num servidor cadastrado, ele abre um shell lá e roda os comandos ele mesmo.
  5. Os recrutas só conversam entre si pelos cabos que o Maestro liga. Ele passa novas tarefas, pergunta e olha a tela de cada um.

Os papéis valem só para aquele time: somem com os cartões e não passam para o próximo.

Veja tambémComandos do MaestroPapel… à mão

Papel… à mão

MacWindowsLinuxdesde a 1.0.0

Você também dá um papel a qualquer terminal, com ou sem Maestro. O papel aparece no selo do cartão e o agente é avisado.

O pedido do papel de um terminal
O pedido do papel de um terminal

Passo a passo

  1. Clique com o botão direito no terminal e escolha “Papel…”. Com um papel já dado, o item mostra o nome dele, como “Papel: Revisor…”.
  2. Digite o nome, por exemplo Revisor, e clique em “Salvar”. O selo aparece no cabeçalho, com uma cor.
  3. Para tirar o papel, apague o nome e salve.

Um papel com o mesmo nome de outro cartão do workspace usa a mesma cor.

Veja tambémComo ele recruta

Fechar os recrutas

MacWindowsLinuxdesde a 1.0.0

Quando o trabalho de um recruta acaba, o Maestro fecha o cartão, junto com as notas, os portais e as árvores que ele criou. Para fechar um cartão que não recrutou, ele pede a você.

O Maestro pede para fechar um cartão que não é dele
O Maestro pede para fechar um cartão que não é dele

Passo a passo

  1. O Maestro fecha os próprios recrutas sozinho. A sessão de cada um termina; um agente vai para o histórico do workspace, e um shell sai do canvas.
  2. Para fechar outro cartão, ele pergunta: “O Maestro … quer fechar …”. “Fechar” deixa; “Não” mantém o cartão.
  3. Você também pode fechar um recruta como qualquer cartão.

Desligar o Maestro não fecha nada: os recrutas ficam no canvas, ligados a ele.

Veja tambémRodadas no histórico

Mover um Maestro com o time

Macdesde a 1.0.0

Ao mover um Maestro para outro workspace sem os recrutas dele, o Octopus pergunta se o time vai junto. Os que ficarem viram agentes comuns.

A pergunta ao mover um Maestro
A pergunta ao mover um Maestro

Passo a passo

  1. Escolha o Maestro e use o botão direito › “Mover para workspace” › o destino.
  2. Em “Levar o time do Maestro junto?”, escolha “Levar o time” para mover os recrutas também, ou “Só o Maestro”.
  3. As sessões continuam rodando durante a mudança. Um aviso diz para onde foram, com “Ir para” o workspace e “Desfazer”.

Movendo o grupo inteiro, o time já vai junto e o Octopus não pergunta.

Veja tambémMover cartões e grupos entre workspaces

Rodadas no histórico

MacWindowsLinuxdesde a 1.0.0

Um Maestro fechado, com os recrutas fechados junto, forma uma rodada no histórico do workspace. Ela volta inteira com um clique, cada agente na mesma conversa.

Uma rodada do Maestro no histórico
Uma rodada do Maestro no histórico

Passo a passo

  1. Abra o Histórico do workspace (⌘YCtrl+Shift+Y) e escolha “Rodadas”.
  2. Cada linha mostra “Rodada de” e o nome do Maestro, quantos recrutas, a máquina, a pasta e a última frase do Maestro.
  3. “Retomar a rodada” reabre o Maestro e os recrutas juntos e mostra o time na tela.
  4. “Ver os cartões” lista cada um, para reabrir só o que você quer.
Histórico do workspace⌘YCtrl+Shift+Y

Veja tambémRodadas do MaestroFechar os recrutas