E7 · A primeira tarefa
20 minFaça o pedido 1 (só leitura) e o pedido 2. Abra a página com start index.html e peça uma mudança.
Pronto quando: a página abre no navegador e você pediu pelo menos uma correção ao agente.
Aula 4 · 18 min
Primeiro o agente lê, depois ele muda
"Arrume o projeto" mistura diagnóstico e mudança: se algo sai errado, você não sabe em qual parte foi. Separar leitura de alteração, dar a menor permissão que resolve e pedir um fechamento que diz o que foi conferido transforma o agente em alguém que você gerencia.
Começar a aula
Nesta aula você vai
- 1Pedir leitura sem edição e conferir os arquivos usados
- 2Autorizar uma mudança pequena e com nome
- 3Escrever uma autorização em cinco partes
- 4Exigir o fechamento: feito, conferido, pendente
Objetivo: dar ao agente uma tarefa com escopo, conferir o que ele leu e mudou, e pedir pelo menos uma correção.
01Vistoria antes da reforma
A ordem do primeiro trabalho, em quatro etapas.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
- 1/5
Inspecionar
Nenhum arquivo muda nesta etapa. Peça com todas as letras: sem editar. E peça que ele diga quais arquivos leu, para você comparar com o
dir /b. - 2/5
Planejar
A lista do que falta é a sua referência. Se ele avisou que não abriu um arquivo, o plano ainda não conhece aquele conteúdo: diga no próximo pedido em que ele deve se apoiar.
- 3/5
Alterar
Você diz qual arquivo pode ser criado ou mudado. Se o agente perguntar antes de editar, confira que é só aquele arquivo e aprove. Se for outro, recuse.
- 4/5
Validar
A última palavra é sua. Abra o resultado e compare com o que pediu. Peça pelo menos uma correção: dar a tarefa, conferir e decidir é gestão.
- 5/5
Usar × gerenciar
Quem usa pede e aceita. Quem gerencia separa leitura de mudança, autoriza com escopo e confere antes de aprovar. A diferença está no hábito, não na ferramenta.
Vale igual no Claude Code e no Codex: os dois leem o AGENTS.md e trabalham na pasta onde foram abertos.
02Autonomia é autorização com escopo
Cinco partes que cabem num post-it.
1. Objetivo e arquivos
Diga o que é para produzir e o que ele pode ler. "Rascunho do relatório de setembro, só a partir da planilha de setembro."
Pasta pequena, só com o material da tarefa, já limita o que ele alcança.
Exemplo
Objetivo: index.html sobre mim. Arquivos: só o AGENTS.md.
2. Ações e parada
Diga as ações autorizadas e as proibidas: ler e criar, sim; apagar e renomear, não. Enviar, publicar e apagar são ações externas: cada uma exige instrução explícita.
O botão existir não é permissão. Diga onde ele para e espera você.
Parada
Entregue o rascunho e pare antes de enviar.
3. Permissão mínima
Ler arquivos tem risco baixo; escrever, médio; executar comandos, alto. Comece pelo mais restrito que dá conta da tarefa.
Regra escrita orienta; quem impede de fato são as permissões do programa. No Codex, /permissions mostra e troca o que ele pode fazer.
Não faça
Tirar todas as proteções para contornar um erro.
4. Fechamento
Peça sempre que ele termine dizendo o que foi feito, como foi verificado e o que ficou pendente.
Assim o resultado vira algo que você revisa, e não algo em que precisa acreditar.
Fechamento
Feito: index.html. Conferido: abre no navegador. Pendente: foto.
03Os pedidos, na ordem
Abra o agente dentro da pasta (claude ou codex) e cole um pedido por vez.
Pedido 1 · só leitura
Leia AGENTS.md e README.md. Explique o propósito do projeto e liste o que falta, sem editar nada. No fim, diga quais arquivos você usou.
Pedido 2 · mudança com nome e parada
Leia o AGENTS.md. Crie só o index.html com uma página simples sobre mim, usando o que está lá. Não altere nem apague outros arquivos. No fim, diga: o que foi feito, como você conferiu e o que ficou pendente.
cmd · conferir a mudança
dir /b start index.html
Pedido 3 · a correção
Troque o título por "<seu título>" e acrescente uma seção de contato. Só no index.html.
Pedido 4 · o agente lê os seus arquivos
Leia os arquivos .txt da pasta entradas e escreva saidas/resumo.md com 5 decisões e 5 pendências, citando de qual arquivo veio cada uma.
cmd · ponto de retorno antes do Git (aula 6)
cd %USERPROFILE%\projetos xcopy /e /i meu-primeiro-agente meu-primeiro-agente-antes rem depois da mudança, compare: fc /n meu-primeiro-agente-antes\*.md meu-primeiro-agente\*.md
Simulação: exemplo ilustrativo
Pedido 1: "O propósito é uma página sobre a Ana. Falta: o index.html, o formato e como conferir. Arquivos lidos: AGENTS.md e README.md. Também consultei a listagem. Nada foi editado."
Explicou, listou o que falta, disse o que leu e o que não leu. Nenhum arquivo mudou.
- Os arquivos que ele diz ter lido existem no
dir /b. - Depois do pedido 2, só apareceu o index.html.
- A página abre no navegador e você pediu uma correção.
- No resumo.md, você achou no original pelo menos duas das frases citadas.
- "Melhore a página": gera mudança que você não sabe conferir. Peça um resultado que dá para ver.
- Aprovar sem ler: o agente pergunta antes de editar justamente para você ver qual arquivo muda.
- Citação que não existe no original: anote no AGENTS.md a regra que faltou ("cite só frases que existem no arquivo").
04Prática
Com o agente aberto dentro de meu-primeiro-agente.
E8 · O agente lê os seus arquivos
20 minColoque em entradas três textos seus (anotações, uma ata, um e-mail longo) e faça o pedido 4. Confira duas citações no arquivo original.
Pronto quando: você achou no original pelo menos duas das frases citadas. Se alguma não existir, a regra que faltou foi para o AGENTS.md.
05Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
Qual é o melhor primeiro pedido numa pasta nova?competência
Correto
Primeiro a vistoria: ler sem editar e dizer o que usou. Assim você tem uma referência antes de qualquer mudança.Não é essa
Primeiro a vistoria: ler sem editar e dizer o que usou. Assim você tem uma referência antes de qualquer mudança.Rever: Vistoria antes da reformaPergunta 2 de 3
A autorização dizia só "organize a pasta das provas", e o agente apagou três arquivos que pareciam cópias. Qual parte faltou?
Correto
Sem dizer o que ele pode e não pode fazer (ler e criar, sim; apagar, não), apagar ficou implícito.Não é essa
Sem dizer o que ele pode e não pode fazer (ler e criar, sim; apagar, não), apagar ficou implícito.Rever: Autonomia é autorização com escopoPergunta 3 de 3
O AGENTS.md diz "não envie nada". Isso impede tecnicamente o envio?
Correto
Regra escrita orienta o comportamento; permissão limita o que é possível. As duas se completam.Não é essa
Regra escrita orienta o comportamento; permissão limita o que é possível. As duas se completam.Rever: Autonomia é autorização com escopoTeste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.Escolha uma alternativa. A explicação aparece depois da sua tentativa.