Communitygithub.com

coastdigitalgroup/coastai-skills

Projete e implemente um framework sistemático para interfaces de descoberta de conteúdo, definindo a organização visual e espacial de filtros, facetas e controles de ordenação para maximizar a encontrabilidade e reduzir a carga cognitiva.

O que é coastai-skills?

Este skill fornece uma metodologia completa para projetar interfaces de descoberta que ajudam usuários a navegar em grandes conjuntos de dados ou catálogos de produtos. Ele se concentra na composição espacial e nas affordances visuais das ferramentas de descoberta, garantindo que os usuários possam refinar facilmente sua visualização, entender seu estado atual de filtragem e alternar entre modos de priorização (ordenação) sem perder contexto ou se sentir sobrecarregados. O skill abrange casos de uso como e-commerce, mecanismos de busca e navegação facetada, e também define claramente quando não deve ser usado (por exemplo, para conjuntos de dados pequenos ou fluxos de trabalho lineares). Ele fornece entradas como um inventário de facetas, classificação de prioridade e tipos de controle, e gera saídas como um blueprint de layout de descoberta, especificações de componentes de faceta, um mapa de estado e uma estratégia responsiva. O fluxo de trabalho inclui a seleção de um padrão de layout primário, definição da hierarquia visual de facetas, design do sistema de estado ativo, estabelecimento de affordances de ordenação e planejamento para descoberta móvel. Regras de decisão como a regra 80/20 e restrições de acessibilidade e responsividade são incluídas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/filter-and-sort-system

Perguntar na sua IA favorita

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

Documentação

Sistema de Filtro e Ordenação

Propósito

O Sistema de Filtro e Ordenação fornece uma metodologia para projetar interfaces de descoberta que ajudam os usuários a navegar por grandes conjuntos de dados ou catálogos de produtos. Enquanto a implementação técnica lida com a lógica, este sistema define a composição espacial e as affordances visuais das ferramentas de descoberta. Ele garante que os usuários possam refinar facilmente sua visualização, entender seu estado atual de filtragem e alternar entre modos de priorização (ordenação) sem perder contexto ou se sentir sobrecarregados.

Casos de Uso

  • Projetar a camada de descoberta na barra lateral ou barra superior para sites de e-commerce.
  • Organizar páginas de resultados de pesquisa complexas (SERPs) para diretórios ou hubs de recursos.
  • Implementar "Gavetas de Descoberta" para interfaces de aplicativos mobile-first.
  • Criar navegação facetada para documentação rica em conteúdo ou arquivos de blog.

Quando NÃO Usar

  • Conjuntos de Dados Pequenos (<12 itens): Se todo o conteúdo cabe em uma única visualização, adicionar filtragem e ordenação introduz custo de interação desnecessário.
  • Fluxos de Trabalho de Caminho Único: Onde o usuário deve seguir uma sequência linear em vez de explorar um catálogo.
  • Tabelas de Dados Brutos: Onde os usuários provavelmente usarão a função "Localizar" nativa do navegador ou ferramentas avançadas semelhantes a planilhas (embora a ordenação de alto nível ainda ajude).

Entradas

  1. Inventário de Facetas: Uma lista de todos os atributos pelos quais os usuários podem filtrar (ex.: Tamanho, Cor, Classificação, Preço).
  2. Classificação de Prioridade: Quais facetas são "Primárias" (usadas por 80% dos usuários) vs. "Secundárias" (especificações de nicho).
  3. Tipos de Controle: Mapeamento de tipos de dados para controles de IU (ex.: Caixas de seleção para seleção múltipla, Controles deslizantes de intervalo para preço).
  4. Contexto de Layout: O espaço horizontal e vertical disponível (do responsive-grid-system).

Saídas

  1. Blueprint de Layout de Descoberta: Posicionamento definido para a barra de filtros (Barra Lateral vs. Barra Superior) e a grade de resultados.
  2. Especificação de Componente de Faceta: Design visual para caixas de seleção, amostras de cor e entradas de intervalo dentro do contexto de descoberta.
  3. Mapa de Estado: Tratamentos visuais para Filtros Ativos (pílulas/tags), Estados de Carregamento (esqueletos) e Estados Vazios.
  4. Estratégia Responsiva: Um plano de como os filtros se transformam do Desktop (ex.: Barra Lateral) para o Mobile (ex.: Gaveta Inferior).

Fluxo de Trabalho

1. Selecione o Padrão de Layout Primário

Escolha um arranjo espacial com base no número de facetas:

  • Barra Lateral (Esquerda/Direita): Melhor para 5+ facetas. Fornece alta visibilidade e acesso persistente às ferramentas de descoberta.
  • Barra Superior Horizontal: Melhor para 1–4 facetas. Maximiza a largura para resultados, mas pode ficar desordenada se mais facetas forem adicionadas posteriormente.
  • Sobreposição/Gaveta: Melhor para mobile ou interfaces desktop "limpas" onde a descoberta é uma tarefa secundária.

2. Defina a Hierarquia Visual das Facetas

Aplique os princípios de visual-hierarchy-system à lista de filtros:

  • Cabeçalhos de Grupo: Use títulos concisos e em negrito (ex.: Categoria, Marca).
  • Dimensionamento de Controles: Garanta que caixas de seleção e links de texto tenham ritmo vertical suficiente (geralmente espaçamento --space-s).
  • Expandido vs. Recolhido Inicialmente: Expanda as 3 facetas mais usadas; recolha as demais para economizar espaço vertical.

3. Projete o Sistema de "Estado Ativo"

Os usuários devem sempre saber quais filtros estão aplicados:

  • Sumarização (Pílulas/Tags): Coloque uma lista horizontal de filtros ativos acima dos resultados ou no topo da barra lateral.
  • Limpar Tudo: Forneça uma ação única e proeminente para redefinir toda a visualização.
  • Feedback Visual: O contêiner de resultados deve indicar que está "atualizando" (ex.: opacidade de 20% ou uma tela esqueleto) quando um filtro é alternado.

4. Estabeleça Affordances de Ordenação

Diferencie entre inclusão (Filtragem) e priorização (Ordenação):

  • Posicionamento: Mantenha a ordenação no canto superior direito ou superior esquerdo da área de resultados, separada dos filtros.
  • Rotulagem: Use rótulos claros como "Ordenar por: Preço (Menor para Maior)" em vez de apenas "Preço".

5. Planeje para Descoberta Móvel

  • O Gatilho de Descoberta: Use um botão fixo (ex.: "Filtrar e Ordenar") na parte inferior ou superior da tela.
  • O Padrão de Gaveta: Abra filtros em uma gaveta de tela cheia ou inferior para maximizar o tamanho do alvo de toque.
  • Imediato vs. Lote: Decida se a visualização móvel deve atualizar instantaneamente (Facetada) ou exigir um botão "Mostrar X Resultados" para aplicar.

Regras de Decisão

  • A Regra "80/20": Mostre apenas os 5 principais valores para qualquer faceta; use um link "Mostrar Mais" para revelar o restante.
  • Barra Lateral vs. Barra Superior: Se sua lista de facetas exigir rolagem em uma tela de laptop padrão, use uma Barra Lateral. Se couber em uma linha, use uma Barra Superior.
  • Persistência de Seleção: Os filtros aplicados devem permanecer visíveis mesmo se forem rolados para fora da barra lateral (ex.: usando uma barra de pílulas fixa).
  • Fallback de Estado Vazio: Nunca permita que uma combinação de filtros leve a um beco sem saída; forneça sempre um botão "Redefinir" ou alternativas sugeridas.

Restrições

  • Acessibilidade: Todos os controles de filtro devem ter anéis de foco visíveis e ser operáveis via teclado. Use aria-expanded para facetas colapsáveis e aria-live="polite" no contêiner/contagem de resultados para que usuários de leitores de tela saibam quando os resultados foram atualizados.
  • Responsividade: Os filtros devem ser empilhados ou movidos para uma gaveta no mobile para evitar estouro horizontal ou "compressão" da grade de conteúdo. Prefira consultas de contêiner a breakpoints de viewport quando a barra de filtros puder aparecer em mais de um contexto de layout (ex.: barra lateral vs. widget embutido).
  • Contraste: Garanta que os estados ativo/selecionado (ex.: uma caixa marcada ou uma pílula azul) atendam à taxa de contraste de 3:1 em relação ao fundo.

Padrões Comuns de Falha

  • O "Filtro Misterioso": Os usuários não conseguem identificar quais filtros estão ativos porque não há barra de pílulas/tags de resumo.
  • A "Barra Lateral Infinita": Uma barra lateral tão longa que se torna uma tarefa gerenciar, geralmente causada por não usar "Mostrar Mais" para listas longas.
  • Compactação Móvel: Tentar encaixar uma barra lateral de desktop em uma visualização móvel, tornando a grade de resultados ilegível.
  • Falta de Feedback "Aplicado": Alternar um filtro sem que a grade de resultados indique visualmente uma mudança (mesmo que a mudança seja rápida).
  • O Beco Sem Saída: Filtrar até zero itens e não fornecer maneira de voltar.

Critérios de Validação

  • Existe uma distinção clara entre Filtragem (inclusão) e Ordenação (priorização).
  • Os filtros ativos são resumidos visualmente (ex.: pílulas/tags).
  • As facetas mais usadas são expandidas por padrão; as outras são colapsáveis.
  • Uma ação "Limpar Tudo" ou "Redefinir" está facilmente acessível.
  • O sistema fornece um padrão de descoberta específico para mobile (ex.: Gaveta).
  • Estados de carregamento (esqueletos/spinners) são definidos para quando os resultados são atualizados.
  • Todos os controles atendem ao tamanho mínimo de alvo de toque (24x24px por WCAG 2.2 SC 2.5.8, sendo 44x44px preferível) e aos requisitos de acessibilidade por teclado.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Habilidades Relacionadas