A Anthropic, a empresa que faz o Claude, recomenda tratar o Claude como um funcionário brilhante, mas novo, que ainda não conhece as suas normas. Quem já contratou gente sabe o que isso pede: objetivo claro, o contexto de onde ele veio e um exemplo de trabalho bem feito. Nesta aula você junta as três coisas numa ficha de função e confere a sua ficha na própria página.
Objetivo: escrever a ficha de função de um agente com papel, objetivo medível, contexto, exemplo e fronteira.
01 · Os três passos viram uma ficha
Toque ou clique em cada passo.
Aula 401 · Os três passos viram uma fichaToque ou clique em cada passo.
1/5
Objetivo
O que precisa acontecer e como saber que aconteceu. Se não dá para medir, o agente não consegue conferir o próprio trabalho e não sabe quando parar (aula 5).
Role a página: cada etapa abaixo acende a sua parte do diagrama.
1/5
Objetivo
O que precisa acontecer e como saber que aconteceu. Se não dá para medir, o agente não consegue conferir o próprio trabalho e não sabe quando parar (aula 5).
2/5
Contexto
De onde veio esse objetivo e por quê: quem pediu, para quem é, o que já foi tentado. Na maior parte vem da base da aula 3; na ficha você só aponta onde ela está.
3/5
Exemplo
"Faça um ótimo trabalho" não funciona: ele não sabe o que é ótimo para você. Faça a tarefa uma vez, você mesmo, bem feita. É o tempo mais bem gasto, e provavelmente a última vez que você faz essa tarefa.
4/5
Ficha de função
A ficha junta os três passos e acrescenta duas coisas que todo funcionário precisa: o que nunca pode fazer (fronteira) e quando você confere o trabalho. É ela que você entrega ao agente.
5/5
Do pedido à função
Objetivo medível, contexto e exemplo, mais fronteira e conferência: a ficha de função. Você para de escrever o trabalho e passa a gerenciá-lo.
Um esboço bem feito e conferência de vez em quando: é assim que se delega para alguém capaz.
02 · Como as equipes da Anthropic pedem
Casos contados pela própria Anthropic. Repare no tamanho dos pedidos.
1. Reescrever o app
O criador do Claude Code (um agente de programação) quis o aplicativo de computador reescrito em Swift, outra linguagem de programação.
O pedido trazia o próprio teste: rodar o app antigo, tirar print, comparar as telas ponto por ponto com o novo e não parar até ficar igual. O agente rodou sozinho por mais de duas semanas.
Por que funcionaO objetivo se mede sozinho: a tela nova é igual à antiga ou não é.
2. Responder no Slack
Em outro caso, o Claude entrou numa conversa do Slack (o chat interno de muitas empresas), puxou dados de várias ferramentas e montou uma resposta só.
Ninguém escreveu o passo a passo: o papel era responder a equipe com dados.
Por que funcionaO contexto (acesso às ferramentas) já estava lá; o pedido foi a pergunta da equipe.
3. Um compilador
Um pesquisador colocou dezesseis agentes Claude para construir um compilador de C (o programa que transforma o código escrito por gente num programa que o computador roda), com uma ordem simples: continuem até ficar perfeito.
Foram mais ou menos duas semanas de trabalho.
Por que funciona"Perfeito" ali tinha medida: o compilador passa nos testes ou não passa.
4. O padrão
Os pedidos são curtos, como os que você faria para alguém da equipe. O que eles têm é um jeito de medir o resultado e o contexto à mão.
É isso que a ficha de função força você a escrever.
Para levarPedido curto + medida clara + contexto disponível = agente que roda sozinho. No chat, a mesma ficha faz cada conversa já começar no papel; rodar sozinho é coisa do terminal e das automações.
03 · Modelo: a ficha de função
Uma linha por campo. Troque o texto entre < > pelo seu.
ficha-funcao.txt
Papel: <a função, em uma frase: você cuida de ...>
Objetivo: <o que precisa acontecer>
Medida: <como saber que terminou e ficou bom>
Contexto: <onde estão as regras, as lições e os arquivos; por que a tarefa existe>
Exemplo: <onde está o trabalho de referência feito por você>
Fronteira: <o que nunca pode fazer>
Conferência: <quando e como você olha o trabalho>
Como entregar a ficha ao agente
A partir de agora este é o seu papel. Leia a ficha abaixo, as regras do projeto e o exemplo indicado.
Antes de começar, me diga em três linhas como você vai conferir o próprio trabalho pela Medida.
<cole aqui a ficha>
Simulação: exemplo ilustrativo
Papel: você cuida do comunicado semanal da escola aos pais.
Objetivo: toda sexta, um comunicado com o que muda na semana seguinte.
Medida: cabe numa tela de celular, cita a data de cada mudança e eu aprovo sem pedir correção.
Contexto: regras e lições nas instruções do projeto; o calendário enviado ao projeto (calendario.pdf).
Exemplo: o arquivo comunicado-modelo.txt enviado ao projeto, escrito por mim.
Fronteira: nunca prometer transporte nem citar nome de aluno.
Conferência: eu leio toda sexta às 16h antes de enviar.
Papel: você responde os pedidos de orçamento que chegam pelo WhatsApp da loja.
Objetivo: todo orçamento com itens, quantidades e total pela tabela atual.
Medida: total igual ao da tabela, prazo de entrega citado, resposta em até 1 hora no horário da loja.
Contexto: tabela de preços e regras de frete enviadas ao projeto.
Exemplo: três orçamentos que eu mesmo respondi.
Fronteira: nunca dar desconto nem prometer entrega no mesmo dia.
Conferência: eu olho os orçamentos do dia às 18h.
Papel: você escreve os anúncios de vaga da empresa.
Objetivo: um anúncio por vaga aberta, a partir do pedido do gestor.
Medida: cabe em uma tela de celular, cita salário, local e jornada, e o gestor aprova sem correção.
Contexto: política de vagas e tom da empresa nas instruções do projeto.
Exemplo: o anúncio da vaga de conferente, escrito por mim.
Fronteira: nunca pedir idade, foto ou estado civil.
Conferência: eu leio antes de publicar, no mesmo dia.
Papel de prestígio ("você é o melhor redator"): não é função. Função diz do que ele cuida.
Medida vaga ("ficar bom"): ele não sabe quando parar.
Sem exemplo: "ótimo" para ele não é o seu "ótimo".
No chat: cole a ficha nas instruções do projeto e envie o exemplo como arquivo. Cada conversa nova do projeto já começa no papel.
No terminal: salve como ficha-funcao.txt na pasta e cite o arquivo no AGENTS.md.
04 · Confira a sua ficha
Cole a sua ficha (ou carregue o .txt). A página confere os sete campos, recusa vazio e adjetivo solto ("quando der", "do seu jeito", "bom", "bonito") e pede na Medida um número ou teste junto do que se mede ("3 linhas", "cita a data", "aprovado sem correção"). O OK é uma checagem de forma, não garante que a medida é boa: quem decide é você, na prática abaixo. A aula 5 aprofunda.
ficha-funcao.txt
05 · Prática: a ficha do seu primeiro agente
Use o "candidato a papel" que você marcou na aula 1.
E1 · O trabalho de referência
30 min
Faça a tarefa uma vez, você mesmo, do jeito que você considera ótimo. Salve como referência e anote dois erros que você quer evitar.
Pronto quando: existe um arquivo de referência feito por você e uma lista com dois erros a evitar.
E2 · A ficha
20 min
Preencha o ficha-funcao.txt com os sete campos e cole no conferidor acima.
Pronto quando: o conferidor responde "OK: ficha com os 7 campos preenchidos" e você escreveu, em uma frase, como confere a Medida olhando uma entrega.
E3 · A primeira entrega
20 min
Entregue a ficha ao agente (no chat: cole nas instruções do projeto e abra uma conversa nova; no terminal: salve na pasta) e peça a primeira execução com o pedido do modelo.
Pronto quando: o agente descreveu como vai se conferir pela Medida e entregou um resultado que você comparou com a referência.
Quais são os três passos para delegar a um agente?competência
Correto
É o que você daria a alguém brilhante, mas novo na empresa: o que fazer e como medir, de onde veio, e como é um trabalho bem feito.
Não é essa
É o que você daria a alguém brilhante, mas novo na empresa: o que fazer e como medir, de onde veio, e como é um trabalho bem feito.Rever: Os três passos viram uma ficha
Pergunta 2 de 4
Por que fazer a tarefa uma vez você mesmo antes de delegar?
Correto
"Faça um ótimo trabalho" não diz nada. O exemplo mostra o padrão. É tempo bem gasto: provavelmente a última vez que você faz essa tarefa.
Não é essa
"Faça um ótimo trabalho" não diz nada. O exemplo mostra o padrão. É tempo bem gasto: provavelmente a última vez que você faz essa tarefa.Rever: Os três passos viram uma ficha
Pergunta 3 de 4
No caso do app reescrito em Swift, o que deixou o agente rodar duas semanas sozinho?
Correto
O pedido era curto, mas trazia o teste. Com medida clara, o agente se confere e sabe quando terminou.
"Papel: você é o melhor redator do mundo." O que há de errado?
Correto
Função diz do que o agente cuida ("você cuida do comunicado semanal aos pais"). Prestígio não muda o resultado, como vimos na aula 2.
Não é essa
Função diz do que o agente cuida ("você cuida do comunicado semanal aos pais"). Prestígio não muda o resultado, como vimos na aula 2.Rever: Modelo: a ficha de função
Teste 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.
08 · A aula em três frases
Brilhante, mas novoDelegue como para alguém capaz que ainda não conhece a casa.
Três passosObjetivo medível, contexto e um exemplo feito por você.
A fichaPapel, objetivo, medida, contexto, exemplo, fronteira e conferência, numa folha só.