> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Como funciona programar com o Replit

> Acompanhe seu código desde um repositório conectado do GitHub ou GitLab até um preview de desenvolvimento em execução, entenda o workspace e prepare uma contribuição revisada.

O Replit executa seu código em um [sandbox](https://docs.replit.com/pt/build/code/navigate-your-workspace.md#arquivos-e-ambiente), um ambiente de desenvolvimento isolado na nuvem. Seu repositório, suas ferramentas de desenvolvimento e seu app em execução ficam lá enquanto você trabalha pelo chat. Seu app de produção continua hospedado onde está.

O sandbox roda em uma microVM, uma máquina virtual leve que isola a carga de trabalho de desenvolvimento. Um ambiente reutilizável pode fornecer a configuração dele. Saiba mais sobre [ambientes e sandboxes](https://docs.replit.com/pt/build/code/navigate-your-workspace.md#arquivos-e-ambiente).

## Do seu repositório a uma alteração revisada

![Conecte o GitHub e execute um repositório com o Replit, peça alterações e confira o preview, depois proponha um pull request em rascunho para sua equipe revisar e fazer o merge.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/code-relationships.svg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=bcb91d406f25bb0cf4cda81faac06a55)

## 1. Acesso ao repositório e um preview em execução

Quando você conecta sua conta do [GitHub](https://github.com) ou do [GitLab](https://gitlab.com), o Replit pode acessar repositórios por meio das permissões que você autoriza. A conexão não concede permissões que você ainda não tem. Quando você informa a URL de um repositório e pede ao Replit que o execute, o Replit clona o código em um sandbox.

As instruções e skills armazenadas com seu código vêm junto com ele:

* **`AGENTS.md` e `CLAUDE.md`:** Orientações como convenções de código, comandos de configuração e verificações obrigatórias. As instruções se aplicam dentro do escopo do diretório delas.
* **Skills:** Instruções específicas de tarefas em arquivos `SKILL.md`. O Replit descobre as skills ativadas em `.agents/skills` e `.claude/skills`, incluindo diretórios aninhados, e lê as skills relevantes quando necessário.

O Replit prepara ou reutiliza a configuração de desenvolvimento, instala as dependências e inicia o app. Ele lê o código e as orientações relevantes em vez de carregar o repositório inteiro na conversa.

O editor reúne o preview em execução e o seu chat. Você pode interagir com o app enquanto conversa com o Replit sobre o código ou sobre uma possível alteração.

![O editor do Replit mostra o chat à esquerda, o preview do app em execução no centro e Details à direita.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/workspace/overview.jpg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=f25d44195dd35c4a289b658f912035f1)

Um [preview](https://docs.replit.com/pt/build/code/navigate-your-workspace.md#preview) é a sua versão de desenvolvimento, não um deployment de produção. A configuração que funciona pode ser salva como um [ambiente reutilizável](https://docs.replit.com/pt/build/code/create-reusable-environment.md) para chats futuros. Os controles do editor são explicados em [Navegue pelo seu editor](https://docs.replit.com/pt/build/code/navigate-your-workspace.md).

## 2. Alterações na cópia de desenvolvimento

Quando você descreve uma alteração, o Replit edita a cópia de desenvolvimento usando o código existente e as orientações do repositório. Essas edições não atualizam imediatamente o repositório compartilhado.

O preview permite inspecionar o resultado e dar feedback no chat. O Replit também pode testar o app em um navegador e executar as verificações do repositório. Os resultados ajudam você a entender o que foi verificado e o que continua incerto antes de a contribuição ser proposta.

Esse processo serve tanto para pequenas correções quanto para funcionalidades maiores.

## 3. Trabalhando com uma equipe de agentes

Um único chat principal pode coordenar várias tarefas independentes. O Replit entrega cada tarefa a um agente auxiliar em um chat separado e traz as descobertas ou os resultados de volta ao chat principal.

![O chat principal se divide em dois agentes auxiliares, cada um cuidando de uma tarefa em um chat separado.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/main-chat-workers.svg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=d61a765dbfb1e2bcec911b4321982633)

Você pode acompanhar cada tarefa individualmente e manter a conversa geral no chat principal. Consulte [Agents](https://docs.replit.com/pt/build/code/navigate-your-workspace.md#agents) para os conceitos ou [Trabalhe com uma equipe de agentes](https://docs.replit.com/pt/build/code/coordinate-work.md) para um exemplo.

## 4. Um pull request em rascunho

Quando você pede ao Replit que abra um pull request em rascunho, ele cria uma branch de contribuição, faz commit e push das alterações e abre o pedido em seu nome. No GitLab, isso é um merge request em rascunho.

O pedido explica o que mudou e pode incluir resultados de testes e evidências visuais. Sua equipe pode inspecionar as alterações propostas sem trazê-las ainda para a branch de destino.

Um rascunho sinaliza que a contribuição não está pronta para a aprovação final. Marcá-lo como pronto para revisão o leva ao processo de revisão da sua equipe. [Fundamentos do Git](https://docs.replit.com/pt/build/code/git-essentials.md) explica branches, commits e pull requests.

## 5. Revisão, ajustes e merge

Sua equipe revisa a contribuição e deixa perguntas ou sugestões. O Replit pode ajudar a [resolver o feedback](https://docs.replit.com/pt/build/code/respond-to-review-feedback.md), verificar os ajustes, fazer push deles para a mesma branch e responder aos comentários. O pedido existente é atualizado à medida que a conversa continua.

Depois que as revisões e verificações necessárias forem concluídas, você ou um colega autorizado pode fazer o merge da contribuição. As permissões do seu repositório e as regras de branch continuam valendo.

O merge incorpora a alteração à branch de destino. O deployment segue o processo de lançamento da sua equipe; algumas equipes fazem o deploy automaticamente após o merge, enquanto outras lançam separadamente.

> [!NOTE]
>
> O isolamento não remove as permissões concedidas ao código executado no sandbox. As credenciais de desenvolvimento devem ter apenas o acesso necessário. O acesso pessoal ao repositório e o acesso compartilhado para builds de ambiente em segundo plano são separados; consulte [Gerencie o acesso ao repositório](https://docs.replit.com/pt/build/code/manage-repository-access.md) e [Segurança](https://docs.replit.com/pt/build/code/security.md).
