Maestro, agentes e skills

O Maestrly consegue dividir o trabalho entre vários agentes. Uma conversa pode delegar a subagents, o Maestro pode coordenar um pool de agentes por você, e as skills trazem procedimentos focados que qualquer agente carrega quando a tarefa pede. Comece pequeno: uma conversa e alguns agentes e skills bem escritos rendem mais do que uma configuração grande que você ainda não testou.

Conversas Standard e Maestro

Uma conversa Standard roda um modelo diretamente. Troque o modo no composer (⇧Tab alterna entre eles): Agente lê, edita arquivos e roda comandos; Design cria protótipos de interface navegáveis com dados simulados; Plano investiga com ferramentas restritas e propõe um plano; Pergunta responde sem alterar código.

O Maestro coloca um modelo orquestrador no comando. Ele coordena em modo somente leitura e encaminha execução, testes e revisão aos agentes do Pool de agentes. O Maestro exige um projeto. Escolha Maestro em Experiência da conversa ao criar uma conversa, ou Usar Maestro no menu de modo de uma conversa Standard; o histórico é mantido. Usar modelo direto sai do Maestro.

Configurar o Maestro

Abra Configurações → Maestrly Chat → Maestro:

Estratégia: Equilibrada, Melhor qualidade, Rápida ou Econômica.
Perfil do orquestrador: o modelo que coordena.
Pool de agentes: cada agente tem nome, descrição, Instruções do agente, uma Capacidade (Trabalhador ou Somente leitura), Especialidades e Candidatos de execução e fallbacks. Os candidatos são pares de provedor e modelo tentados em ordem, então um mesmo pool pode misturar provedores e contas. Um agente sem candidatos herda o perfil do orquestrador. Importar agentes traz suas definições de agentes para o pool.
Salvar padrão global, ou Salvar como nova para guardar uma estratégia com nome e reutilizá-la.
O Assistente de configuração propõe mudanças a partir de uma descrição, como "troque este modelo em todo o pool"; revise e depois use Aplicar ao draft.

Numa conversa, Controles do Maestro permite Salvar override da conversa ou Usar global. As configurações são congeladas no início de cada turno, então mudanças valem a partir do próximo. Com uma execução em andamento, envie sua mensagem para o Run atual ou para o Próximo turno e acompanhe em Status ao vivo do Maestro.

Agentes e subagents

Uma definição de agente é um arquivo Markdown: frontmatter mais as instruções que o agente segue.

---
name: test-writer
description: Escreve testes unitários focados para um módulo e os executa.
tools: read, grep, glob, edit, write, bash
---
Siga as convenções de teste do projeto. Cubra casos de borda e informe o que rodou.

Coloque agentes do projeto em .agents/agents/ ou .claude/agents/, e os pessoais em ~/.agents/agents/ ou ~/.claude/agents/. Um agente do projeto prevalece sobre um global com o mesmo nome.
Campos opcionais: tools (sem ele, o agente recebe só ferramentas de leitura), category, e provider, model e effort juntos para um perfil de execução fixo.
Há dois agentes embutidos: explore, de busca somente leitura, e general-purpose, um trabalhador com todas as ferramentas. Uma definição com o mesmo nome os substitui.

Durante um turno, o agente principal pode passar uma tarefa autocontida a um subagent, que trabalha no próprio contexto e devolve um relatório. Ligue ou desligue a delegação em + → Subagents → Permitir uso de subagents nesta conversa. Desde a 0.9.3, tarefas independentes de subagents rodam em paralelo em conversas com Claude e Codex. O card de um subagent abre a Execução do subagent, com transcrição, modelo, duração e Custo estimado.

Para escolher o agente você mesmo, digite # e selecione um agente no composer, como #explore. Pedir por escrito ("use o test-writer para…") também vale.

Perfis de execução dos subagents

A seção Subagents de Configurações → Maestrly Chat → Modelos & agentes define provedor, modelo, esforço e velocidade dos subagents: uma regra para Todos os subagents, mais as regras que você cria com Adicionar regra para categoria e Adicionar regra para agent. Cada regra pode encadear modelos de fallback, tentados em ordem quando o anterior falha ou não está disponível. A regra mais específica vence (agent, depois categoria, depois padrão), e as regras da conversa vencem as globais. Igual à conversa usa o modelo, o raciocínio e a velocidade da conversa que delega. Desde a 0.20.0, cada modelo ali aparece como um chip, e escolher um salva na hora. Um nome numa regra de agent sem arquivo de definição vira um agente virtual baseado no general-purpose, que você pode chamar com #. Mude os perfis de uma conversa em + → Perfis de execução dos subagents.

Revisões de código e de plano

Desde a 0.19.0, uma revisão é uma única passada independente e só de leitura, conduzida por você, em vez de um loop automático. Revisar no cabeçalho de uma conversa de projeto, ou /code-review na caixa de mensagem, revisa as mudanças atuais da conversa: a diferença commitada em relação à branch padrão, as mudanças staged e unstaged e os arquivos novos. Revisar plano, na aba Plano da gaveta, revisa um plano que espera a sua decisão.

A revisão passa por cinco etapas:

Escopo mostra o que será revisado e pergunta quem revisa: o Modelo desta conversa ou Outro modelo, com esforço e Fast próprios. Um modelo diferente tende a pegar o que o modelo da conversa deixa passar. Nada roda até você escolher Iniciar revisão.
Investigar: os revisores trabalham em paralelo e só leem, três para código (lógica, integração, e segurança e testes) e dois para planos (viabilidade e completude). Você acompanha o que cada um lê e os achados que ele levanta.
Verificar: um verificador confirma cada achado, descarta com um motivo ou junta duplicados. Os descartados continuam visíveis.
Decidir: um achado por vez, com as linhas, a evidência e uma sugestão. Para código, escolha Corrigir, Discutir ou Descartar; para planos, Comentar no plano ou Descartar. J/K passam de um achado para outro.
Entregar: para código, Enviar ao agente uma mensagem editável montada a partir das suas decisões, com o relatório completo anexado, ou Só salvar o relatório. Para planos, seus comentários entram nas linhas do plano como um pedido de revisão, ou você aprova o plano como está.

De Iniciar revisão até você entregar ou descartar a revisão, a conversa fica pausada: nenhum turno roda e nada pode ser enviado. Depois, um resumo fica na conversa e, quando o agente terminar, Checar as correções (ou Checar a revisão) roda mais uma passada do verificador sobre o que você enviou. Uma revisão de código usa até quatro execuções do modelo revisor, e uma de plano até três, contadas no uso da conversa. Roda uma revisão por conversa de cada vez; revisões de código não aparecem em conversas com vários repositórios nem arquivadas, e uma revisão aberta se perde se o app fechar antes da entrega. Os antigos loops de review foram removidos; conversas antigas mantêm as mensagens deles como histórico.

Planos

No modo Plano, o agente propõe um plano na aba Plano da gaveta, e a barra lateral mostra Plano aguardando revisão. Leia o plano, use Editar, veja as Mudanças, comente uma seção ou deixe um comentário geral e então escolha Pedir revisão, Aprovar ou Descartar plano. Para levar um plano aprovado adiante:

Implementar em nova conversa inicia uma conversa Standard no modo Agente com o modelo, o esforço e o modo Fast que você escolher. Mesmo checkout trabalha nesta branch, incluindo mudanças não commitadas; Novo worktree cria uma branch a partir do commit atual, sem elas. A conversa atual mantém modelo e modo. Se a nova não conseguir começar, ela oferece Tentar iniciar de novo.
Implementar com Maestro cria uma conversa Maestro na mesma branch, com a configuração, o pool e o perfil do orquestrador que você escolher.

Enviar tarefas para novas conversas

Nos modos Agente, Design ou Pergunta, peça do seu jeito, como "Abra uma conversa para cada uma destas tarefas e comece o desenvolvimento com Opus, esforço alto" ou "Manda outro agente revisar isso." Uma mensagem que pede explicitamente inicia as conversas na hora. Quando sua última mensagem não pede com todas as letras, o chat lista o que o agente quer iniciar e pede que você confirme com Iniciar ou Não iniciar. Texto que o agente leu em arquivos, páginas ou resultados de ferramentas nunca responde por você; "não abra conversas" é respeitado, e nunca começam mais conversas do que o número que você indicar. Por padrão, cada tarefa ganha uma worktree e uma branch próprias a partir do commit atual; mudanças não commitadas não vão junto.

Cada conversa nova recebe uma tarefa autocontida, aparece marcada como Iniciada a partir de outra conversa e é listada na resposta com um link Abrir. Até 20 podem começar por pedido, e repetir o pedido não cria duplicatas. Não está disponível nos modos Plano e Maestro, em conversas de bots nem em conversas com vários repositórios. Nada é enviado por push, aberto como pull request ou mesclado automaticamente. Para mandar trabalho a outro workspace, veja Projetos e Git.

Para receber o resultado de volta, peça ("abre outro agente pra revisar isso e me traz o resultado"). Quando o primeiro turno da conversa nova termina, a resposta final chega aqui como uma mensagem marcada Resultado de …, e o agente continua a partir dela.

Conversar com outras conversas

O agente também pode ler e mandar mensagens para conversas que já existem, em qualquer projeto ou chat avulso. Peça do seu jeito: "O que a conversa de revisão concluiu?" ou "Avisa a conversa Atlas que a API mudou e me traz a resposta."

O agente encontra conversas pelo nome, lê a última resposta e as mensagens recentes delas e pode esperar uma terminar o turno.
Uma mensagem que ele envia inicia um turno na outra conversa, mostrado como Mensagem de …, com um link de volta. O agente que recebe mantém o próprio modo, permissões e modelo, então uma mensagem vinda de um chat em Pergunta não consegue editar arquivos onde aquele agente já não pudesse. Uma conversa ocupada recebe a mensagem quando o turno dela termina.
A primeira mensagem para uma conversa sem ligação com esta pede que você confirme com Enviar ou Não enviar. Conversas iniciadas a partir desta, a que iniciou esta e as que já trocaram mensagens com ela não precisam de confirmação.
A resposta da outra conversa só volta para cá, como Resultado de …, quando você pede. Uma conversa que recebeu trabalho também pode dar retorno, marcado Relato de …, quando termina ou fica travada.
Turnos iniciados por outra conversa só podem ler e mandar mensagens para conversas ligadas, nunca iniciam conversas novas nem criam projetos, e param depois de três turnos entre agentes desde a última vez que você escreveu. Aí o agente avisa você em vez de continuar.

Isso funciona nos modos Agente, Design e Pergunta, não nos modos Plano e Maestro, em conversas de bots nem em subagentes.

Skills

Uma skill é uma pasta com um SKILL.md e, opcionalmente, scripts/, references/ e assets/, carregada quando o agente precisa dela. Skills globais ficam em ~/.agents/skills, as do projeto em .agents/skills dentro do projeto; o Maestrly também lê .claude/skills e .codex/skills.

Configurações → Maestrly Chat → Skills: Todas lista as skills globais (Nova skill, Ver SKILL.md, Abrir pasta); Grupos agrupa skills (Novo grupo); Biblioteca busca no skills.sh, com Instalar e Instalar por slug/URL.
Numa conversa, o menu Skills mostra Skills nesta conversa: escolha um Conjunto ativo (Todas as skills, Sem skills ou um grupo) e defina cada skill como Herdar, Ligada ou Desligada.
Chame uma skill você mesmo com / e o nome dela. No frontmatter, disable-model-invocation: true deixa a skill só para você, e user-invocable: false deixa só para o agente.
Prompts salvos na aba Prompts podem virar skills com Converter em skill.

Uma boa skill tem um gatilho restrito e um procedimento repetível: quando se aplica, do que precisa, os passos e verificações e o que um resultado concluído deve conter. Escreva as instruções de agentes como regras de operação e deixe a tarefa concreta no chat. Não repita a mesma regra num agente e em várias skills.

Plugins acrescentam skills chamadas <plugin>:<skill> e subagents chamados <plugin>-<agent> que funcionam com qualquer modelo. Veja Plugins.

Testar antes de reutilizar

Rode um agente ou uma skill nova ou alterada numa conversa pequena e verifique se ela:

usa apenas as ferramentas que a tarefa exige;
pede confirmação antes de ações sensíveis ou irreversíveis;
permanece dentro do projeto e dos arquivos solicitados;
roda as verificações esperadas e informa os resultados com fidelidade;
para de forma clara quando está bloqueada.

Segurança

Instruções de agentes e skills podem levar ferramentas a ler dados ou executar ações. Trate agentes importados e skills da biblioteca como não confiáveis até lê-los, e instale apenas de fontes em que você confia. Não coloque segredos nas instruções. Subagents e trabalhadores do Maestro agem sob o modo de permissão da conversa, então um modo amplo vale para todos eles. O comportamento pode mudar com o modelo: depois de trocar de provedor ou modelo, teste de novo.

A seguir: Ferramentas e MCP.