hig-patterns

Visão geral do skill hig-patterns

hig-patterns é um skill de padrões do Apple Human Interface Guidelines para decidir como interações comuns de apps devem se comportar no iOS, iPadOS e em outras experiências da Apple. Ele é mais útil quando você precisa de uma resposta defensável para dúvidas como se deve usar um modal, como o onboarding deve fluir, como mostrar carregamento ou quando oferecer desfazer em vez de confirmação.

Para que o hig-patterns serve

O hig-patterns skill ajuda a mapear um objetivo de produto para o padrão de interação certo, e não apenas a gerar texto de interface. Ele é voltado para designers de produto, engenheiros e agentes de IA que precisam tomar decisões de UX alinhadas à Apple sob pressão de tempo.

Tarefas em que ele funciona melhor

Use hig-patterns ao desenhar ou revisar onboarding, busca, configurações, permissões, notificações, multitarefa, arrastar e soltar, compartilhamento, gerenciamento de arquivos ou estados de feedback. Ele é especialmente relevante para hig-patterns for UI Design quando você já conhece a área do recurso, mas precisa definir o modelo de interação.

O que o diferencia

Este skill é opinativo na seleção de padrões do Apple HIG: minimiza a modalização, dá feedback imediato, prioriza desfazer e escolhe o controle menos intrusivo que ainda funcione para a tarefa. Ele fala menos de estilo visual e mais de escolha de interação, que costuma ser o que trava as boas decisões de UX para Apple.

Como usar o skill hig-patterns

Instale e ative

Use o fluxo hig-patterns install no seu gerenciador de skills, ou instale a partir de raintree-technology/apple-hig-skills com o comando padrão de skills do repositório, se o seu ambiente oferecer suporte. Depois de instalado, direcione o modelo para a tarefa e para o contexto da plataforma Apple e peça a recomendação de padrão, em vez de uma crítica genérica de UI.

Envie a entrada certa

Um prompt forte de hig-patterns usage inclui: plataforma, objetivo do usuário, fluxo atual, o que está falhando e qualquer restrição como não poder adicionar telas, necessidade de funcionar offline ou risco de ação destrutiva. Exemplo: “Desenhe o melhor padrão Apple HIG para excluir uma nota sincronizada no iPhone quando os usuários costumam errar por toque e precisam de um caminho rápido de recuperação.”

Leia estes arquivos primeiro

Comece com skills/hig-patterns/SKILL.md e depois verifique .claude/apple-design-context.md, se ele existir no seu workspace. O corpo do skill é curto e autocontido, então não há pastas auxiliares para explorar; o principal valor está nas regras de padrão e nas referências cruzadas para skills HIG adjacentes.

Fluxo de trabalho que gera melhores resultados

Use este fluxo de hig-patterns guide: descreva a tarefa, peça o padrão recomendado, valide-o contra as restrições da Apple e depois pergunte sobre casos-limite e comportamento de fallback. Se você já tiver uma UI proposta, peça ao skill para avaliar se ela está modal demais, pouco informativa demais ou sem feedback.

Perguntas frequentes sobre o skill hig-patterns

O hig-patterns é só para design para Apple?

Sim. hig-patterns foi criado para decisões de interação em plataformas Apple, então funciona melhor quando o resultado precisa seguir o Apple HIG e não padrões genéricos de web ou Android.

Como ele se compara com um prompt comum?

Um prompt comum pode gerar uma boa ideia, mas hig-patterns oferece um enquadramento de decisão mais preciso: quando usar uma sheet em vez de alert, como lidar com progresso, quando desfazer é melhor que confirmação e qual nível de interrupção é justificável. Isso normalmente reduz idas e vindas e conselhos vagos.

É amigável para iniciantes?

Sim, desde que você consiga descrever a tarefa do usuário de forma clara. Você não precisa dominar o HIG para usá-lo, mas a qualidade depende de quão claramente você informa plataforma, ação e nível de risco.

Quando eu não devo usar?

Não use hig-patterns se você precisa de branding visual, código de biblioteca de componentes ou orientação de UX agnóstica de plataforma. Ele é um skill de seleção de padrões, então é menos útil quando a pergunta real é implementação de layout ou tokens de design system.

Como melhorar o skill hig-patterns

Traga a decisão, não só o recurso

As melhores entradas dizem qual escolha está travando você: “modal ou inline”, “confirmar exclusão ou desfazer”, “spinner ou barra de progresso” ou “permissão agora ou depois”. Isso gera um hig-patterns usage melhor do que pedir uma revisão geral de design.

Inclua o modo de falha

Mencione o que pode dar errado no fluxo: toques acidentais, esperas longas, erros repetidos, dados sensíveis ou incerteza do usuário. hig-patterns funciona melhor quando consegue ponderar interrupção, recuperabilidade e feedback entre si.

Peça restrições e trade-offs

Se a recomendação precisar caber em uma tela já existente, em um fluxo curto ou em um requisito de acessibilidade, diga isso logo de início. O skill é mais útil quando consegue explicar por que um padrão Apple é preferível dentro dessas restrições, em vez de listar várias opções.

Itere com um follow-up mais específico

Depois da primeira resposta, refine com um caso-limite concreto: “E se a ação for destrutiva, mas reversível?” ou “Como isso deve funcionar no iPad com multitarefa?”. Essa é a forma mais rápida de transformar uma boa resposta de hig-patterns guide em um padrão pronto para implementação.