Projetos e Git

Um projeto conecta chats aos arquivos em que eles podem trabalhar. O suporte a Git oferece a cada tarefa um conjunto visível de mudanças e, quando necessário, um ambiente isolado.

Adicionar um projeto

Escolha Adicionar projeto e selecione uma pasta local. Para projetos de código, prefira a raiz do repositório. Antes de iniciar, confirme:

que o Git reconhece o repositório e a branch atual;
que você entende as mudanças já existentes na árvore de trabalho;
que as dependências de build e teste estão disponíveis;
que segredos e arquivos gerados estão cobertos pelas regras de ignore do projeto.

O Maestrly trabalha nos arquivos locais selecionados. Repositórios e worktrees permanecem nos caminhos existentes; contexto selecionado pode ser enviado a provedores e ferramentas em operações autorizadas.

Escolher um modo de execução

O checkout atual usa a pasta e a branch já abertas na sua máquina. Escolha esse modo para trabalho supervisionado em que o agente e seu editor compartilham os mesmos arquivos. Mudanças ainda não commitadas fazem parte desse ambiente, então delimite bem a tarefa.

A worktree isolada cria uma árvore de trabalho e branch Git separadas para o chat. Escolha esse modo para chats paralelos ou trabalho que deve ser revisado antes de tocar no checkout atual.

Evite atribuir dois chats automatizados ao mesmo checkout. Worktrees isolam arquivos, mas recursos externos compartilhados — bancos, portas, credenciais ou ambientes de nuvem — ainda podem entrar em conflito.

Trabalhar em vários repositórios

Se uma tarefa exigir mais de um repositório, adicione apenas os necessários para o resultado. Declare qual repositório deve receber cada mudança e revise cada diff separadamente. Trabalho entre repositórios pode exigir branches, testes e etapas de entrega distintas.

Revisar o resultado

Antes de entregar:

inspecione arquivos alterados e não rastreados;
compare o diff com o escopo solicitado;
rode testes focados, formatação, checagem de tipos ou build;
procure segredos, arquivos gerados por acidente e edições sem relação;
faça commit com uma mensagem que descreva o resultado verificado.

Não faça merge ou deploy apenas porque o agente informou que terminou. Trate o resumo dele como um resultado a verificar.

Limpar com segurança

Faça merge, cherry-pick ou entregue a branch revisada pelo seu processo Git normal. Remova uma worktree apenas depois de confirmar que todas as mudanças desejadas estão commitadas ou preservadas em outro lugar. Se abandonar uma tarefa, inspecione as mudanças não commitadas antes de descartar qualquer coisa.

A seguir: Uso e custos.