Conceitos

Algumas poucas ideias explicam como o Maestrly funciona. Quando elas se encaixam, todo o resto segue.

Workspace

Um workspace mapeia um projeto a um repositório Git local. É a casa das conversas, dos quadros, das notas e da memória daquele projeto. Adicionar um workspace não move nem copia seu código — o Maestrly trabalha no lugar, no seu repositório.

Conversa

Uma conversa é uma sessão de trabalho com um agente de IA dentro de um workspace. Cada conversa nasce na sua própria branch e worktree isoladas, então vários agentes podem rodar em paralelo sem pisar uns nos outros. Você escolhe qual CLI atende uma conversa ao criá-la, e pode trocar de ferramenta depois (veja Handoff).

CLI (sua ferramenta de IA de codificação)

Uma CLI é a ferramenta de linha de comando de IA de codificação que de fato faz o trabalho — você usa a sua. O Maestrly detecta as ferramentas instaladas na sua máquina e as executa para você, mostrando a interface de terminal de cada uma dentro do app. O Maestrly orquestra as ferramentas; nunca revende nem intermedeia seu uso de IA, e sua assinatura continua com o provedor.

Handoff

O handoff permite trocar a CLI que atende uma conversa sem perder o contexto. Quando você muda de ferramenta no meio da conversa, o Maestrly empacota o que foi dito e feito até ali e entrega à nova ferramenta para ela ler antes de continuar — assim o novo agente retoma de onde o anterior parou. Isso deixa você aproveitar os pontos fortes de cada ferramenta dentro de uma única linha de trabalho.

Quadro (Kanban)

Cada workspace tem um quadro Kanban. Além de organizar tarefas, colunas podem ser configuradas como colunas "agente" que disparam automaticamente uma conversa quando um card chega — transformando o quadro num pipeline (por exemplo: produzir → revisar → concluído). Cards e conversas são vinculados, então você pula de um card para o agente que está trabalhando nele e volta.

Notas, memória e busca de entregas

Os três se parecem, mas servem a propósitos diferentes — o Maestrly os mantém distintos:

Notas — notas multi-página, estilo Notion, anexadas a uma conversa ou ao projeto inteiro. Você as escreve, e os agentes também podem lê-las e escrevê-las. Ótimas para specs, checklists e contexto de rascunho.
Memória do projeto — uma memória por projeto que o Maestrly injeta nas ferramentas de IA quando elas iniciam, para que fatos duráveis sobre o projeto sobrevivam entre conversas e ferramentas. É separada das notas: a memória é o contexto pequeno e sempre presente; as notas são os documentos mais longos.
Busca de entregas — quando o trabalho chega à coluna "Concluído" do quadro, sua entrega é indexada localmente para que conversas posteriores possam buscar entregas anteriores em busca de contexto relevante. É recuperação sobre o que você já entregou, calculada na sua máquina.

Local por design

Em todos esses casos, a regra é a mesma: as ferramentas de IA e suas credenciais rodam e ficam armazenadas localmente, no keychain do seu sistema. Seu código, seus prompts e as respostas dos agentes não são enviados aos servidores do Maestrly — apenas o mínimo necessário para manter sua conta.

A seguir: Visão geral dos recursos.