O teste do desconhecido

O que é e porque importa

Um post nosso passou as cem mil visualizações. Por baixo, um comentário: «alguém percebeu alguma coisa?». E essas visualizações todas não trouxeram downloads.

O problema não era a história. Era que nós sabíamos demais. Relês o teu texto e parece-te claro, porque já tens tudo o resto na cabeça: o produto, o porquê, a parte que cortaste para ficar curto. Quem lê só tem o texto.

O teste do desconhecido é isto: dás só o texto a um agente novo, sem contexto e com o modelo mais pequeno. Fazes-lhe três perguntas: o que aconteceu (ou o que faz este produto), para quem é e porque me diz respeito, o que devo fazer agora. Depois pedes-lhe as palavras e as passagens que não percebeu. Se errar uma resposta, o problema não é dele: reescreve-se. Vale para tudo o que outra pessoa vai ler: posts, landing pages, a página da App Store, onboarding, emails.

1. O prompt das três perguntas

Em vez de [cola aqui] põe o texto, só o texto: nada de nome do ficheiro, nada de explicações tuas.

És uma pessoa qualquer a fazer scroll no telemóvel. Não sabes nada de quem escreveu este texto, nem do seu produto. Lê só o texto abaixo e responde:

1. O que aconteceu? Ou, se é um produto: o que faz?
2. Para quem é? Porque é que me deveria interessar?
3. O que devo fazer agora?

Uma ou duas frases por pergunta, por palavras tuas. Se a resposta não estiver no texto, escreve «não sei». Não adivinhes. Se tiveste de deduzir alguma coisa, diz.

Depois lista:
- as palavras que não percebeste;
- as passagens onde paraste ou tiveste de reler, com a frase exata.

Não dês conselhos sobre como o melhorar.

TEXTO:
[cola aqui]

A primeira pergunta muda um pouco consoante o tipo de texto:

• um post que conta uma história: o que aconteceu, e o que tem o produto a ver com isso;
• uma landing page ou a página da App Store: o que faz este produto;
• um ecrã de onboarding: o que tenho de fazer neste ecrã;
• um email: o que me estão a pedir.

«Não dês conselhos» não é um pormenor. Se o deixares à solta, reescreve-te o texto, e já não sabes onde é que ele se perdeu.

2. Lança-o como subagente, com o modelo pequeno

No Claude Code um subagente arranca com um contexto novo: não vê a tua conversa. Mas atenção: por defeito lê os CLAUDE.md, ou seja, precisamente a descrição do teu produto. E aí já não é um desconhecido. Por isso crio um agente fixo, no ficheiro .claude/agents/stranger.md:

---
name: stranger
description: Leitor sem contexto. Lê só o texto que recebe e diz o que percebeu. Para usar antes de publicar qualquer texto.
tools: Read
model: haiku
omitClaudeMd: true
---

És uma pessoa qualquer a fazer scroll no telemóvel. Não sabes nada de quem escreveu o texto, nem do seu produto. Lê só o texto ou o ficheiro que te derem, mais nada.

Responde:
1. O que aconteceu? Ou: o que faz este produto?
2. Para quem é? Porque é que me deveria interessar?
3. O que devo fazer agora?
Uma ou duas frases por pergunta, por palavras tuas. Se a resposta não estiver no texto, escreve «não sei». Se tiveste de deduzir, diz.

Depois lista as palavras que não percebeste e as passagens onde paraste, com a frase exata. Não dês conselhos.

• model: haiku é o modelo mais pequeno. Se ele percebe, também percebe quem faz scroll à pressa.
• omitClaudeMd: true fá-lo arrancar sem os teus CLAUDE.md. Precisa de uma versão recente do Claude Code.
• tools: Read chega-lhe para abrir um ficheiro ou as imagens de um post. Nada de web, nada de alterações.

Depois, na sessão, escreve isto (ou escreve @ e escolhe-o da lista):

Usa o subagente stranger, com o modelo haiku, no texto de [ficheiro]. Espera pela ata dele e passa-ma tal como está, sem a comentar.

Porque é que repito «com o modelo haiku»? Quando o Claude lança um subagente pode escolher-lhe um modelo, e essa escolha vale mais do que o campo model do ficheiro. Escrevê-lo na mensagem tira a dúvida. Se não quiseres criar o ficheiro, podes pedir um subagente general-purpose com o modelo haiku: funciona, mas lê os CLAUDE.md, por isso o teste vale menos.

3. Transforma-o num comando

Se o usas muitas vezes, uma skill transforma-o num comando: /stranger seguido do ficheiro. Cria .claude/skills/stranger/SKILL.md:

---
name: stranger
description: Teste do desconhecido sobre um texto antes de o publicar.
disable-model-invocation: true
context: fork
agent: stranger
background: false
---

Lê só $ARGUMENTS e faz o teste: as três perguntas, e depois as palavras e as passagens que não percebeste.

• context: fork corre-o num subagente à parte; agent: stranger escolhe o teu agente, com o seu modelo e sem CLAUDE.md.
• background: false faz esperar pela ata, em vez de a mandar depois como notificação.
• disable-model-invocation: true quer dizer que só arranca quando és tu a chamá-lo.

Usa-se assim: /stranger landing/index.html. A ata volta para a tua conversa.

4. Como ler as respostas

Antes de o lançar escrevo eu as três respostas certas, uma linha cada. Depois comparo:

• Resposta certa, por palavras dele: passa.
• Resposta errada ou «não sei»: essa parte não está no texto, ou não se percebe. Reescreve-se.
• Resposta certa mas deduzida: para mim está errada. Quem faz scroll não para para deduzir.
• Palavras que não percebeu: cada uma troca-se por uma do dia a dia, ou explica-se na mesma frase.
• Passagens onde parou: normalmente falta um elo entre duas frases, ou duas frases contradizem-se.

Um exemplo real, de um post nosso. Na primeira ronda o agente encravou em palavras como «fisiologista» e «lactato». Na quarta respondia certo, mas sobre a ligação com a app escreveu que a tinha deduzido ele: também reescrevemos isso. Na sexta respondia certo sem deduzir nada.

5. O que corrigir, e quando repetir

• Corrige o texto, não o prompt. Se acrescentares explicações no prompt, quem lê a sério não as vai ter.
• Cada termo técnico traduz-se na mesma frase: não «VO2max», mas «o fôlego».
• Um número sozinho não diz nada: põe-lhe ao lado a comparação. E nunca duas percentagens para comparar entre si.
• Cada ronda com um agente novo. O anterior já leu a versão antiga: já não é um desconhecido.
• Paras quando as três respostas estão certas sem deduzir e não fica nenhum tropeção nas passagens que contam.

Connosco a ata vai para o relatório do dia, e um post sem ata nem sequer chega ao crítico final (o sistema completo está em strikt.fit/marketing-notturno).

Os erros mais comuns

• Perguntar ao Claude «está claro?» no mesmo chat: sabe tudo o que tu sabes, e vai dizer-te que sim.
• Deixá-lo ler os CLAUDE.md: já conhece o produto. Usa omitClaudeMd: true.
• Dar-lhe o texto rodeado das tuas explicações: dá-lhe só o que quem lê vai ver.
• Usar um modelo grande: reconstrói até o que falta no texto.
• Discutir com ele: se não percebeu, não escreveste com clareza. Reescreve.

Checklist

• As três respostas certas escritas por mim, antes do teste
• Agente com model: haiku e omitClaudeMd: true
• Dei-lhe só o texto, sem contexto
• Três respostas certas, sem deduzir
• Cada palavra difícil trocada ou explicada na mesma frase
• Última ronda feita com um agente novo

Perguntas frequentes