🛟Salve tudo no GitHub antes que a IA quebre seu projeto · seu botão de desfazer infinito

Quando surge a necessidade? (o momento exato)

A necessidade aparece justamente quando você começa a construir um app de verdade com IA — não quando só conversa com ela. Nesse ponto a IA mexe em muitos arquivos ao mesmo tempo, e um dia você pede uma mudancinha e, sem querer, ela quebra três coisas que funcionavam. É aí que você descobre se tinha uma rede… ou não.

E existe um segundo freio, mais sutil: o medo de experimentar. Sem rede, você pede mudanças tímidas para não quebrar nada — e mudanças tímidas não constroem nada grande. Com o GitHub salvo, você se atreve: se der errado, você volta atrás e pronto.

O que é Git e o que é GitHub? (uma frase para cada)

Git é o sistema que salva fotos do seu projeto ao longo do tempo (cada foto se chama commit). GitHub é a nuvem onde você sobe essas fotos para mantê-las a salvo e poder voltar a qualquer uma. O Git vive no seu computador; o GitHub vive na internet. Juntos = backup + máquina do tempo.

Onde vive o seu projeto? Pasta local vs sandbox

Isso é fundamental para entender por que o GitHub sempre vale a pena para você, não importa com o que você construa. As ferramentas de IA salvam seu projeto de duas formas, e em ambas o GitHub ganha:

Pasta local — ferramentas como Claude Code trabalham sobre uma pasta no seu próprio computador. Para vê-la rodando, você abre o localhost no navegador. O projeto é seu e está no seu disco… mas se você apagar por acidente ou um comando o danificar, sem backup na nuvem não há volta.

Sandbox próprio — outras ferramentas (como NeuralOS, v0, Bolt e similares) rodam o seu app dentro do próprio ambiente delas, e você o vê publicado ali mesmo, sem lidar com pastas. Comodíssimo. Mas o seu código vive na conta daquela plataforma — se você quer uma cópia que seja realmente sua e que sobreviva a qualquer coisa, você a coloca no GitHub.

O caminho sem terminal · GitHub Desktop (recomendado para começar)

Se a palavra "terminal" te dá preguiça, este é o seu caminho. O GitHub Desktop é o app oficial e gratuito do GitHub: faz tudo com botões. Você vê a lista das suas mudanças, escreve uma nota e salva — sem um único comando. O próprio lema dele diz: "concentre-se no que importa em vez de brigar com o Git".

A partir daí, sempre que o app te mostrar mudanças, você escreve uma nota curta embaixo à esquerda (o Summary), clica em Commit to main, e depois em Push origin. Isso é um ponto de save subido à nuvem. Faça isso toda vez que algo funcionar bem.

O caminho com comandos · 4 que valem ouro

Se você prefere o terminal (ou a sua IA o usa por você), com estes quatro comandos você tem 90% do que precisa. A sua IA os conhece de cor — você pode pedir que ela os execute e te explique cada um.

git init
git add .
git commit -m "primeiro ponto de save: o projeto funciona"

git status

git add .
git commit -m "descreva em poucas palavras o que você conseguiu"

git push

O momento-chave · voltar atrás quando a IA quebrou algo

Aqui está o superpoder. Imagine que o seu app funcionava, você pediu uma mudança, e agora ele está quebrado. Se você salvou um ponto quando funcionava, recuperá-lo é trivial. No GitHub Desktop: menu History, clique direito sobre o ponto bom → Revert changes. Por comando, você tem duas formas dependendo do que quiser:

git revert HEAD

Esse git revert é o mais seguro: não apaga o histórico, só cria um ponto novo que desfaz o último. Se você quer apenas recuperar um arquivo tal como estava num ponto anterior, peça à sua IA: "me devolva o arquivo X tal como estava no último commit que funcionava" e ela usará git checkout. A regra de ouro:

Branches · teste loucuras sem medo (opcional, mas mágico)

Uma branch é uma cópia paralela do seu projeto onde você pode experimentar sem tocar na versão que funciona. Quer que a IA tente algo arriscado? Você cria uma branch, ela testa ali, e se der certo você junta (merge); se der errado, você a apaga e não aconteceu nada. A sua versão principal nunca correu perigo.

git checkout -b prueba-arriesgada

O mais importante · os 5 momentos em que você SEMPRE salva

Aqui está o verdadeiro segredo, e é o que quase ninguém faz: o GitHub não se monta uma vez e acabou. O valor dele está no hábito. Se você não alimenta o GitHub de forma constante, no dia em que precisar não haverá nada para onde voltar. Estes são os cinco momentos em que salvar não se negocia — os mesmos que nós, que construímos pra valer, usamos:

Salve limpo · não encha o GitHub de lixo

Um bom histórico é aquele onde cada ponto significa algo. Duas regras simples para que o seu GitHub seja útil e não uma lixeira:

Erros típicos de iniciante (e como evitá-los)

O caminho mais fácil · deixe o seu agente fazer pelo chat

Se você está usando um agente de código (como Claude Code), quase tudo se faz pelo chat — você não precisa aprender comandos. Isto é o que o seu agente PODE fazer sozinho por mensagem, e o pouco que cabe a você:

Prompt pronto · passe para a sua IA e deixe tudo configurado

Este é o prompt completo, de ponta a ponta. Copie, substitua o que está entre colchetes, e cole no seu agente de código. Ele deixa o GitHub montado, conectado e com o hábito de te lembrar de salvar.

Quero proteger meu projeto com GitHub mesmo sem saber de git. Me guie passo a passo e faça você onde puder. Meu projeto se chama [NOME]; eu o construo com [Claude Code / NeuralOS / outra ferramenta].

1) CONTA: se eu não tiver conta no GitHub, me diga exatamente como criá-la em github.com (grátis) em passos curtos.

2) REPOSITÓRIO: me diga como criar um repositório NOVO e PRIVADO. Sugira um nome em minúsculas com hífens a partir do nome do meu projeto. Se você puder criá-lo com a minha permissão, faça; se não, me diga os cliques exatos e eu te passo o nome ou a URL.

3) LIMPEZA: crie um .gitignore que ignore .env, node_modules, arquivos temporários e qualquer segredo, para não subir lixo nem senhas.

4) PRIMEIRO PONTO: inicialize o git, faça o primeiro commit com uma mensagem clara e conecte e suba para o meu repositório privado.

5) HÁBITO: de agora em diante, toda vez que a gente conseguir algo que funcione, ANTES de uma mudança grande, e depois de revisar/corrigir bugs, me lembre de salvar um ponto e me pergunte se subimos para a nuvem. Use mensagens de commit claras que o meu eu do futuro entenda.

6) RESGATE: se algo quebrar, me ajude a voltar ao último ponto que funcionava sem perder meu trabalho, e me explique em uma frase o que aconteceu.

Deixe simples. Se algo só eu posso fazer pela web, me diga com os cliques exatos.

A ferramenta oficial (grátis e verificada)