Mastra Factory: do issue ao PR com agentes de IA

Mastra Factory é um ambiente de código aberto para desenvolvimento de software com agentes de IA. Ele reúne repositórios, entrada de tarefas, planejamento, implementação e revisão de pull requests. A proposta é delegar trabalho de programação sem perder o controle sobre escopo, plano e aprovação do código.

Em termos simples, para que serve o Mastra Factory?

Imagine abrir um issue para corrigir um problema no aplicativo. Um agente examina o projeto, propõe um plano, altera arquivos e executa verificações. Depois, a equipe confere a mudança antes de incorporá-la ao código. O Factory organiza esse caminho e mantém a conversa ligada à tarefa.

Os usos incluem desenvolver funcionalidades, corrigir bugs, refatorar e escrever testes. O resultado pode ser um PR rastreável, em vez de apenas uma resposta com trechos de código. Ainda é necessário configurar repositório, acesso ao modelo e ambiente de execução, além de saber avaliar o resultado.

Como o trabalho passa pelas etapas

Intake, Triage, Planning, Building, Review e Done organizam a entrega. Regras configuráveis definem como cada tipo de trabalho avança. A equipe responde dúvidas na triagem e pode revisar ou editar o plano antes da implementação.

Cada item de trabalho tem sua sessão. O PR possui um item de revisão e uma sessão separados. Por isso, fazer o merge de um PR não significa necessariamente concluir toda a tarefa original. Podem ser necessários outros PRs; confira os critérios de aceitação e o estado do trabalho.

Primeiro teste com um repositório existente

O guia oficial de início descreve este percurso:

1. Fora do repositório que será alterado, execute npm create factory@latest my-factory e conclua a configuração.
2. Configure FACTORY_CREDENTIAL_ENCRYPTION_KEY uma única vez no .env. Se estiver ausente, o guia usa openssl rand -base64 32. Guarde uma cópia protegida: trocar a chave pode impedir a leitura de credenciais armazenadas.
3. Rode npm run dev, abra o endereço indicado e conecte GitHub e o provedor do modelo. Linear é opcional.
4. Em Settings → Work Intake, habilite a sincronização de issues e selecione o repositório. Autorizar acesso ao código e assinar a entrada de tarefas são etapas diferentes.
5. Crie uma tarefa pequena, como melhorar o README, com critérios claros. No primeiro teste, mantenha desativados o início automático e a aprovação automática de planos.
6. Leia a investigação, responda às perguntas e revise o plano. Depois da implementação, confira diff, saída real das ferramentas e verificações do PR antes do processo normal de revisão e merge.

Hospedagem e caminho dos dados

Há três opções: plataforma completa, servidor local com recursos Mastra e hospedagem totalmente própria. Um servidor local ainda pode usar autenticação, PostgreSQL e sandboxes na nuvem. Abrir a interface no computador não garante que tudo seja processado nele.

A opção --no-platform exige configurar autenticação, banco persistente e execução. Produção requer um processo Node.js contínuo e HTTPS compatível com streaming. Consulte os requisitos de implantação.

O acesso ao modelo depende da conta do provedor. Credenciais pessoais e organizacionais têm escopos diferentes. Armazene chaves nas configurações apropriadas, não em issues. Antes de usar código privado, revise a política de privacidade e os termos dos provedores de modelo e sandbox escolhidos.

Plano gratuito, consumo e licença

Verificado em 10 de setembro de 2026: os preços oficiais em dólar mostram Starter por US$ 0/mês, incluindo 100 mil eventos de observabilidade, 24 horas de CPU e 15 dias de retenção. Teams aparece por US$ 250/mês; Enterprise depende de orçamento.

Esses limites não representam tarefas de programação ilimitadas. Uso de modelos, recursos excedentes e infraestrutura podem gerar cobrança. Confira a tabela completa; os valores não são preços finais em reais com tributos locais. Segundo a documentação de licença, a maior parte do código usa Apache 2.0, enquanto recursos enterprise em ee/ exigem licença válida para produção.

Perguntas frequentes

Posso conectar um projeto que já existe?

Sim. Conecte o repositório GitHub e configure o intake de issues. Você pode adicionar Linear quando fizer sentido.

O uso é totalmente gratuito?

Não. Código aberto e nível gratuito não eliminam custos de modelos, excedentes, hospedagem ou licenças enterprise.

Rodar localmente mantém todos os dados no computador?

Não automaticamente. Servidor, autenticação, banco, modelo e sandbox precisam ser avaliados em conjunto.

Quem decide se o código será aceito?

A equipe pode esclarecer a tarefa, aprovar o plano e decidir o merge do PR. As regras do quadro determinam o grau de automação.

Recursos oficiais e comunidade

• Documentação Factory — configuração e primeiros passos.
• GitHub do Mastra — código e issues.
• Discord oficial — comunidade de desenvolvedores.
• Mastra no X — anúncios.
• Contato com a equipe — demonstrações e dúvidas enterprise.