CLAUDE.md vs slash commands vs PRPs:o guia de decisão

CLAUDE.md vs slash commands vs PRPs: há três formas de dirigir um assistente de programação com IA, e cada uma responde a uma pergunta diferente. O CLAUDE.md diz à IA como constróis. Os slash commands automatizam o que repetes. Os PRPs descrevem o que construir a seguir. Usa os três em conjunto e funcionalidades que antes levavam 8 a 10 horas ficam prontas em 25 a 50 minutos.

A maioria dos fundadores descobre estas ferramentas uma de cada vez, usa-as indiferentemente e depois não percebe porque é que os resultados são inconsistentes. Não são intermutáveis. São camadas — e saber a que camada pertence cada trabalho é a diferença entre uma IA que entrega e uma IA que se debate. Aqui está o guia de decisão.

As três ferramentas, em linguagem simples

O CLAUDE.md é um único ficheiro de regras que o teu assistente de IA lê antes de mexer no que quer que seja. As tuas convenções de base de dados, as tuas regras de segurança, os teus padrões de nomes, os erros que nunca pode cometer. É o ADN do teu projeto — as regras que nunca mudam de funcionalidade para funcionalidade. Se isto é novo para ti, lê primeiro o único ficheiro que evita 90% dos erros da IA.

Os slash commands são fluxos de trabalho guardados que ativas com uma instrução curta — revê as minhas alterações, escreve a minha mensagem de commit, cria uma migração da base de dados. Pensa neles como marcação rápida para as tarefas que fazes todos os dias.

Os PRPs — Product Requirement Prompts — são plantas de utilização única para uma funcionalidade específica: o objetivo, todo o contexto de que a IA precisa, o plano de implementação e as verificações que provam que funciona. O método completo, o modelo e um exemplo trabalhado estão em o método PRP; este artigo trata só de quando recorrer a um.

CLAUDE.md vs slash commands: quando usar cada um

A última linha importa mais do que parece. Nem tudo precisa de uma planta. Corrigir uma gralha não merece um PRP, e complicar demasiado as pequenas alterações é a forma como os sistemas de produtividade morrem.

Como as três camadas trabalham em conjunto

As camadas empilham-se. O CLAUDE.md fica no topo e informa tudo o que está abaixo. Os PRPs ficam no meio e descrevem a funcionalidade. Os slash commands ficam na base e oleiam o fluxo de trabalho.

É assim que fica a construção de uma funcionalidade quando as três estão no sítio. Passas dez minutos a escrever um PRP curto — o objetivo, uma indicação dos padrões que a funcionalidade deve seguir e como verificar que funciona. Entregas-o à IA. Como o teu CLAUDE.md já contém as tuas regras, não as repetes: a IA aplica automaticamente o teu modelo de segurança, as tuas convenções de base de dados e os teus padrões de serviços. Constrói a alteração à base de dados, a lógica, os ecrãs e os testes. Depois corres três slash commands — revisão, commit, pull request — em cerca de dois minutos.

Total: cerca de 42 minutos para uma funcionalidade que teria levado 6 horas de vaivém sem estrutura. Não é um ganho de velocidade a escrever. É um ganho na estrutura de decisão — a mesma mudança descrita em deixa de usar a IA como um corretor automático.

12 semanasA tua carreira corporativa nunca foi o planoCandidata-te ao Solopreneur Accelerator.Candidatar-me →

Os quatro erros que te fazem perder tempo

Erro 1: usar PRPs para tudo. Os PRPs são para funcionalidades, não para correções. Escrever uma planta formal para mudar a cor de um botão é procrastinação com um disfarce de produtividade. Alterações rápidas: pede e pronto.

Erro 2: não usar o CLAUDE.md de todo. O sintoma revelador é escrever as mesmas instruções em todos os prompts — isola sempre os dados dos clientes, acrescenta sempre verificações de segurança, segue sempre os nossos padrões. Se estás a repetir uma regra, ela pertence ao CLAUDE.md, uma vez, e todos os prompts futuros herdam-na de graça.

Erro 3: criar slash commands para tarefas únicas. Um comando com um nome como “adicionar processamento de pagamentos” é um erro de categoria. Os pagamentos constroem-se uma vez — isso é um PRP. Os slash commands são para fluxos de trabalho que repetes, não para funcionalidades que constróis.

Erro 4: deixar o CLAUDE.md ficar desatualizado. Um ficheiro de regras de há seis meses descreve um projeto que já não existe. Atualiza-o quando estabeleces um novo padrão, quando a IA continua a cometer o mesmo erro (acrescenta-o como anti-padrão) ou quando adotas uma nova ferramenta. Uma planta desatualizada é, em silêncio, pior do que nenhuma, porque confias nela.

Como é uma configuração madura

Depois de algumas semanas a construir desta forma, a configuração ideal é surpreendentemente pequena: um CLAUDE.md com 20 a 50 regras, uma biblioteca de 10 a 20 slash commands para os teus fluxos diários e 1 a 3 PRPs por semana — um por cada funcionalidade que lanças.

O ganho acumula-se ao longo de todo o fluxo de trabalho. Rever alterações passa de 10 minutos para 30 segundos. Escrever um commit passa de 5 minutos para 10 segundos. Abrir um pull request passa de 10 minutos para 20 segundos. E a funcionalidade em si — a maratona de 4 a 6 horas — passa a ser 20 a 45 minutos de construção dirigida. Por funcionalidade, são 8 a 10 horas reduzidas a 25 a 50 minutos: uma diferença de 10 a 20 vezes, não por trabalhares mais, mas por dares à IA o tipo certo de instrução na camada certa.

Uma frase para te lembrares do sistema inteiro: o CLAUDE.md é o teu ADN, os slash commands são os teus hábitos diários, os PRPs são as tuas plantas. A IA não precisa que escrevas mais depressa. Precisa que decidas qual dos três lhe estás a entregar.

O livroThe Solopreneur RevolutionLuis Gonçalves sobre como construir um negócio de EUpreendedor com IA sem deixar o emprego.Quero o livro →

Perguntas frequentes

Preciso das três ferramentas antes de começar a construir?

Não. Começa com o CLAUDE.md no primeiro dia — é um ficheiro e compensa de imediato. Acrescenta slash commands quando reparares que repetes um fluxo de trabalho cinco ou mais vezes por semana. Escreve o teu primeiro PRP quando construíres a tua primeira funcionalidade a sério. A stack cresce com o projeto.

Qual é a diferença entre um PRP e um slash command?

A frequência. Um PRP descreve algo que constróis uma vez — uma funcionalidade. Um slash command automatiza algo que fazes constantemente — um fluxo de trabalho. Se o vais correr todos os dias, faz dele um comando. Se o vais lançar uma vez e seguir em frente, escreve um PRP.

Quando devo saltar tudo isto e escrever simplesmente um pedido?

Quando a alteração demora cinco minutos e não mexe em nada estrutural. Mudar o nome de uma etiqueta, corrigir uma gralha, ajustar um espaçamento — pede e pronto. O sistema de plantas existe para tornar fiáveis as coisas grandes, não para acrescentar cerimónia às pequenas.

Com que frequência devo atualizar o CLAUDE.md?

Todas as semanas, ou sempre que algo muda: estabeleces um novo padrão, a IA repete um erro que vale a pena proibir ou acrescentas uma tecnologia. Trata-o como um contrato vivo entre ti e a tua IA — no momento em que deixa de refletir a realidade, o seu valor passa a ser negativo.