Brief produtivo para Claude Code: o que iniciantes devem fornecer primeiro

Por que este fluxo importa

Iniciantes raramente falham por escrever prompts feios. Falham porque faltam objetivo, arquivos protegidos, links de receita e critério de pronto. Um brief curto reduz adivinhação e deixa o primeiro patch pequeno.

Fluxo prático

Escreva o objetivo em uma frase, depois arquivo, leitor e razão de negócio. Adicione o que não pode ser tocado, links Gumroad que devem continuar vivos e comando de prova.

Kit mínimo para copiar e colar

# Claude Code task brief

## Goal
Change one clear thing:

## Context
- user or reader:
- current file/page:
- business reason:

## Constraints
- do not touch:
- keep these links working:
- proof command:

## Definition of done
- small diff
- public URL checked
- CTA path still works
- handoff note written

Use this brief before editing.
Ask up to three clarifying questions only if the goal, protected files, or proof command is missing.
Then propose the smallest safe patch and the verification receipt.

rg --files | Select-Object -First 80
git diff --name-only
cd site
npm.cmd run build

Exemplo de um bom brief de pedido

Um bom brief não diz apenas o que deve mudar. Ele também explica por que a mudança existe e o que precisa permanecer intacto. Para editar um artigo, o pedido pode ser assim:

Melhore apenas a introdução e a área de CTA de site/src/content/blog-pt/claude-code-productive-prompt-brief.mdx. O leitor é um desenvolvedor independente que está começando a usar Claude Code. O objetivo é fazê-lo entender quando o PDF gratuito basta e quando Prompt Templates, Setup Guide ou consultoria fazem sentido. Não altere frontmatter, slug, links Gumroad existentes, links internos nem blocos de código. Depois execute node scripts/check-updated-article-quality.mjs e confirme se os erros deste slug desapareceram.

Esse brief funciona porque restringe a área de edição. “Apenas a introdução e a área de CTA” evita uma reescrita completa. O leitor e o objetivo de negócio orientam o tom: Claude Code deve ajudar a próxima decisão do leitor, não só deixar as frases mais bonitas.

Os itens protegidos também estão claros. Frontmatter afeta data, categoria e heroImage. Links Gumroad são caminhos de receita. Links internos mantêm a navegação entre artigos. Blocos de código são material que o leitor copia. Quando esses limites aparecem no começo, a revisão fica muito mais objetiva.

Exemplo de pedido ruim

Um pedido ruim costuma ser curto demais:

Melhore este artigo para SEO e conversão.

Parece claro, mas não define a ação. SEO pode significar título, palavras-chave, links internos, description ou mais corpo de texto. Conversão pode significar CTA mais forte, mais links Gumroad, uma tabela ou um relato de experiência. Sem limites, Claude Code pode gerar um diff amplo e difícil de revisar.

Outro pedido fraco é:

Deixe mais fácil para iniciantes e me avise quando terminar.

A intenção é boa, mas não há critério de pronto. Uma versão melhor pediria um bom brief, um pedido ruim, um template para iniciantes e uma transição natural para PDF gratuito, Gumroad e consultoria. Também deve indicar o comando de verificação que encerra o trabalho.

Template inicial para iniciantes

Você não precisa começar com um prompt perfeito. Preencha cinco linhas simples:

Mudança: uma única coisa que deve mudar
Alvo: arquivo, URL, comando ou tela
Leitor ou usuário: quem deve se beneficiar
Proteções: arquivos, links, comportamentos ou regras que ficam intactos
Prova: comando ou resultado que confirma o término

Se a tarefa é melhorar o CTA de uma página de produto, limite a mudança ao texto e à posição do CTA. O alvo é o arquivo MDX da página. O leitor já entendeu o PDF gratuito, mas ainda não sabe se precisa de templates ou setup guiado. As proteções são os links para PDF gratuito, Prompt Templates e Setup Guide. A prova é build, URL pública e clique nos links.

O template é pequeno de propósito. Ele torna o primeiro patch revisável, reversível e ligado a um resultado. Depois, você pode adicionar regras locais: manter traduções sincronizadas, não mudar preço sem aprovação, preservar screenshots ou não mexer na hierarquia de títulos.

Caminho natural para materiais e consultoria

O brief também ajuda a escolher a próxima oferta. Se a pessoa ainda tem dúvida sobre comandos básicos, o PDF gratuito é o passo certo. Se ela repete pedidos parecidos, Prompt Templates economiza tempo. Se há rollout de equipe, permissões, regras de revisão ou links de receita, consultoria pode sair mais barato do que aprender quebrando produção.

Essa ordem deixa o artigo útil em vez de agressivo. Primeiro entregue algo que resolve o dia de hoje. Depois ofereça material reutilizável quando a repetição aparecer. Por fim, apresente consultoria para casos em que exemplos genéricos não bastam. A rota comercial acompanha o risco real do leitor.

Três casos reais de uso

Ao melhorar só um CTA, proíba reescrita completa e exija URL pública.
Ao editar CLAUDE.md, dê comandos proibidos e comando de build primeiro.
Ao atualizar produto, proteja PDF grátis, Prompt Templates e Setup Guide.

Falhas comuns e como evitar

Pedir ‘melhore isso’. O diff costuma ficar amplo demais.
Omitir links protegidos. O caminho de receita pode sumir sem parecer erro.
Não definir pronto. Claude Code pode parar na pesquisa.

Caminho para PDF grátis, Gumroad e consultoria

Use o PDF grátis antes dos briefs. Use Prompt Templates para pedidos reutilizáveis. Use Setup Guide quando CLAUDE.md, hooks e premissas do projeto precisam ficar estáveis.

Comece pelo PDF gratuito para fixar comandos e hábitos seguros. Use Gumroad quando o fluxo se repetir e marque consultoria quando rollout, equipe ou receita forem caros demais para adivinhar.

O que verifiquei neste artigo

Separei brief Markdown, instrução curta e comando de prova. A meta é uma mudança, uma prova e uma checagem da rota de receita.