📁 Pastas e arquivos: a casa do projeto
Toda solução de IA mora em algum lugar: um conjunto de pastas e arquivos dentro de um computador. Parece banal, mas é a base física de tudo. Um projeto bem organizado é como uma casa arrumada — você acha o que precisa em segundos. Um projeto bagunçado é uma gaveta de quinquilharias: tudo está lá, mas ninguém encontra nada. Você não precisa de talento para isso, só de uma convenção simples e o hábito de respeitá-la.
🏠 A regra de ouro da organização
Uma pasta por projeto. Dentro dela, pastas por assunto (entrada, saída, anotações). Nomes em minúsculas, sem espaços nem acentos, separando palavras com hífen. Essa convenção sozinha resolve 90% da bagunça — e funciona igual no seu computador, no servidor e no GitHub.
Uma estrutura simples e clara
Exemplo ilustrativo de estrutura de pastas — adapte os nomes ao seu projeto. O importante é o padrão, não estes nomes exatos.
✓ Nomes que ajudam
- ✓
relatorio-vendas— minúsculas, hífen - ✓
2026-06-orcamento— data na frente ordena sozinho - ✓Uma pasta = um propósito claro
✗ Nomes que atrapalham
- ✗
Relatório Final (2).docx— espaços e acento - ✗
novo,teste,aaa— não dizem nada - ✗Tudo solto na Área de Trabalho
⌨️ O terminal: perder o medo
O terminal é aquela telinha preta de filme de hacker. Assusta porque parece exigir decorar mil comandos — mas a verdade é mais simples: o terminal é só uma conversa com o computador por texto, em vez de clicar com o mouse. Você digita uma ordem, aperta Enter, ele responde. O objetivo aqui não é virar especialista em linha de comando: é perder o medo, entender que é uma ferramenta amistosa e saber pedir as poucas coisas que importam.
Recriação ilustrativa de um terminal, não uma captura de tela real. Os comandos servem só para mostrar o ritmo "digito → Enter → resposta".
💡 Dica prática: três comandos bastam para começar
Você não precisa decorar nada. Para se virar no começo, três ordens resolvem quase tudo: cd (entrar numa pasta), ls (ver o que tem) e pwd (saber onde você está). Com isso você já navega. O resto você pede para a IA escrever — e aí entender o que ela escreveu fica fácil.
| Você digita | O que acontece |
|---|---|
| cd pasta | Entra numa pasta (como dar dois cliques nela) |
| cd .. | Volta uma pasta para trás |
| ls | Lista os arquivos e pastas onde você está |
| pwd | Mostra o caminho completo de onde você está |
Tabela ilustrativa dos comandos mais usados no dia a dia. Em Windows alguns nomes mudam, mas a ideia é idêntica.
🌿 Git e GitHub: versionar é guardar versões
Imagine um videogame onde você pode salvar o jogo a qualquer momento e voltar para qualquer save quando errar. É exatamente isso que o Git faz com o seu projeto: cada vez que você "salva", ele guarda uma foto completa de tudo — isso se chama commit. O GitHub é o lugar na internet onde essas fotos ficam guardadas, longe do seu computador. Git é a ferramenta que tira a foto; GitHub é o álbum na nuvem. Versionar não é coisa de programador avançado — é só o hábito de salvar com história.
O caminho de um trabalho até a nuvem
Você trabalha
Edita arquivos na pasta do projeto, como sempre fez.
Faz um commit
Tira uma "foto" do estado atual e escreve uma frase do que mudou: "adicionei a pasta de anotações".
Faz um push
Envia as fotos para o GitHub. Agora seu trabalho está seguro na nuvem, com todo o histórico.
O ciclo, em três linhas
Comandos ilustrativos — você vai colá-los uma vez e repetir sempre. Não precisa decorar: precisa entender que cada linha é um passo do "salvar com história".
📜 Histórico e colaboração: a memória do projeto
Versionar não serve só para você não perder o trabalho. Quando o histórico está no GitHub, ele vira a memória do projeto: dá para ver quem mudou o quê, quando e por quê. E isso destrava algo essencial — várias pessoas (ou várias IAs) trabalhando no mesmo projeto sem se atropelar. Soluções reais quase nunca são feitas sozinhas. O histórico é o que permite voltar atrás com segurança e o que permite confiar quando outra pessoa mexe.
✓ Com histórico (GitHub)
- ✓"Quebrou? Volto para a versão de ontem em 1 minuto."
- ✓Dá para ver quem mudou cada linha e por quê.
- ✓Duas pessoas mexem no mesmo projeto sem sobrescrever uma à outra.
- ✓O projeto tem memória — nada se perde no "salvar por cima".
✗ Sem histórico (arquivos soltos)
- ✗
projeto_final_v3_AGORA_VAI.zip - ✗Ninguém sabe qual é a versão certa.
- ✗Um salva por cima do outro e o trabalho some.
- ✗"Funcionava semana passada" — e não dá para voltar.
Como o histórico aparece
Recriação ilustrativa de um histórico no GitHub. Cada ponto é um commit — uma foto com legenda, autor e data.
🗺️ Entender o mapa, não dominar tudo
Aqui está a libertação deste módulo: você não precisa dominar a infraestrutura como um engenheiro sênior. Precisa entender o mapa. Um motorista de táxi não construiu as ruas nem sabe a engenharia do asfalto — mas conhece a cidade e chega onde precisa. É essa a sua meta com pastas, terminal e Git: saber o suficiente para decidir, pedir a coisa certa e não depender de ninguém para atravessar o caminho.
🧭 Mapa × domínio: a diferença que liberta
- Dominar seria saber cada comando, cada detalhe, cada caso raro — anos de estudo, e não é o seu trabalho.
- Entender o mapa é saber o que existe, para que serve e quando usar — semanas de familiaridade, e é exatamente o que o arquiteto precisa.
- A IA preenche o resto: ela escreve o comando difícil; você entende o que ela escreveu e decide se está certo.
💡 Dica prática: a pergunta certa para a IA
Quando travar na infraestrutura, não pergunte "como faço tudo isso?". Pergunte: "me explica em uma frase o que esse comando faz e qual o risco de rodar ele". Você continua no comando da decisão — a IA vira o seu copiloto técnico, não o seu chefe.
🧰 O ambiente do arquiteto: montar uma vez
Por fim, o arquiteto monta um ambiente de trabalho — o conjunto mínimo de ferramentas onde ele constrói. Não é muita coisa: um editor para escrever, o terminal aberto ao lado, uma conta no GitHub e o hábito de organizar. Você monta esse ambiente uma única vez e ele economiza horas em todos os projetos seguintes. É como arrumar a bancada antes de começar a trabalhar: cinco minutos no início poupam o dia inteiro de procurar ferramenta.
Um editor
Onde você escreve e lê os arquivos do projeto.
O terminal
Aberto ao lado, para dar as ordens rápidas.
Conta no GitHub
O álbum na nuvem que guarda tudo.
Hábito de organizar
A convenção de pastas e nomes, sempre.
✅ Checklist do ambiente montado
cd e ls.Auto-checagem (opcional): qual é a meta deste módulo em relação à infraestrutura?
📁 Resumo do módulo
Próximo módulo:
1.4 — Publicar no Mundo: tirar a solução do seu computador e colocá-la no ar para o mundo usar.