YouMind
Entrar

Git Explicado com Diagramas: Um Guia para Iniciantes do Ensino Médio

@dan_pro_man
JAPONÊS10 de out. de 2026
106K
205
23
0
674

TL;DR

Um guia amigável para iniciantes que explica o fluxo de trabalho essencial do GitHub, incluindo a criação de repositórios, envio de pull requests, revisão de diffs e reversão de alterações, especialmente adaptado para usuários que utilizam assistentes de programação por IA.

Você usa o GitHub sem saber direito o que está fazendo?

Usar no escuro é pedir para quebrar algo.

No GitHub, existem apenas três botões verdes.

E há um só lugar para olhar antes de apertá-los.

Este artigo mostra todos os pontos da tela do GitHub onde você precisa olhar e clicar, destacados com caixas vermelhas.

Conectar, enviar, conferir o diff, fazer merge e reverter.

Vamos percorrer esse ciclo completo usando 10 capturas de tela reais.

A IA digita.

Você olha e aperta os botões.

Vou explicar os termos mais difíceis de forma simples conforme eles aparecerem.

※ As telas e especificações do GitHub neste artigo foram verificadas em outubro de 2026. As telas podem mudar.

Capítulo 1: Conectando ao GitHub | Crie um Repositório e Envie seus Registros Locais

A interface do GitHub é em inglês.

Mas os lugares onde você clica são sempre os mesmos.

As caixas vermelhas na tela mostram onde olhar e onde clicar.

Neste capítulo, há apenas um botão verde para apertar.

Primeiro, crie um repositório.

Um repositório é como um armário onde você guarda seus registros do Git online.

Eu expliquei o que vai dentro desse armário e quatro termos essenciais em uma publicação anterior.

【Com Diagramas】Git Explicado para Estudantes do Ensino Fundamental

https://x.com/dan_pro_man/status/2107224533099069671?s=20

Mesmo que você não tenha lido, dá para completar o ciclo inteiro só com este artigo.

Faça login no GitHub e selecione "New repository" no ícone "+" no canto superior direito.

Abrir https://github.com/new leva você à mesma tela.

だん|AI×クラウドエンジニア - inline image

A única coisa que você precisa preencher é o nome.

Digite um nome alfanumérico em "Repository name".

"git-practice" serve perfeitamente.

Selecione "Private" em "Choose visibility".

Isso significa que ele não será público.

Deixe a opção "Add README" desativada por enquanto.

Se você já tem registros locais, é mais fácil conectar criando um repositório vazio.

Aperte o botão verde "Create repository" na parte inferior.

A tela que aparece logo depois de clicar é a parte mais importante deste capítulo.

だん|AI×クラウドエンジニア - inline image

Quase no final, há um título: "…or push an existing repository from the command line".

As três linhas abaixo dele são os comandos que vamos usar hoje.

As sete linhas acima são para quem ainda não tem registros locais, então pode ignorá-las.

Veja o que cada uma das três linhas significa:

Linha 1: Informa ao seu registro local o endereço deste armário.

Linha 2: Ajusta o nome da branch principal para "main".

Linha 3: Guarda a branch principal no armário.

Copie o endereço (caixa vermelha) dessa tela e envie para a IA em uma linha.

text
1Envie os registros desta pasta para https://github.com/nome-da-conta/git-practice

O Claude Code vai digitar as três linhas sozinho.

O Claude Code é uma IA que executa tarefas no seu computador seguindo instruções.

No meu manual de instruções, eu exijo confirmação antes do push.

Push é a operação de guardar os registros locais no armário.

Por isso, ele para aqui por um momento.

Responda "Yes" e atualize a tela do navegador.

だん|AI×クラウドエンジニア - inline image

Onde estavam os três comandos, agora aparecem seus arquivos locais enfileirados. Ao lado deles, está a mensagem de commit.

Esse é o sinal de que você está "conectado".

Tem uma coisa aqui que quero que você note.

O texto "main" acima da lista de arquivos.

Ele indica qual marcador você está visualizando dentro do armário.

Um marcador é uma branch.

Ele marca em qual coluna você está empilhando os registros.

Daqui para frente, não mexa nesse "main" diretamente.

No começo, eu também não dava muita atenção a isso.

Trabalhava direto na main e perdia tempo tentando descobrir como voltar atrás.

Quando a conexão falha, geralmente o problema é o endereço.

Falta o ".git" no final.

O nome da conta está escrito errado.

Se aparecer "not found", copie o endereço da Imagem ② de novo.

A essa altura, seus registros locais estão conectados ao GitHub. O próximo passo é o ciclo diário de merges via Pull Requests.

**

Capítulo 2: Fazendo Merge via Pull Request | Envie o Trabalho da IA, Confira o Diff e Aperte o Botão

A partir daqui começa o ciclo diário.

Um Pull Request é um envio dizendo "Por favor, faça o merge disso".

Neste capítulo, há três botões verdes para apertar.

A IA digita.

Seu trabalho é apenas olhar e apertar.

だん|AI×クラウドエンジニア - inline image

Primeiro, envie uma linha para a IA.

text
1Crie uma nova branch, adicione 3 linhas de uso ao README, faça o commit e envie para o GitHub

O README é o primeiro arquivo onde você escreve a descrição do repositório.

O Claude Code cria a branch.

Ele modifica o arquivo e faz o commit.

Por fim, ele para antes do push e pergunta.

Responda "Yes" e abra o armário no navegador.

だん|AI×クラウドエンジニア - inline image

Uma faixa amarela aparece no topo.

Ela avisa: "Acabei de guardar esta branch".

Aperte o botão verde "Compare & pull request" à direita.

Esse é o 'Envio'.

Como entregar um caderno de rascunho para o professor.

Só enviar não copia nada para a versão final.

A cópia acontece depois da revisão.

だん|AI×クラウドエンジニア - inline image

Há três lugares para olhar na tela de envio.

1º: A seta bem no topo.

"base: main" e "compare: work-branch"

Isso mostra de onde e para onde o merge será feito.

Apenas confirme se o lado esquerdo é a main.

2º: O título em "Add a title".

Se a IA gerar, ele inclui um resumo das mudanças.

Se você enviar manualmente, a mensagem de commit vem preenchida.

Se for enviar manualmente, escreva "o que foi feito" em uma linha.

3º: O botão verde "Create pull request".

Apertá-lo registra o envio.

Depois do envio, é necessária a ação humana.

Quatro abas aparecem no topo da tela.

Olhe apenas para a aba mais à direita, "Files changed".

Significa arquivos alterados.

だん|AI×クラウドエンジニア - inline image

Linhas verdes são adições.

Linhas vermelhas são exclusões.

Esse é o diff.

Se as 3 linhas que você pediu estiverem em verde, passou.

Na tela de exemplo, títulos e linhas em branco também foram adicionados, totalizando 6 linhas verdes.

Se houver linhas vermelhas que você não pediu, não faça o merge.

Na tela de exemplo, há 1 linha vermelha.

Uma linha de observação sumiu de "Itens colocados".

Se você não pediu isso, pare por aqui.

Pergunte à IA: "Por que você apagou esta linha vermelha?"

Esses são os 30 segundos mais críticos ao delegar trabalho para a IA.

Na época em que só ver notificação de revisão me dava um frio na barriga, eu costumava apertar o botão sem conferir isso.

Hoje, conto as linhas vermelhas primeiro.

Se existir sequer uma linha vermelha não solicitada, eu paro.

Se não houver problemas no diff, volte para "Conversation".

Quase no final, há um botão verde "Merge pull request".

Se "No conflicts with base branch" aparecer acima dele, você pode fazer o merge direto.

だん|AI×クラウドエンジニア - inline image

Ao apertar, muda para "Confirm merge".

Aperte de novo.

Agora, os registros da branch de trabalho foram mesclados na main.

だん|AI×クラウドエンジニア - inline image

A cor fica roxa e exibe "Merged".

Uma caixa aparece abaixo dizendo "Pull request successfully merged and closed".

À direita dela está "Delete branch".

Pode apertar sem medo.

Apenas o "marcador" da branch de trabalho dentro do armário desaparece.

Como os registros já foram mesclados na main, nada se perde.

Por fim, atualize seu ambiente local.

Envie para a IA: "Mude para a main e baixe a versão mais recente do GitHub".

Isso completa um ciclo.

Comece a próxima tarefa a partir de uma nova branch.

Não trabalhe na main.

A essa altura, você completou o ciclo de enviar, conferir o diff e fazer merge. A seguir, vamos falar sobre o Revert, o botão para desfazer erros após o merge.

**

Capítulo 3: Revertendo | Desfaça Erros Após o Merge com Um Clique

Às vezes você só percebe os erros depois do merge.

No Git, você "desfaz" os registros guardados sem apagá-los.

A tela do GitHub tem um botão para isso.

Chama-se "Revert".

Abra novamente o Pull Request que você acabou de mesclar.

Há uma linha que diz "merged commit … into main".

No extremo direito dessa linha está "Revert".

だん|AI×クラウドエンジニア - inline image

O que acontece quando você aperta?

Os registros não são apagados.

Um novo Pull Request é criado com as alterações inversas.

Segundo a documentação oficial, o merge acontece quando você mescla esse novo Pull Request.

Portanto, reverter segue o mesmo ciclo do Capítulo 2.

Confira o diff, aperte o botão verde.

Em vez de apagar, um registro de "revertido" é adicionado.

Se for pedir à IA, diga: "Desfaça o Pull Request que acabei de mesclar".

O Claude Code faz a mesma coisa com git revert.

Existe mais uma tela que você pode encontrar.

だん|AI×クラウドエンジニア - inline image

"This branch has conflicts that must be resolved".

Isso é um conflito.

Acontece quando a mesma linha foi modificada de formas diferentes na main e na branch de trabalho.

O botão verde fica cinza e não pode ser apertado.

Não tente resolver isso na tela; envie uma linha para a IA.

text
1Baixe a main e me mostre as duas versões das partes em conflito

Você decide qual manter.

Assim que a IA corrigir e enviar de novo, o botão verde volta.

Conflitos não são falhas.

Eles apenas revelam o fato de que a mesma linha foi editada duas vezes.

Por fim, uma coisa que não aparece na tela.

Chaves.

Arquivos contendo senhas ou chaves de API nunca devem ser enviados para o GitHub.

Mesmo que você use o Revert, uma vez que a chave foi enviada, ela é considerada comprometida e precisa ser gerada novamente.

Antes de enviar, diga à IA: "Exclua o .env dos registros".

No meu próprio trabalho, escrevo configurações da AWS em arquivos de texto e sigo exatamente este ciclo.

Configurações mescladas sem conferir o diff vão direto para produção.

Por isso, não delego à IA aqueles 30 segundos críticos antes de apertar o botão.

Humanos apertam todos os botões na tela.

Mesmo à medida que amplio o que a IA faz, essa regra continua inalterada.

Agora, o ciclo completo de conectar, enviar, fazer merge e reverter está concluído.

Para finalizar, deixo materiais prontos para uso.

Detalhei o passo a passo para completar um ciclo na tela do GitHub.

Empacotei as telas e os prompts deste artigo em formatos prontos para usar.

  • Pôster de Tradução das Telas do GitHub (9 telas, 69 termos)
  • Mapa de Recuperação para Quando a IA Quebra Algo (6 cenários)
  • 7 Prompts para Um Ciclo Completo
  • Checklist Pré-Merge (8 itens)

Tudo entregue junto em um livreto PDF de 15 páginas.

Só com isso, você já consegue começar a completar ciclos hoje.

Para receber, basta entrar no Open Chat abaixo.

Siga as instruções após entrar e envie "Submit" que o material chega automaticamente.

https://line.me/ti/g2/pEpZQdEyn1BM5Zi2wqLBT2rZYpC0ZaOncIWTag

だん|AI×クラウドエンジニア - inline image

Resumo: Complete Apenas Um Ciclo Hoje

Não jogue o trabalho da IA direto na main.

Envie a partir de uma branch de trabalho, confira o diff e aperte os botões verdes.

Foram três botões verdes para apertar em um ciclo.

No dia em que apertei o Revert pela primeira vez, percebi que os registros não são apagados.

Depois disso, parei de ter medo de mexer nas coisas.

Você não precisa fazer tudo de uma vez.

Hoje, há apenas uma coisa a fazer.

Abra o repositório criado no Capítulo 1 e envie uma linha para a IA.

Crie uma nova branch, adicione 1 linha ao README e envie para o GitHub

Quando a faixa amarela aparecer, aperte o botão verde e abra "Files changed".

Se houver apenas uma linha verde, passou.

Olhe para essa linha com seus próprios olhos antes de fazer o merge.

Esse é o primeiro passo para ampliar o que você pode delegar à IA.

Para engenheiros com mais de 30 anos, vencer não é questão de volume de trabalho, mas de design.

Em vez de reaprender ferramentas toda vez que elas atualizam, é mais rápido definir onde parar.

AWS e IA evoluem rapidamente.

Acompanhar os logs de pessoas testando em trabalhos reais é mais rápido do que tentar acompanhar tudo sozinho.

Na minha prática de IA × Engenharia, deixo registrados não apenas os acertos, mas também as quebras e exclusões.

Me siga para não perder os próximos insights! @dan_pro_man

Salvar com um clique

Faça leitura profunda de artigos virais com IA no YouMind

Salve a fonte, faça perguntas específicas, resuma o argumento e transforme um artigo viral em notas reutilizáveis em um único espaço de trabalho com IA.

Explorar o YouMind
Para criadores

Transforme seu Markdown em um artigo 𝕏 impecável

Quando você publica seus próprios textos longos, formatar imagens, tabelas e blocos de código para o 𝕏 é uma dor de cabeça. O YouMind transforma um rascunho completo em Markdown em um artigo 𝕏 impecável e pronto para publicar.

Experimente Markdown para 𝕏

Mais padrões para decifrar

Artigos virais recentes

Explorar mais artigos virais