Aula 2 · 12 min
O terminal é só outra janela. Com seis comandos você anda pelas suas pastas; com um AGENTS.md o agente sabe quem você é e o que pode fazer; com o Git você desfaz qualquer erro.
Começar a aula
Objetivo: montar a pasta de trabalho do agente com regras, rede de segurança e segredos fora do texto.
Você dá a tarefa, o agente trabalha dentro da pasta e você confere.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
Você continua sendo quem decide: pede, confere o resultado e aceita ou desfaz. Dar a tarefa, conferir e decidir é gestão.
É por onde você chega à pasta e chama o agente. No Windows, o cmd; no Mac e no Linux, o Terminal.
Tudo o que o agente precisa saber fica aqui: as regras no AGENTS.md, o trabalho nos arquivos, as chaves no .env (que o Git ignora) e o histórico no .git.
O agente lê o AGENTS.md antes de começar, trabalha nos arquivos da pasta e, se a regra pedir, diz o que mudou e como você confere.
Você pede, o agente trabalha dentro da pasta seguindo o AGENTS.md e diz o que mudou. Você confere. Gostou, commit; não gostou, git restore.
Os mesmos arquivos servem para o Claude Code e para o Codex: os dois leem o AGENTS.md.
Clique em cada etapa.
Dentro da pasta, chame claude ou codex e peça uma coisa só, com o resultado que você espera.
Comece pedindo para ler o AGENTS.md: assim ele usa as suas regras.
Leia o AGENTS.md. Crie um index.html com uma página simples sobre mim, usando o que está lá.
O agente cria e edita arquivos na pasta. Ele pode pedir permissão antes de rodar comandos.
Seu papel aqui é ler o que ele propõe, não digitar por ele.
O agente cria o index.html e explica o que fez.
Abra o resultado (a página no navegador, o resumo, o arquivo) e compare com o que você pediu.
Peça pelo menos uma correção: é o hábito que separa usar de gerenciar.
Troque o título por "Consultoria de RH" e acrescente uma seção de contato.
Gostou? git add . e git commit -m "..." guardam a versão.
Não gostou? git restore index.html volta ao que estava salvo, sem pânico.
Faça um commit antes de pedir uma mudança grande.
Copie e use. Troque o texto entre os sinais < > pelo seu.
mkdir projetos cd projetos mkdir meu-primeiro-agente cd meu-primeiro-agente dir # Windows (no Mac e no Linux: ls)
# Quem sou <seu nome, sua profissão, para quem você trabalha> # Regras deste projeto - Escreva em português, frases curtas. - Não apague arquivos sem perguntar. - Antes de terminar, diga o que mudou e como eu confiro. - Nunca escreva chaves ou senhas em arquivo de texto; elas ficam no .env. # O que tem aqui - index.html: minha página
git init echo .env> .gitignore git add . git commit -m "primeira versão" # desfazer uma mudança do agente: git restore index.html # o .env NÃO pode aparecer aqui: git status
git status não mostra o .env.Faça na ordem. Só passe para o próximo quando o "pronto quando" for verdade.
Crie projetos/meu-primeiro-agente, entre nela e liste o conteúdo. Abra a mesma pasta no Explorador (ou Finder) e compare.
Pronto quando: você chega à pasta só pelo terminal, sem o mouse, e sabe dizer em que pasta está.
Crie o AGENTS.md com quem você é, as regras do projeto e o que tem na pasta.
Pronto quando: o arquivo existe e tem pelo menos três regras suas, escritas por você.
Chame o agente e peça o index.html a partir do AGENTS.md. Abra no navegador e peça uma mudança.
Pronto quando: a página abre e você pediu pelo menos uma correção ao agente.
git init, add e commit. Peça uma mudança grande e, se não gostar, volte com git restore.
Pronto quando: você desfez uma mudança do agente com um comando, sem pânico.
Crie um .env com uma chave falsa e um .gitignore com a linha .env. Acrescente a regra ao AGENTS.md.
Pronto quando: git status não mostra o .env.
Coloque três textos seus na pasta e peça um resumo.md com 5 decisões e 5 pendências, citando a origem de cada uma.
Pronto quando: você achou no original pelo menos duas das frases citadas.
Exercícios completos, com o desafio extra (repetir com o outro agente): jornada-agentes/exercicios/01-oswork.md.
Seis comandos, um AGENTS.md e a primeira tarefa.
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
Onde fica a chave de uma API no projeto?competência
Pergunta 2 de 3
O agente fez uma mudança grande que você não aprovou. O que fazer?
Pergunta 3 de 3
Para que serve o AGENTS.md?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.