Communitygithub.com

bushnell

Projete a divulgação progressiva que oferece valor imediato para iniciantes e profundidade significativa para usuários experientes. Use para detalhamentos, visualizações em camadas, navegação, painéis e experiências de uso repetido; avalie tanto o primeiro contato quanto o centésimo uso.

O que é bushnell?

O princípio de design Bushnell, inspirado na 'Lei de Bushnell' (fácil de aprender, difícil de dominar), orienta a criação de interfaces que oferecem valor imediato na primeira experiência e recompensas profundas no uso repetido. Esta skill é útil para engenheiros e designers que trabalham em produtos complexos, como painéis analíticos, ferramentas de criação ou navegação hierárquica, onde a profundidade não deve vir de controles desnecessários, mas de uma compreensão mais rica. Ela suporta plataformas web, móveis e desktop, focando em padrões como 'escada de divulgação' (superfície inicial, precisão, investigação, evidências e maquinário interno) e um contrato explícito de interação. O fluxo de trabalho inclui definir as recompensas, mapear perguntas, atribuir conteúdo às camadas e revisar o comportamento do sistema. Evite esconder funcionalidades essenciais, exigir terminologia interna ou substituir o contexto do usuário sem caminhos claros de retorno.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jwexler10/bushnell-skill/tree/HEAD/skills/bushnell

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Bushnell — Valor Imediato, Profundidade Duradoura

Aplique o princípio de design comumente chamado de Lei de Bushnell: fácil de aprender, difícil de dominar. Para um produto, isso significa compreendido em segundos, recompensador ao longo do uso repetido. O domínio deve crescer a partir de uma compreensão mais rica, não da decifração da interface.

Use esta skill para projetar como a profundidade se desdobra. Estabeleça primeiro o propósito do recurso e sua usabilidade básica. Nenhuma skill complementar, biblioteca de componentes ou layout de repositório é necessário.

Defina ambas as recompensas

Recompensa do primeiro contato: o que um novo usuário entende ou ganha nos primeiros segundos, antes de aprender controles ou explorar detalhes. Um gráfico pode tornar uma tendência imediatamente visível; uma ferramenta de criação pode fornecer um resultado inicial útil.

Recompensa do centésimo uso: o que permanece significativo após a familiaridade. Fontes úteis incluem maior precisão, novas relações entre objetos familiares, evidências por trás de uma afirmação, combinações expressivas e mudanças nos dados ou trabalho do próprio usuário.

Não ofereça o mesmo resumo duas vezes em tamanhos diferentes. A camada mais profunda deve responder a uma nova pergunta ou apoiar uma nova ação.

Construa uma escada de divulgação

A superfície inicial responde à pergunta comum. Uma ação explícita e detectável abre uma pergunta menos comum. Escolha a divisão em torno das necessidades do usuário, não de como o backend armazena os dados.

CamadaConteúdo adequadoObrigação de design
Superfície inicialResultado principal, visualização primária, status essencialComunicar valor sem interação exploratória.
Precisão sob demandaValores exatos, definições, comparaçõesSuportar acesso por ponteiro, teclado e toque conforme apropriado; evitar essenciais apenas ao passar o mouse.
InvestigaçãoMembros, exemplos, objetos relacionados, detalhes editáveisTornar o gatilho e seu resultado previsíveis.
Evidência ou métodoFontes, cálculos, incertezas, limitaçõesManter disponível e compreensível sem sobrecarregar a tarefa principal.
Maquinário internoPontuações e identificadores apenas de implementaçãoExpor apenas se ajudar na tarefa do usuário, com rótulos significativos.

Estes são papéis, não widgets obrigatórios. Recolher uma seção não cria profundidade por si só; ajuda apenas quando o conteúdo inicial é útil e o conteúdo revelado responde a uma pergunta de acompanhamento significativa.

Aplique o princípio recursivamente

Um recurso com várias camadas ainda precisa de um ponto de entrada compreensível e um motivo para explorar. Por exemplo:

visão geral -> selecionar um grupo -> inspecionar um membro -> inspecionar evidências de apoio

Cada transição deve adicionar compreensão enquanto preserva a orientação. Mais curiosidade pode ser necessária; mais conhecimento da interface não deve ser.

A profundidade vem de relações significativas entre alguns elementos compreensíveis, não do número de painéis, controles ou termos inventados. A gramática visual de um diagrama não deve implicar uma relação, como causalidade, que a evidência não pode sustentar.

Torne o contrato de interação explícito

  • Resolva gestos concorrentes. Defina o que seleção, arrasto, cliques em fundo, pesquisa e navegação fazem quando coexistem. Evite ativação acidental.
  • Preserve o contexto. Uma camada mais profunda deve reter o pai ou oferecer uma maneira óbvia de voltar com o estado relevante intacto. Use painéis adjacentes, migalhas de pão, uma pilha ou outro padrão apropriado para o dispositivo e a tarefa.
  • Responda à pergunta que foi feita. Selecionar um item dentro de um grupo deve explicar esse item naquele contexto. Ofereça seu histórico mais amplo como um caminho separado.
  • Reutilize contêineres estabelecidos. Adicione um novo assunto a um padrão de detalhe existente antes de introduzir outro sistema de navegação.
  • Revele deliberadamente. Evite chamadas permanentes que dominam a superfície para responder a uma pergunta incomum.
  • Dobre honestamente. Indique contagens ou escopo omitidos. Expandir uma lista não deve mudar silenciosamente o significado ou a escala das informações já mostradas.
  • Torne a recuperação visível. Forneça fechar, voltar, redefinir ou desfazer quando relevante. Preserve ajustes deliberados do usuário, a menos que ele escolha redefini-los.

Adapte o layout exato e os gestos às necessidades de acessibilidade e ao espaço disponível. Um arranjo de desktop não é um requisito para uma tela pequena.

Projete o comportamento que o sistema cria

Pergunte o que as pessoas farão, não apenas o que o recurso permite:

CapacidadeComportamento a verificar
Pontos de dados clicáveisInvestigação proposital, em vez de abertura aleatória de painéis.
PesquisaOrientação, em vez de navegação indesejada ou mudanças de estado.
Arrasto, panorâmica e zoomUma visão mais clara com uma rota confiável de volta.
Múltiplas camadas de detalhesAcumulação de compreensão enquanto retém contexto.
CustomizaçãoControle útil sem tornar a configuração um pré-requisito.
Navegação profundaConfiança de que o usuário pode retornar sem perder seu trabalho.

Quando o uso real contradiz o comportamento pretendido, revise o design. Recuperação e continuidade são condições que tornam a exploração possível.

Torne ideias desconhecidas legíveis

Nomeie o referente em vez de uma unidade interna: prefira "1,4 vezes seu total semanal habitual" em vez de uma pontuação não explicada. Mantenha um adjetivo conectado à quantidade e comparação que o sustentam. Defina termos desconhecidos onde são necessários.

Indique quando a evidência é escassa. Não preencha uma lacuna com uma conclusão não fundamentada. A explicação gerada opcional não deve bloquear um resultado de outra forma útil; o trabalho necessário deve ainda comunicar progresso, falha e recuperação honestamente.

Fluxo de trabalho

  1. Localize o recurso na jornada geral do usuário. Identifique quem o encontra e o que já sabe. Inspecione o produto ou código existente quando disponível.
  2. Escreva sua recompensa de primeiro contato e recompensa de centésimo uso, uma frase cada.
  3. Mapeie a ação primária, a pergunta que ela abre e o próximo passo útil.
  4. Atribua conteúdo à escada de divulgação. Remova resumos duplicados e controles que adicionam aprendizado sem adicionar valor.
  5. Especifique preservação de contexto, prioridade de gestos, acesso acessível e recuperação.
  6. Use padrões de implementação estabelecidos quando a implementação for solicitada.
  7. Revise uma vez como novato e uma vez como usuário recorrente. Verifique o comportamento, bem como se os controles funcionam tecnicamente.

Para uma visão geral, favoreça valor imediato e uma rota clara para material mais rico. Para um recurso de profundidade média, organize-se em torno das perguntas do usuário. Para evidências por trás de uma afirmação, priorize proveniência, escopo, incerteza e o caminho de volta.

Evite

  • Uma superfície que não diz nada até ser operada.
  • Esconder funcionalidade essencial ou acessibilidade por trás de descoberta.
  • Adicionar controles, gráficos ou configurações e chamar o resultado de profundidade.
  • Exigir terminologia interna para entender resultados comuns.
  • Substituir o pai tão completamente que o usuário perde a pergunta que fez.
  • Tratar distintivos, sequências ou desbloqueios artificiais como substitutos para valor significativo.
  • Impor limites ou layouts específicos do produto sem verificar o contexto atual.

Na entrega, nomeie as duas recompensas e o caminho de descoberta. Escalone a explicação para a tarefa e apoie afirmações sobre o produto atual com observações reais ou referências de código.

Habilidades Relacionadas