3 arquivos de função para ajudantes de IA: pesquisador, redator, revisor

Aqui estão os três arquivos de função que você pediu. Cada um é um texto curto com uma tarefa só. No Claude Code, salve em .claude/agents/. Em outras ferramentas, cole a função no começo de um chat novo ou num assistente personalizado.

researcher.md

---
name: researcher
description: Pesquisa uma pergunta na web e devolve um resumo curto, com fontes. Rode vários em paralelo para comparar opções.
---
Você pesquisa uma pergunta. Leia o CLAUDE.md primeiro.
- Prefira páginas oficiais e fontes primárias. Dê a URL de cada fato.
- Marque como "não verificado" o que você não conseguiu confirmar. Nunca invente números.
- Não faça login em lugar nenhum, não preencha formulários, não baixe arquivos.
Devolva: no máximo 150 palavras — a resposta, os 3 fatos mais importantes com fontes e o que ainda não se sabe.

writer.md

---
name: writer
description: Escreve um primeiro rascunho (e-mail, post, página) no meu tom, a partir de um pedido curto.
---
Você escreve primeiros rascunhos. Leia o CLAUDE.md e o memory/INDEX.md primeiro; siga minhas notas de tom.
- Não me peça nada; se faltar algo no pedido, escreva [colchetes] no lugar.
- Deixe mais curto do que você acha que precisa. Comece pelo ponto principal.
- Nada de afirmações ou números que não estejam no pedido.
Devolva: o rascunho e, depois, uma linha listando tudo que você pôs entre [colchetes].

checker.md

---
name: checker
description: Confere um rascunho com base nas minhas regras antes de eu enviar. Use para e-mails, posts e documentos.
---
Você revisa rascunhos. Leia o CLAUDE.md primeiro.
Para cada rascunho:
1. Ele segue "Como responder" e "Nunca"?
2. Todos os números e nomes têm fonte no próprio rascunho?
3. Tem algo que soe como promessa que não podemos cumprir?
Responda com: OK, ou uma lista de ajustes (uma linha cada). Não reescreva o rascunho.

O que é um ajudante e quando compensa

Um ajudante é um assistente separado, com uma tarefa só, que devolve um resultado curto. Um assistente único fazendo tudo num chat longo fica lento e confuso. Dividir o trabalho resolve isso em três situações:

• Pesquisa em paralelo. Três ajudantes olham uma opção cada; você recebe três resumos curtos em vez de uma conversa embolada.
• Escrever e depois revisar. O revisor não viu o raciocínio do redator, então enxerga erros que o redator justificou para si mesmo.
• Trabalho repetitivo. A mesma tarefa para dez itens, cada um tratado direitinho.

Se for uma consulta rápida, nem se dê ao trabalho. Pergunte ao assistente principal.

Passe o pedido como se fosse para um colega novo

Um ajudante só sabe o que você conta. Use este modelo:

Objetivo: [uma frase]
Já sei / já descartei: [para ele não repetir o seu trabalho]
Onde olhar: [arquivos, sites]
Devolva: [o quê e de que tamanho, ex.: "um resumo de 150 palavras"]

Exemplo:

Objetivo: Encontrar três ferramentas de gestão de projetos por menos de 20 euros por usuário por mês.
Já sei / já descartei: Já testei o Trello e não gostei.
Onde olhar: a página oficial de preços de cada ferramenta.
Devolva: uma comparação de 150 palavras, com o link da página de preços de cada uma.

A falha mais comum é um pedido de uma linha, tipo "pesquise ferramentas de projeto". O ajudante chuta, e você recebe a resposta de uma pergunta que não fez.

Segure o custo

Os ajudantes gastam seus créditos ou seu limite de uso rápido, porque cada um abre uma conversa própria. Três regras:

1. Use ajudantes só para trabalho paralelo ou independente. Não para o que você resolveria numa mensagem só.
2. Escolha um modelo menor e mais barato para pesquisar e revisar. Deixe o modelo mais forte para as decisões e a redação final.
3. Limite a quantidade. Acrescente esta linha ao seu arquivo de regras: *"No máximo 3 ajudantes ao mesmo tempo; avise antes de usar mais."*

Erros comuns

• Dar a vida inteira para o ajudante. Um arquivo de função deve ter dez linhas, não um perfil. Mande ele para o CLAUDE.md para o resto.
• Deixar o revisor reescrever. Ele deve listar ajustes, não fazer um segundo rascunho. Senão você não vê o que mudou.
• Confiar em pesquisa sem fonte. O arquivo do pesquisador exige uma URL para cada fato. Abra uma ou duas antes de confiar.
• Dar ao ajudante permissão para enviar ou comprar. Ajudantes devolvem resultados. Quem decide o que vem depois é você.

Teste

Pegue um e-mail que você mandaria normalmente. Peça um rascunho ao redator a partir de um pedido de três linhas e depois passe o rascunho ao revisor. Se o revisor não achar nada, teste um rascunho com um número inventado e confirme que ele é apontado.

Os ajudantes são uma das cinco partes do sistema. O arquivo de regras, as notas de memória, as pastas de projeto e o resumo da manhã estão no guia completo, com todos os modelos prontos para copiar.

← Todos os artigos