MÓDULO 2.2 / 4 DE 8
Pastas, Markdown e segredos
Montar a casa digital e separar conhecimento de credenciais.
1Uma pasta representa um contexto
O que é
O símbolo ~ representa a pasta pessoal no Bash. Dentro dela, projetos reúne trabalhos independentes. Use nomes claros e evite misturar documentos de clientes diferentes. A pasta config guarda conhecimento transversal; cada projeto mantém suas próprias entradas e resultados.
Por que aprender
Contextos separados ajudam a limitar o que a IA precisa ler. Uma pasta cheia de assuntos não relacionados aumenta ruído e torna difícil explicar de onde veio uma conclusão.
Conceitos-chave
Pasta pessoal; projetos; contexto; entradas e saídas.
Na prática
Em ~/projetos/website ficam os arquivos do site. Em ~/projetos/estudos ficam experimentos. No Windows, o gerenciador pode mostrar caminhos como C:\Users\SeuNome\projetos.
✓ Faça
Desenhe a árvore antes de criar arquivos. Escolha um único projeto de treino e uma única pasta global config.
✗ Evite
Aceitar uma conclusão sem conferir a entrada que a sustenta.
2Markdown é texto organizado
O que é
Markdown usa sinais simples para organizar texto: # cria título, ## cria subtítulo e um hífen inicia item de lista. O arquivo continua sendo texto, legível mesmo sem um editor especial. O nome termina em .md. Você não precisa escrever código para registrar instruções claras.
Por que aprender
Arquivos pequenos, nomeados e fáceis de editar duram mais que uma conversa perdida. Eles podem ser revisados por pessoas e consultados por agentes. O valor vem da clareza, não de uma formatação elaborada.
Conceitos-chave
Título; lista; bloco de código; link; texto simples.
Na prática
Um README pode conter: propósito, arquivos de entrada, resultado esperado e como verificar. Quem chegar depois entende a tarefa sem depender da conversa original.
3Cada arquivo tem um trabalho
O que é
memoria.md registra preferências estáveis; decisoes.md explica escolhas; dicas.md guarda procedimentos úteis; falhas.md documenta problemas e correções. Não coloque tudo em um documento gigante. Quando uma decisão muda, registre data e motivo para não manter regras contraditórias.
Por que aprender
Separar funções facilita consultar só o necessário. Um histórico de falhas não deveria virar uma lista de comandos obrigatórios em toda tarefa. Conhecimento consultável e instruções permanentes são coisas diferentes.
Conceitos-chave
Memória seletiva; decisões datadas; procedimento; histórico.
Na prática
“Prefiro relatórios curtos” é preferência. “Escolhemos CSV por ser compatível com a planilha da equipe” é decisão. “O serviço parou sem supervisão” pertence às falhas.
Sequência para experimentar
- Prepare uma cópia de treino.
- Distribua cinco notas fictícias entre os quatro arquivos. Para cada uma, explique por que aquele é o lugar adequado.
- Registre o resultado observado e a próxima correção.
4Segredos não são conhecimento compartilhável
O que é
Um arquivo .env pode guardar variáveis como TELEGRAM_BOT_TOKEN ou DATABASE_URL. Ele não é criptografado: qualquer pessoa com acesso ao arquivo pode lê-lo. Use permissões adequadas e nunca inclua valores reais em screenshots, exemplos de curso ou arquivos enviados à IA sem necessidade.
Por que aprender
Credenciais permitem agir em nome de uma conta. Separar o modelo .env.example, sem valores reais, do .env local permite compartilhar a estrutura sem distribuir acesso.
Conceitos-chave
Variável; segredo; .env.example; leitura em tempo de execução.
Na prática
O kit inclui TELEGRAM_BOT_TOKEN=preencha_localmente. O aluno substitui isso apenas em sua cópia privada. Nenhum bot fica autenticado com esse exemplo.
✓ Faça
Crie .env.example com nomes das variáveis e valores fictícios. Mantenha .env fora do repositório e nunca cole sua chave no chat.
✗ Evite
Misturar a cópia de treino com arquivos privados ou trabalho em produção.
5Ignore antes do primeiro commit
O que é
O .gitignore lista arquivos que Git deve ignorar quando ainda não são rastreados. Inclua .env, variantes privadas e pastas temporárias. Mantenha uma exceção explícita para .env.example. Antes de salvar uma versão, examine git status e os arquivos preparados.
Por que aprender
Ignorar depois não apaga um segredo do histórico. Se a chave vazou, a primeira correção é revogar ou rotacionar na origem; apagar a linha do arquivo não invalida uma cópia já vista.
Conceitos-chave
Arquivos rastreados; padrões de exclusão; revisão de alterações; revogação.
Na prática
Padrões úteis: .env, .env.*, !.env.example, __pycache__/. Para descobrir qual regra se aplica, use git check-ignore -v .env.
6Faça uma limpeza de contexto
O que é
A IA não lê automaticamente todo arquivo Markdown existente no computador. Diga quais documentos consultar e mantenha referências no AGENTS.md quando forem necessárias. Antes de uma tarefa, remova dados irrelevantes da cópia de trabalho e atualize decisões vencidas.
Por que aprender
Memória útil precisa ser encontrada e estar correta. Um arquivo antigo pode atrapalhar mais que não ter memória se trouxer endereço de serviço ou processo que já mudou.
Conceitos-chave
Seleção de contexto; data; fonte de verdade; revisão periódica.
Na prática
Ao iniciar um relatório, peça leitura de README.md e da decisão sobre formato. Não carregue listas de contatos ou credenciais porque estão na mesma pasta.
Critérios para revisar sua entrega
Use esta rubrica depois do laboratório. Cada linha pede uma evidência; marcar leitura não significa que a prática foi executada.
| Critério | Evidência esperada | Se não passou |
|---|---|---|
| Escopo | A entrega corresponde ao objetivo desta aula. | Reduza a tarefa e nomeie um único resultado. |
| Entradas | Você sabe quais arquivos ou dados foram usados. | Liste as fontes e remova material sem relação. |
| Execução | O procedimento foi realizado no ambiente de treino. | Diferencie o que foi planejado do que foi feito. |
| Conferência | Um resultado foi comparado com uma referência. | Abra o arquivo ou repita a consulta verificável. |
| Segredos | Nenhum token, senha ou dado privado foi compartilhado. | Revise a cópia de trabalho antes de qualquer envio. |
| Continuidade | Outra pessoa consegue encontrar o próximo passo. | Atualize README e registre uma pendência concreta. |
MÃO NA MASSA / ~15 MIN OU EM ETAPAS
Organize seu segundo cérebro operacional
Use arquivos fictícios e uma pasta de treino. As práticas com instalação, Telegram ou VPS podem exigir tempo adicional para cadastro e configuração.
Estrutura de trabalho
Leia o bloco antes de usar. Campos como Seu Nome e usuario@ip-da-vps são exemplos para adaptar; comandos administrativos pertencem somente ao seu ambiente de treino.
~/projetos/
├── config/
│ ├── memoria.md
│ ├── falhas.md
│ ├── dicas.md
│ └── decisoes.md
└── meu-primeiro-projeto/
├── AGENTS.md
├── README.md
├── .gitignore
├── entradas/
└── saidas/
Critério de pronto
Montar a casa digital e separar conhecimento de credenciais. Registre o arquivo produzido, o teste executado e o resultado observado.
Abrir arquivos e modelos do laboratórioConfira o que ficou
Adicionar .env ao .gitignore remove automaticamente uma chave já publicada?
Ver resposta comentada
Não. Revogue a chave exposta e corrija o histórico conforme o caso; ignorar só previne novos arquivos não rastreados.
Se sua resposta foi diferente, volte ao tópico correspondente e escreva a diferença em uma frase. A checagem não bloqueia seu estudo.
Resumo do módulo
- Pasta pessoal; projetos; contexto; entradas e saídas.
- Título; lista; bloco de código; link; texto simples.
- Memória seletiva; decisões datadas; procedimento; histórico.
- Variável; segredo; .env.example; leitura em tempo de execução.
- Arquivos rastreados; padrões de exclusão; revisão de alterações; revogação.
- Seleção de contexto; data; fonte de verdade; revisão periódica.
Consulte a fonte
Ferramentas verificadas em 20/09/2026; nomes de telas e disponibilidade podem mudar.