iamk3nnyt/claude-skills

Transforma uma ideia de funcionalidade em uma especificação de uma página cobrindo problema, público, escopo MVP, não-objetivos, critérios de aceitação numerados (Given/When/Then), rotas afetadas, dados, e-mails e perguntas em aberto. Use quando o usuário disser "brief", "especificar", "definir escopo" ou "o que seria necessário", ou antes de iniciar uma funcionalidade cujo escopo não esteja claro.

O que é claude-skills?

Este skill transforma uma ideia de funcionalidade em uma especificação concisa de uma página, seguindo um template rigoroso. Ele é útil para desenvolvedores e agentes de IA (como Claude Code, Cursor, Codex) que precisam elaborar rapidamente um documento de escopo antes de implementar uma funcionalidade. O skill primeiro examina silenciosamente o CLAUDE.md do repositório, as entradas de memória e os arquivos de rota, esquema e e-mail relevantes para fornecer referências precisas. Em seguida, aplica regras de escopo (MVP mínimo com componentes existentes, sem adicionar o que não foi solicitado) e gera um brief com seções obrigatórias: problema, público, MVP, não-objetivos, critérios de aceitação (Given/When/Then numerados), rotas/tabelas/e-mails afetados, riscos e perguntas em aberto com valores padrão. O resultado é exibido no chat ou, se solicitado, salvo em `docs/briefs/<slug>.md`.

Funciona com✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/iamk3nnyt/claude-skills/tree/HEAD/skills/brief

Documentação

brief

Funcionalidade: $ARGUMENTS

Primeiro, contextualize (silenciosamente)

Leia o CLAUDE.md do repositório e as entradas de memória deste projeto. Dê uma olhada nas rotas, no esquema e nos templates de e-mail que a funcionalidade toca. As especificações devem citar caminhos de arquivo reais e campos existentes.
Entreviste apenas se uma decisão puder alterar o escopo. Faça uma pergunta por vez usando AskUserQuestion com uma opção recomendada e limite-se a no máximo 3 perguntas. Qualquer outra coisa vira uma suposição em Perguntas em aberto.

Regras de escopo

MVP significa o mínimo convencional, construído com campos e componentes existentes. "Como qualquer e-commerce" significa o fluxo padrão, não uma plataforma.
Nunca adicione componentes, configurações, telas de administração ou análises que não foram solicitados. Liste-os em Não-objetivos.
Funcionalidades de parceiros ou APIs: "chave de API" geralmente significa um ID de locatário em variável de ambiente, não um portal do desenvolvedor.
Respeite as restrições do projeto do CLAUDE.md/memória (ex.: "sem alterações no esquema"). Sinalize qualquer coisa que viole uma restrição.

Template

# <Funcionalidade>: brief
**Problema:** uma ou duas frases, a dor do usuário, não a solução.
**Para:** quem, e quantos (se conhecido, cite a consulta ou fonte).
**MVP:** 3–6 tópicos, cada um entregável e observável.
**Não-objetivos:** o que estamos explicitamente não fazendo agora.
**Critérios de aceitação**
1. Dado <estado>, quando <ação>, então <resultado observável>.
2. … (cada um testável via flow-check, smoke ou teste unitário)
**Toca em:** rotas · tabelas/campos (priorize os existentes) · e-mails · env/segredos · terceiros
**Riscos:** dinheiro, legal/GDPR, entregabilidade, SEO (noindex/canonical), i18n
**Perguntas em aberto:** numeradas; cada uma com meu valor padrão se não respondida

Saída

Por padrão, no chat. Escreva docs/briefs/<slug>.md apenas se solicitado.
Uma frase de introdução ("Brief abaixo: N critérios, M perguntas em aberto"), seguida pelo brief. Nada depois.

Critérios de saída

Cada critério de aceitação é observável e mapeia para uma verificação (etapa de flow-check, expectativa de smoke ou teste).
Nada no MVP que não foi solicitado ou não é estritamente necessário para o que foi solicitado.
Perguntas em aberto têm um valor padrão, permitindo que a construção comece sem esperar.