grill-me: primeiro faz-te as perguntas

O que é e porque importa

Pedes uma coisa ao Claude, ele arranca e entrega-te outra completamente diferente. Não escreveu mal o código: percebeu outra coisa. E tu refazes tudo do zero. O README da coleção mattpocock/skills chama-lhe o problema mais comum de quem constrói software.

O grill-me faz o contrário. Antes de trabalhar, o Claude procura sozinho o que encontra nos teus ficheiros, depois faz-te as perguntas por rondas, numeradas, cada uma com a resposta que te recomenda: se te servir, dizes só sim. As decisões continuam a ser tuas, e não passa à ação enquanto não confirmares que se entenderam.

É uma skill, ou seja, um pacote de instruções para o Claude Code, dentro da mattpocock/skills: uma coleção gratuita, com licença MIT e mais de 300.000 estrelas no GitHub no fim de outubro (as estrelas são da coleção inteira). O README diz «not vibe coding». Para mim conta ainda mais para quem constrói sem ler o código: se não controlas o como, pôr-se de acordo sobre o quê é a melhor defesa que tens.

1. Instala-o: duas formas, escolhe uma

O README é claro: uma só forma, porque se instalares as duas ficas com cada skill em duplicado.

Forma 1: o plugin, que se atualiza sozinho

É a que recomendo. Está no marketplace oficial da Anthropic, o catálogo de plugins que o Claude Code já conhece, com o nome mattpocock-skills. Corre esta linha no terminal, fora do Claude Code:

claude plugin install mattpocock-skills@claude-plugins-official

Instala-o para ti, em todos os teus projetos. Carrega na próxima sessão, ou com /reload-plugins na que está aberta. Se nesse computador nunca abriste o Claude Code no terminal, corre antes claude plugin marketplace add anthropics/claude-plugins-official.

Para confirmar, escreve / no chat: as skills de um plugin têm o nome dele à frente. Procura esta:

/mattpocock-skills:grill-me

Com o plugin, o comando tem o nome do plugin à frente, e é com ele que o testei; com os ficheiros da forma 2 é /grill-me. As atualizações do plugin chegam sozinhas.

Forma 2: os ficheiros no projeto, que atualizas tu

Se queres ficheiros para ler e mudar, corre esta linha a partir da pasta do projeto. Precisas de uma versão recente do Node.js, o programa que corre o npx.

npx skills@latest add mattpocock/skills

1. Entre as ferramentas, escolhe o Claude Code.
2. Entre as skills, escolhe o grill-me e também o grilling: o grill-me sozinho só chama o grilling, que tem as instruções a sério.
3. Abre o Claude Code na pasta e escreve /grill-me.

Instala-as no projeto em que estás; com -g tens as skills em todos. Para as atualizar: npx skills@latest update.

2. Como se usa: o pedido e depois as rondas de perguntas

O grill-me não arranca sozinho: o Claude não o pode lançar por iniciativa própria, és tu que o lanças. Escreve o comando e, logo a seguir, o que queres fazer, por palavras tuas. Troca as partes entre [ ]:

/mattpocock-skills:grill-me Quero [adicionar uma página de preços]. É para [quem a usa] e serve para [o problema que resolve].

A partir daí, as instruções do grilling dizem ao Claude para trabalhar assim:

• Os factos procura-os ele: o que consegue descobrir sozinho não te pergunta, manda um subagente (um ajudante à parte) procurá-lo.
• As decisões tomas tu: cada pergunta vem numerada e tem por baixo a resposta recomendada, escrita de forma a que um sim a aceite.
• Uma ronda só tem as perguntas a que podes responder agora; as outras esperam pela ronda seguinte.
• Acaba quando nada fica decidido em silêncio, e não age enquanto não confirmares que se entenderam.

Para responder basta um sim. Se uma resposta não te convencer, di-lo com o número dela:

Sim a todas menos à 2: [a tua escolha]. Sobre a 4 tenho uma dúvida: [a dúvida].

3. Uma ronda de perguntas real minha

Experimentei-o a 30 de outubro no Claude Code, no código do meu site, com o plugin. Lancei /mattpocock-skills:grill-me com este pedido: «Quero adicionar ao site uma página “os guias desta semana”, com a capa de cada vídeo, para que quem comenta GUIDA debaixo de um vídeo antigo encontre o guia certo mesmo que no topo de /guida já haja um mais recente.»

Antes de qualquer pergunta, olhou para o código sozinho e escreveu-me o que já existia:

• /guida é uma lista única, ordenada a partir do guia mais recente.
• Não há um campo para a capa nem para o link do vídeo, e as capas estão fora do código do site.

Depois escreveu que as perguntas não dependiam umas das outras, e fez-mas todas numa ronda. Seis, cada uma com a sua resposta recomendada (encurtei-as):

1. De onde vêm as capas? Recomendação: um campo de capa opcional em cada guia; as imagens extrai-as ele dos reels que tenho no computador.
2. O que quer dizer «esta semana»? Está aqui em baixo, palavra a palavra.
3. Endereço e línguas? Recomendação: /guida/settimana, em todas as línguas do site, como /guida.
4. Como chega lá quem comenta GUIDA? Recomendação: um bloco bem visível no topo de /guida que leva à página nova; nas redes sociais não mexe.
5. O que mostra cada cartão? Recomendação: capa, título, número e data, do mais recente para o mais antigo. Sem descrição: quem chega tem de reconhecer o vídeo pela capa.
6. E depois da semana? Recomendação: o guia sai desta página e fica em /guida, sem um arquivo por semanas, para já.

A pergunta 2, tal como chegou (traduzida do italiano)

❓ Q2 - O que quer dizer «esta semana»: são os guias com date nos últimos 7 dias, calculados a cada build. Se houver menos de 7, a página completa até 7 com os mais recentes, para nunca ficar quase vazia. Uma alternativa é a semana de calendário, de segunda a domingo.

➡️ Sim: os últimos 7 dias móveis, preenchendo até 7 guias. A semana de calendário faz desaparecer tudo todas as segundas, mesmo quando chega quem comenta debaixo do vídeo de domingo.

No pedido, «esta semana» parecia claro, mas havia dois caminhos, e um esvaziava a página todas as segundas. Sem as perguntas, essa escolha tinha sido feita pelo Claude. A ti basta-te um sim, ou a tua escolha nesse número.

4. Quando o usar, e por que ordem

O README diz para o usares em cada alteração. Eu guardo-o para as alterações em que uma palavra pode querer dizer duas coisas: uma página nova, uma funcionalidade, o login. A ordem:

1. grill-me: põem-se de acordo sobre o que fazer.
2. Plan mode: o Claude escreve como vai fazer, ficheiro a ficheiro, e não altera nada até aprovares. Como o uso está no guia PIANO.
3. O código, só depois de aprovares o plano.

Com as rondas acabadas, passo ao plano escrevendo /plan antes da mensagem:

/plan Faz o plano do que decidimos nas perguntas. Se precisares de uma escolha que não estava nas respostas, pergunta-ma antes de a pôr no plano.

E o modelo em três linhas do guia PROMPT? Aí escreves tu um pedido claro; o grill-me procura o que falta no pedido. Funcionam bem juntos. Já é demais para uma gralha, uma cor, uma alteração de uma linha: aí pede-a e pronto.

grill-me ou grill-with-docs?

O README apresenta o grill-me para planos, ideias e design, também fora do código. Para o código há o grill-with-docs: as mesmas perguntas, mais um glossário do projeto (GLOSSARY.md) e os ADR, documentos curtos que fixam uma decisão e o porquê. Antes corre-se uma vez por projeto o setup-matt-pocock-skills.

Os erros mais comuns

• Instalar o plugin e também os ficheiros com npx: cada skill duas vezes. Escolhe um.
• Com npx, escolher o grill-me sem o grilling: fica sem instruções.
• Dizer sim a tudo sem ler: as respostas recomendadas são hipóteses, não decisões.

Checklist

• Instalei o grill-me de uma só forma
• Ao escrever / no Claude Code vejo o grill-me
• Depois do comando escrevi o pedido por palavras minhas
• Li cada resposta recomendada antes de dizer sim
• Só depois da última ronda passei para o plan mode

Perguntas frequentes