grill-me
por alirezarezvanigrill-me é uma skill de Decision Support que testa planos e designs sob pressão por meio de questionamento uma pergunta por vez, respostas recomendadas, exploração do codebase e scripts auxiliares para extrair ramos de decisão e acompanhar sessões.
Esta skill recebe 78/100, o que a torna uma boa candidata para listagem para usuários do diretório que querem um agente capaz de questionar planos ou designs de forma mais sistemática do que um prompt genérico. Ela tem um padrão de ativação claro, uma disciplina de interação fácil de lembrar e arquivos de apoio práticos, embora os usuários devam esperar alguma ambiguidade na configuração e ferramentas heurísticas, não um pacote completo e refinado de ponta a ponta.
- Alta capacidade de acionamento: o frontmatter diz explicitamente para usá-la quando o usuário quiser testar um plano sob pressão, ser questionado sobre um design ou disser “grill me”.
- As regras operacionais são concretas: uma pergunta por vez, oferecer uma resposta recomendada, explorar o codebase antes de perguntar e percorrer a árvore de decisão em profundidade.
- Materiais de apoio úteis incluem padrões de forcing-question, condições de parada e scripts em Python para extrair ramos de decisão, gerar perguntas e acompanhar sessões de múltiplos turnos.
- Não há comando de instalação nem README no caminho da skill, então os usuários precisam deduzir a instalação pelo repositório mais amplo ou pela configuração do Claude Skills.
- As ferramentas complementares são heurísticas e baseadas em regex, e fazem referência a um agente de persona e a um slash command fora do diretório da skill mostrado; por isso, a adoção pode exigir mais contexto do repositório.
Visão geral do grill-me skill
O que o grill-me faz
grill-me é um skill de interrogatório de decisões para fluxos de trabalho com agentes no estilo Claude. Em vez de dar um feedback amplo sobre um plano, ele entrevista você com uma pergunta por vez até esclarecer ramificações, dependências, trade-offs e pressupostos que ainda estão nebulosos. O comportamento central é simples, mas valioso: fazer uma pergunta que force uma escolha, incluir uma resposta recomendada, esperar e então seguir pela árvore de decisão.
Melhor uso para suporte à decisão
Use grill-me para suporte à decisão quando você tiver um plano de produto, desenho de engenharia, proposta de arquitetura, estratégia de migração, checklist de lançamento ou documento do tipo “deveríamos fazer X” que precisa ser testado sob pressão antes da execução. Ele é especialmente útil quando um plano contém TBDs, trade-offs vagos, dependências ocultas ou decisões tomadas por padrão, e não de forma deliberada.
O que diferencia este skill
O diferencial é a disciplina. O grill-me skill não agrupa dez perguntas, não escorrega para uma crítica genérica e não deixa o usuário responder de forma vaga. Ele prefere explorar a codebase a fazer perguntas desnecessárias, percorre ramificações em profundidade e faz perguntas que obrigam uma posição, como “Por que X, e não Y?” ou “O que convenceria você de que esta abordagem está errada?”. O repositório também inclui utilitários em Python usando apenas stdlib para extrair ramificações de decisão, gerar perguntas e acompanhar sessões com múltiplas interações.
Quando ele não é a ferramenta certa
Não instale grill-me se você quer que alguém escreva um plano polido do zero para você, um parceiro leve para brainstorming ou uma revisão rápida de “LGTM”. Ele é intencionalmente desconfortável: o skill foi feito para desacelerar a conversa, expor raciocínios frágeis e forçar comprometimento. Isso o torna poderoso antes de decisões caras, mas excessivo para escolhas triviais.
Como usar o grill-me skill
Instalação do grill-me e caminho do repositório
Instale com:
npx skills add alirezarezvani/claude-skills --skill grill-me
O skill fica em engineering/grill-me/skills/grill-me no repositório. Comece lendo SKILL.md e depois examine os arquivos de apoio que explicam como conduzir uma sessão de grill melhor: references/forcing_question_patterns.md, references/when_to_stop_grilling.md e references/companion_tooling.md. Os scripts ficam em scripts/ e exigem apenas a stdlib do Python.
Entradas de que o skill precisa
Para o melhor grill-me usage, forneça um plano ou artefato de design, não apenas um objetivo vago. Uma boa entrada inclui:
- a decisão que você está tentando tomar
- a abordagem atualmente proposta
- alternativas que você considerou
- restrições, prazos e riscos conhecidos
- partes que ainda estão TBD ou são politicamente sensíveis
- links ou caminhos para código, documentação, tickets ou notas de arquitetura relevantes
Um prompt fraco seria: “Grill me on this idea.”
Um prompt mais forte seria: “Use grill-me on docs/auth-migration.md. We plan to move sessions from Redis to Postgres before Q3. Focus on rollback, performance risk, and whether our dependency on the billing service is actually locked.”
Fluxo de trabalho prático
Um fluxo de grill-me guide com alto sinal fica assim:
- Coloque o plano em um arquivo markdown.
- Peça ao agente para usar
grill-mee ler o plano primeiro. - Se a resposta estiver no repositório ou na codebase, deixe o agente inspecionar os arquivos em vez de perguntar a você.
- Responda uma pergunta por vez.
- Registre as decisões conforme elas forem sendo fechadas.
- Pare apenas quando as ramificações não resolvidas tiverem se esgotado.
Para planos maiores, rode os scripts auxiliares localmente:
python scripts/decision_tree_extractor.py path/to/plan.md
python scripts/question_generator.py path/to/plan.md --output json
python scripts/grill_session_tracker.py --action start --session auth-migration --plan path/to/plan.md
Essas ferramentas não chamam um LLM. Elas ajudam a revelar ramificações de decisão e a preservar o estado ao longo de sessões de revisão longas.
Padrão de prompt que funciona bem
Use um prompt que dê autoridade, escopo e regras de parada:
“Use the grill-me skill for Decision Support on this plan: <path>. Ask one question per turn. Provide your recommended answer with each question. Explore the codebase before asking anything answerable from files. Walk dependencies depth-first. Track resolved decisions and tell me when every branch is answered or when no new questions arise.”
Isso importa porque o valor do skill vem da sequência. Se você pedir “todo o feedback de uma vez”, passa por cima do principal benefício.
FAQ do grill-me skill
O grill-me é só para planos de engenharia?
Não. O caminho do repositório é orientado a engenharia, e a regra de exploração da codebase é útil para projetos de software, mas o método também funciona para decisões de produto, operações, contratação, GTM e estratégia. O melhor uso é qualquer plano em que pressupostos ocultos sejam mais perigosos do que falta de polimento no texto.
Por que isso é melhor do que um prompt comum?
Um prompt normal como “critique este plano” geralmente produz uma lista de observações. grill-me cria um ciclo de interrogatório. Cada pergunta está ligada a uma ramificação de decisão, inclui uma resposta recomendada e espera sua resposta antes de continuar. Isso o torna melhor para resolver ambiguidades, não apenas para identificá-las.
Iniciantes podem usar o grill-me?
Sim, mas iniciantes devem começar com um plano curto. O skill pode parecer intenso porque pergunta sobre trade-offs, critérios de descarte e alternativas. Se você ainda não conhece bem o domínio, responda honestamente com o que é desconhecido; a sessão pode então separar “ainda não decidido” de “bloqueado por falta de informação”.
O que devo verificar antes de instalar?
Verifique se o runtime do seu agente oferece suporte a skills do GitHub e se você se sente confortável com um fluxo de múltiplas interações. Também vale pré-visualizar SKILL.md e os três arquivos de referência. Se quiser usar os scripts auxiliares, confirme que consegue rodar comandos locais de Python e que gravar JSON de sessão em ~/.grill_sessions/ é aceitável para o seu ambiente.
Como melhorar o grill-me skill
Dê ao grill-me material de origem mais preciso
A forma mais rápida de melhorar a saída do grill-me é tornar o plano mais inspecionável. Adicione seções para objetivos, não objetivos, restrições, alternativas, dependências, rollout, rollback, métricas e perguntas em aberto. O extrator de decisões procura sinais como “we will”, “TBD”, “vs”, “depends on” e “trade-off”, então uma redação explícita ajuda o fluxo a encontrar ramificações.
Evite modos de falha comuns
Falhas comuns incluem fazer perguntas demais de uma vez, aceitar respostas vagas, pular a exploração da codebase ou parar depois da primeira ramificação desconfortável. Se o agente agrupar perguntas, corrija: “Return to grill-me: one question only, with a recommended answer.” Se ele perguntar algo que já está documentado, aponte para o arquivo e exija que ele inspecione antes de continuar.
Itere depois da primeira sessão
Depois do primeiro grill, revise o plano com as decisões fechadas e os riscos recém-descobertos. Então rode decision_tree_extractor.py novamente. Essa segunda passada muitas vezes encontra novas ramificações introduzidas pelas suas respostas. Uma boa sessão termina com menos TBDs, motivos mais claros para rejeitar alternativas e critérios explícitos de descarte para escolhas arriscadas.
Ajuste o skill para sua equipe
Equipes podem melhorar a adoção adicionando exemplos locais: um bom registro de decisão de arquitetura, um plano vago ruim, categorias de risco preferidas e critérios padrão de lançamento. Mantenha intacta a disciplina central do grill-me, mas adapte o estilo das respostas recomendadas às restrições da sua organização. O objetivo não é fazer perguntas mais duras; é chegar mais rápido a um entendimento compartilhado antes que um trabalho caro comece.