Aula 3 · 16 min
Quando tudo fica numa pasta só, a IA lê material que não tem nada a ver com o pedido e você não sabe de onde veio cada frase. Uma pasta por assunto, com um arquivo para pessoas e outro para o agente, resolve isso antes do primeiro pedido.
Começar a aula
Objetivo: montar a árvore projetos/config e a pasta do projeto com entradas, saídas, README.md e AGENTS.md em Markdown.
Cada gaveta guarda um assunto. Clique em cada parte.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
Reúne trabalhos independentes. Cada pasta dentro dela é um contexto: o material de um assunto só. Quando você abre o agente numa pasta, ele trabalha a partir dela.
Fica dentro de projetos, mas fora de cada projeto. Guarda o que vale sempre, como "prefiro relatórios curtos, com as pendências no fim". Escreve uma vez, usa em todos.
Entradas é o que a IA lê; saídas é o que ela produz, para você revisar. Separadas, dá para conferir uma contra a outra. Não misture aqui material de outro cliente ou de outra turma.
O agente procura o AGENTS.md sozinho ao começar. O resto ele lê quando você aponta: a IA não abre cada arquivo da pasta por conta própria.
Pasta separada por assunto faz a IA ler menos coisa e deixa você saber de onde veio cada frase. Desenhe a árvore no papel antes de criar: os nomes saem com calma.
Nomes curtos, sem espaço e sem acento: meu-primeiro-agente, entradas, saidas.
Texto organizado com três marcas.
O # no começo da linha faz título, ## faz subtítulo e o hífen faz item de lista. O arquivo termina em .md e abre em qualquer editor de texto.
Continua sendo texto: quem lê entende a estrutura mesmo sem formatação.
# Feira de ciências ## Materiais - algodão e um copo
Diz para que serve o projeto e como conferir o resultado. Cinco seções: Propósito, Leia primeiro, Organização, Como verificar e Estado atual.
Ainda não sabe um campo? Escreva "a definir". Campo honesto em aberto vale mais que texto de modelo que ninguém conferiu.
Todo grupo inscrito aparece na lista final.
Diz ao agente quem é você, as regras do projeto e o que tem na pasta. Claude Code e Codex leem o mesmo arquivo, então as regras valem para os dois.
Comece com três regras suas. Na aula 7 ele cresce e ganha regras que dá para conferir.
Antes de terminar, diga o que mudou e como eu confiro.
notepad README.md abre o arquivo no Bloco de Notas; Ctrl+S grava. type README.md mostra no cmd o que ficou gravado.
Acentos trocados no cmd, como ç no lugar de ç, são só a tela; o arquivo está certo.
nano README.md para editar, cat README.md para ver.
Crie as pastas pelo cmd e cole os modelos no Bloco de Notas. Troque o que estiver entre < >.
cd %USERPROFILE%\projetos mkdir config cd meu-primeiro-agente mkdir entradas mkdir saidas dir /b
# Meu primeiro agente ## Propósito <o que este projeto produz, em uma frase> ## Leia primeiro 1. AGENTS.md 2. ../config/decisoes.md 3. ../config/memoria.md ## Organização - entradas: o que a IA lê - saidas: o que ela produz, para eu revisar ## Como verificar <como alguém confere se o resultado está certo> ## Estado atual A definir.
# Quem sou <seu nome, sua profissão, para quem você trabalha> # Regras deste projeto - Escreva em português, frases curtas. - Trabalhe só dentro desta pasta. Não apague arquivos sem perguntar. - Antes de terminar, diga o que mudou e como eu confiro. # O que tem aqui - entradas/: material que você pode ler - saidas/: onde você entrega os rascunhos
notepad README.md notepad AGENTS.md type AGENTS.md
C:\Users\ana\projetos ├─ config └─ meu-primeiro-agente ├─ AGENTS.md ├─ README.md ├─ entradas └─ saidas
O Bloco de Notas pergunta se quer criar o arquivo novo: responda Sim. Grave com Ctrl+S e feche.
notepad AGENTS.md no cmd.Crie as pastas e confira, como no seu computador.
Missões
config aqui em projetos.meu-primeiro-agente.entradas.saidas (sem acento).Simulação: Ana é um exemplo. No cmd, letras maiúsculas e minúsculas no nome do arquivo dão no mesmo.
Na pasta criada na aula 1.
Desenhe a árvore no papel, crie config, entradas e saidas pelo cmd e escreva o README com as cinco seções.
Pronto quando: dir /b mostra entradas, saidas e README.md, e cada seção do README tem informação real ou "a definir".
Crie o AGENTS.md com quem você é, as regras do projeto e o que tem na pasta.
Pronto quando: type AGENTS.md mostra pelo menos três regras suas, escritas por você.
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
Você quer guardar "prefiro relatórios curtos, com as pendências no fim". Onde mora essa nota?
Pergunta 2 de 3
Qual é a diferença entre README.md e AGENTS.md?competência
Pergunta 3 de 3
Você pediu um resumo da feira de ciências e veio uma nota de boletim no meio. Qual a causa provável?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.