hig-foundations

Visão geral da skill hig-foundations

hig-foundations é a skill de fundamentos do Apple Human Interface Guidelines para decisões iniciais de design que afetam clareza, acessibilidade e aderência ao sistema. Use a skill hig-foundations quando precisar de orientação prática sobre cor, tipografia, símbolos, materiais, motion, privacidade, layout, RTL ou design inclusivo para plataformas Apple. Ela é ideal para UI designers, times de produto e agentes que precisam transformar uma ideia de interface ainda crua em escolhas de design alinhadas ao Apple sem chutar.

Para que serve a hig-foundations

Esta skill ajuda a responder “como isso deve parecer e se comportar?” antes de você avançar para telas, componentes ou padrões da plataforma. Ela é especialmente útil quando o problema é estrutural: contraste no modo escuro, suporte a Dynamic Type, uso de cores do sistema, escolha de fonte ou fazer ícones parecerem nativos. Se o objetivo é alinhar um recurso ao Apple HIG em vez de inventar uma linguagem visual própria, a hig-foundations é o ponto de partida certo.

Quando ela é a melhor opção

Use hig-foundations para UI Design quando você precisa de decisões que se aplicam ao app inteiro, e não só a uma tela. Ela se encaixa em casos como estilização de marca em dispositivos Apple, sistemas visuais com foco em acessibilidade e revisões de fundamentos para specs de produto ou prompts de design. Ela é menos útil se você já precisa de um padrão de interação específico ou de detalhe de implementação da plataforma.

Principais diferenciais

O valor da hig-foundations está em levar você para padrões do sistema e escolhas sensíveis à acessibilidade, em vez de palpites de design decorativo. A skill também aponta para áreas relacionadas do HIG por meio de referências cruzadas, o que permite sair de fundamentos e chegar a plataformas, padrões ou componentes sem recomeçar do zero. Isso torna o guia hig-foundations mais útil do que um prompt genérico de “siga o estilo da Apple”.

Como usar a skill hig-foundations

Instale e prepare a skill

Instale com npx skills add raintree-technology/apple-hig-skills --skill hig-foundations. Para melhores resultados, use em um fluxo em que o agente possa inspecionar o arquivo da skill e o contexto próximo antes de rascunhar recomendações. A instalação da hig-foundations funciona melhor quando você mantém à mão seu objetivo de produto, plataforma alvo e restrições de acessibilidade para compartilhar.

Dê à skill a entrada certa

Um prompt fraco diz: “Deixe isso com cara de Apple.” Um prompt mais forte diz: “Aplique hig-foundations a esta tela de onboarding no iOS: use cores do sistema, suporte a Dynamic Type, mantenha o motion mínimo e garanta que o CTA continue legível no modo escuro.” Inclua a plataforma, o público, as restrições de design já existentes e qualquer problema conhecido, como contraste, desalinhamento de ícones ou layout RTL. Quanto mais concreto estiver o estado atual, menos a skill precisa inferir.

Leia a fonte nesta ordem

Comece por SKILL.md, porque é ali que estão as regras centrais de decisão e as referências cruzadas. Depois, verifique qualquer contexto de repositório mencionado na skill, especialmente README.md, AGENTS.md, metadata.json e pastas de apoio, se existirem. Neste repositório, o principal sinal prático está na própria orientação dentro de SKILL.md, então uma leitura rápida desse arquivo normalmente já mostra se o uso da hig-foundations combina com sua tarefa.

Fluxo de trabalho que gera melhores resultados

Use a skill em três etapas: defina o problema de UI, restrinja-o com requisitos de plataforma e acessibilidade e, então, peça uma recomendação ou reescrita. Por exemplo: “Revise esta página de ajustes no iPad segundo a hig-foundations e sugira mudanças de cor, hierarquia e clareza dos alvos de toque.” Isso dá ao modelo uma superfície de design concreta para avaliar, em vez de obrigá-lo a inventar uma do zero. Se você estiver trabalhando a partir de copy ou wireframe, inclua os dois; a orientação de fundamentos melhora quando texto e layout são analisados juntos.

Perguntas frequentes sobre a skill hig-foundations

A hig-foundations é só para designers?

Não. A skill hig-foundations é útil para designers, PMs, frontend engineers e agentes que precisam de direção de UI alinhada à Apple. Se você escreve tickets de implementação ou revisa texto de interface, ela também ajuda, porque muitos problemas de fundamentos afetam o código tanto quanto o visual.

Em que ela é diferente de um prompt genérico?

Um prompt genérico pode mencionar o estilo Apple, mas a hig-foundations oferece um enquadramento reutilizável de decisão para fundamentos como cores do sistema, acessibilidade e hierarquia visual. Isso normalmente reduz respostas vagas e torna o guia hig-foundations mais confiável para uso repetido em telas ou recursos. Ainda assim, ela não substitui o contexto de produto, mas é mais disciplinada do que pedir “melhor design” em linguagem comum.

Quando não devo usar esta skill?

Não use a hig-foundations se você precisa de um padrão de interação muito específico, de uma decisão de biblioteca de componentes ou de uma análise profunda de implementação da plataforma. Nesses casos, uma skill mais focada ou um guia direto da plataforma será mais rápido. Evite também quando o design já segue as convenções da Apple e você só precisa de pequenos ajustes de texto.

Ela é amigável para iniciantes?

Sim, desde que você consiga descrever a tela do produto e o problema que quer resolver. Você não precisa conhecer todos os termos do HIG antes. O melhor uso da hig-foundations vem de prompts simples e explícitos, que nomeiam o dispositivo, o problema e o conjunto de restrições.

Como melhorar a skill hig-foundations

Dê restrições de design mais precisas

O maior salto de qualidade vem de dizer o que não pode mudar: cor da marca, layout atual, idiomas suportados ou metas mínimas de acessibilidade. Por exemplo: “Mantenha a estrutura atual, mas deixe a hierarquia mais parecida com a Apple, preserve o tom de destaque da marca e passe no contraste do modo escuro.” Isso permite que a skill se concentre nos trade-offs em vez de repetir conselhos óbvios.

Peça decisões, não princípios genéricos

A hig-foundations é mais forte quando você pede que ela escolha. Prefira prompts como “quais cores do sistema fazem sentido para este card de status?” ou “este motion deve ser reduzido ou removido?” em vez de “explique acessibilidade”. Decisões concretas geram respostas que você pode aplicar na hora e revisar rápido.

Itere a partir do primeiro rascunho

Depois da primeira resposta, restrinja o escopo para o ponto mais fraco: tipografia, contraste, iconografia ou densidade do layout. Dê o retorno com a falha específica, como “o CTA está dominante demais” ou “o conteúdo ainda está apertado demais para Dynamic Type”. Iterar funciona bem com hig-foundations porque problemas de fundamentos costumam ser mais fáceis de corrigir camada por camada.