MÓDULO 7.5

💾 Backup e versionamento: protegendo a casa do seu assistente

Nas fases anteriores você construiu uma casa, deu vida, mãos e crescimento ao seu assistente. Agora protege tudo isso: meses de contexto, decisões e preferências não podem sumir por um clique errado, um HD que morre ou um arquivo apagado sem querer. Este módulo é o seguro do funcionário que você acabou de treinar.

6
Tópicos
30
Minutos
Intermediário
Nível
Prático
Tipo
0 de 60%
1

🏚️ Por que isso importa especificamente aqui

A pasta do seu assistente não é uma pasta comum. É a casa dele — o lugar onde moram o CLAUDE.md (o cérebro com as instruções permanentes, visto no módulo 0.4), as anotações de contexto que ele foi acumulando, as preferências que você ajustou fase a fase (Casa, Vida, Mãos, Crescimento) e as decisões que ficaram registradas ao longo de meses. Perder essa pasta não é perder "uns arquivos": é perder um funcionário inteiro que você treinou com tempo e atenção.

Pense no oposto de contratar alguém e, três meses depois, esse alguém sofrer uma pancada na cabeça e esquecer tudo que aprendeu sobre sua rotina, seus gostos e as regras da casa. Com um funcionário humano isso é raro. Com uma pasta de arquivos num laptop comum, é o tipo de coisa que acontece com muito mais frequência do que parece — HD que corrompe, sincronização de nuvem que sobrescreve, exclusão sem querer numa limpeza de disco.

💡 Conceito Principal

A pasta do assistente é um ativo, não um detalhe técnico. Ela carrega tempo investido que não se recria em uma tarde.

  • Quanto mais meses de uso, mais caro fica perder — o custo de reconstrução cresce junto com o valor acumulado.
  • Proteger essa pasta é parte do trabalho de "ser dono" do assistente, não um extra opcional para depois.
CLAUDE.md
Instruções fixas
Contexto
Meses acumulados
Decisões
Registro do que mudou
Preferências
Ajustes finos
2

📜 Versionamento, em linguagem de leigo

Novo aqui? Você já usou versionamento sem saber o nome: no Google Docs, cada alteração fica guardada num "histórico de versões" — você consegue abrir o documento como ele estava ontem, ou há um mês, e voltar se algo deu errado. Versionamento é exatamente isso, só que para uma pasta inteira de arquivos: um sistema que guarda cada mudança, com data e um resumo do que mudou, para você poder voltar atrás quando precisar.

A ferramenta mais usada para isso se chama git — um controle de versão (o nome técnico da categoria). Não precisa entender a engenharia por trás: o que importa é o conceito — cada vez que você "salva um marco" (isso se chama commit, uma foto daquele momento da pasta), o git guarda essa foto para sempre. Se um arquivo de contexto ficar bagunçado, você olha as fotos anteriores e recupera a versão boa.

seg — commit inicial qua — ajuste preferências sex — ponto de recuperação seg — nova decisão hoje

Legenda: cada bolinha verde é um commit — uma foto salva da pasta naquele dia. Se algo quebrar depois de "hoje", você volta para o ponto de recuperação em destaque sem perder tudo que veio antes.

🔍 Por dentro

  • Commit: uma "foto" salva da pasta, com uma frase curta dizendo o que mudou.
  • Histórico: a fileira de todas as fotos, em ordem — dá para ver "o que mudou e quando" em qualquer arquivo.
  • Voltar atrás: pedir para restaurar uma foto anterior, sem perder o resto do histórico.
3

🧱 Duas camadas de proteção, não uma

Novo aqui? Backup é simplesmente uma cópia de segurança — uma segunda cópia da pasta inteira guardada em outro lugar, local (um HD externo, por exemplo) ou em nuvem (um serviço de armazenamento na internet, tipo Google Drive ou Dropbox). Ele resolve "sumiu tudo": se o computador quebra ou o arquivo original é apagado, você tem de onde recuperar.

O versionamento com git é outra coisa, e as duas se complementam. Backup te devolve a pasta inteira num desastre total; git te dá o histórico linha a linha — o "o que mudou e quando" dentro dos arquivos de contexto e decisões, mesmo que nada tenha "sumido". Ter só backup e nunca versionamento é como ter seguro de incêndio mas nenhum jeito de saber o que você mudou ontem. Ter só git sem nunca fazer backup fora da máquina é confiar que o disco nunca vai morrer — ele morre, mais cedo ou mais tarde.

Pasta do assistente CLAUDE.md, contexto, decisões Camada 1 — Backup cópia da pasta inteira, local ou em nuvem Camada 2 — Histórico de versões (git) o que mudou e quando, arquivo por arquivo

Legenda: a pasta na base é o ativo; o backup (meio) protege contra "sumiu tudo"; o histórico de versões (topo) protege contra "mudou e eu não sei o quê" — as duas camadas juntas cobrem os dois riscos.

✓ As duas camadas juntas

  • HD morre → você restaura do backup
  • Arquivo de contexto ficou confuso → você olha o histórico e volta a versão boa
  • Quer saber "o que mudou na semana passada" → o histórico responde

✗ Só uma camada

  • Só backup: sem visibilidade fina do que mudou entre uma cópia e outra
  • Só git: um HD que morre sem backup externo perde o histórico junto
  • Nenhuma das duas: um único ponto de falha decide o destino de meses de trabalho
4

🔧 Passo a passo: configurando as duas camadas

Você não precisa saber terminal de cor para fazer isso — o próprio Claude Code configura as duas camadas por você, se você pedir com clareza. O passo a passo abaixo assume zero conhecimento prévio.

1

Abra o terminal na pasta do assistente

O terminal é a caixa de texto que dá ordens direto ao computador (vista no módulo 0.2) — nada muda aqui em relação ao que você já faz todo dia.

2

Peça ao Claude Code para configurar o histórico de versões (git)

Use o bloco copy-run abaixo. Ele transforma a pasta num repositório versionado sem você tocar em nenhum comando na mão.

3

Configure o backup em segundo local

Local (HD externo, pendrive) ou em nuvem (pasta sincronizada de um serviço de armazenamento). O importante é ficar fora do mesmo disco onde a pasta original vive.

4

Confirme que os dois estão funcionando

Veja o "como verificar" do bloco copy-run — não basta configurar uma vez, é preciso confirmar que o commit e a cópia realmente aconteceram.

COPY-RUN · prompt para o Claude Code Cole e rode
Configure backup e versionamento para a pasta deste assistente.

Objetivo: proteger tudo que está aqui (CLAUDE.md, contexto,
decisões) contra perda, com duas camadas.

1. Inicialize um repositório git nesta pasta, se ainda não
   existir, e faça um primeiro commit com tudo que já está aqui.
2. Crie um arquivo .gitignore básico (excluindo segredos, chaves
   de API e arquivos temporários — nunca versionar credenciais).
3. Sugira um comando simples que eu possa rodar toda semana para
   salvar um novo commit ("checkpoint semanal").
4. Explique, em português simples, como eu faço uma cópia de
   segurança desta pasta inteira em <meu HD externo ou serviço
   de nuvem> (troque pelo que eu realmente uso).
5. Ao final, me diga como eu confirmo que o histórico de versões
   está funcionando (que comando roda para ver o histórico).

Como verificar

Peça para o agente listar o histórico de commits — se aparecer pelo menos um item com data e uma frase descrevendo a mudança, o versionamento está ativo. Para o backup, abra o segundo local (HD ou pasta de nuvem) e confira se os arquivos mais recentes estão lá com a data de hoje.

5

📅 Rotina: quando fazer o quê ao longo do mês

Backup e versionamento só funcionam se viram rotina — configurar uma vez e nunca mais tocar é quase tão ruim quanto não ter nada. A frequência abaixo é a recomendação da INEMA para a pasta de um assistente em uso ativo.

Diário

Commit rápido no fim do dia de uso

Se você mexeu no CLAUDE.md ou em algum arquivo de contexto hoje, um commit curto ("ajustei preferência de horário") já cria um ponto de recuperação. Leva menos de um minuto pedindo ao agente.

Semanal

Checkpoint semanal + revisão do histórico

Uma vez por semana, dê uma olhada nos commits da semana — confirma que o histórico está fazendo sentido e pega qualquer commit esquecido.

Mensal

Backup completo verificado

Uma vez por mês, confirme que a cópia de segurança está atualizada e — o passo que quase todo mundo pula — teste de verdade se consegue abrir um arquivo a partir dela.

💡 Dica Prática

Peça ao próprio assistente para lembrar você: "toda sexta, me pergunte se já fiz o checkpoint semanal". Isso conecta com o módulo 6.2 (tarefas agendadas) — a rotina de proteção pode virar automática em vez de depender da sua memória.

6

⚠️ Erros que custam caro

A maioria dos desastres de dados não vem de falta de ferramenta — vem de um hábito mal formado. Os dois pares abaixo cobrem os erros mais comuns que a INEMA vê nesta fase do curso.

✓ Rotina simples de backup

  • Cópia mensal fora do disco original, testada de verdade
  • Alerta ou lembrete configurado — não depende da sua memória

✗ Nunca ter backup

  • "Meu computador nunca deu problema" — até o dia em que dá
  • Só um lugar guardando meses de contexto e decisões

✓ Ter os dois: salvar + histórico

  • "Salvei o arquivo" garante que a edição de agora não some
  • "Tenho histórico" garante que você recupera a versão de ontem se a de hoje der problema

✗ Confundir "salvei" com "tenho histórico"

  • Achar que Ctrl+S resolve tudo — ele só garante o presente, não o passado
  • Descobrir que precisava do "de antes" só depois de já ter sobrescrito

⚠️ Atenção

Nunca versione (nem faça backup de) chaves de API, senhas ou credenciais dentro do repositório git em texto puro — se esse histórico algum dia for compartilhado ou vazar, essas credenciais ficam expostas para sempre no histórico. Mantenha-as em arquivos separados excluídos pelo `.gitignore`, como o próprio prompt do tópico 4 já pede.

🎯 Conceito Principal

  • Com a casa protegida, o próximo passo é fechar o capstone — o módulo 7.6 reúne tudo em uma entrega final.
  • Backup + versionamento não é tarefa única: é hábito que se mantém enquanto o assistente estiver em uso.

Checagem rápida (opcional): qual é a diferença central entre backup e versionamento com git?

Resumo do Módulo

Por que importa: a pasta do assistente carrega meses de trabalho — perder é perder um funcionário treinado.
Versionamento: histórico de mudanças tipo Google Docs, mas para pastas — git guarda "fotos" chamadas commits.
Duas camadas: backup (cópia da pasta inteira) + git (histórico linha a linha) — as duas juntas, não uma no lugar da outra.
Rotina: commit diário, checkpoint semanal, backup mensal testado.

Próximo módulo:

7.6 — Capstone: entrega final