Communitygithub.com

lidge-ai/ima2-gen

Descoberta de direção de design e julgamento de UX para usuários do ima2. Use para direção de UI/UX e julgamento de design — briefs visuais vagos, onboarding, estados de vazio/erro/carregamento, vocabulário de layout, quebras de tipografia, favicons, logos e escolhas de identidade de marca. Pareia com ima2-front: esta skill decide a direção de design, depois carregue ima2-front para implementá-la. Gatilhos: make it look good, modern, clean, aesthetic, onboarding, empty state, error state, favicon, logo, design system, 깔끔하게, 모던하게, 감성적으로.

O que é ima2-gen?

Esta skill, ima2-gen, é especializada em descoberta de intenção de design e julgamento de UX para o ecossistema ima2. Ela traduz briefs visuais vagos — como 'make it look good', 'moderno' ou '깔끔하게' — em direções de design acionáveis, abrangendo desde estados de UX (onboarding, vazio, erro, carregamento) até elementos de identidade de marca como favicons, logos e vocabulário de layout. Projetada para ser usada em conjunto com a skill ima2-front (que implementa o design), ela fornece um framework estruturado para descoberta de intenção, incluindo um protocolo de ambiguidade compacto (UX-INTENT-01) e um portfólio de referências modulares sobre movimentos de design, personalidades de produto, sistemas de cor, tipografia e muito mais. A skill impõe regras rigorosas (STYLE_SAMPLE, UX-LAZY-01, UX-STATE-01) para garantir que as decisões de design sejam fundamentadas em correção de UX, e não apenas em estética, e inclui um gate preguiçoso para minimizar a carga cognitiva do usuário. Ela é ideal para desenvolvedores e designers que usam agentes de IA como Claude Code, Cursor ou Codex para gerar direção de design e depois implementar com ima2-front.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lidge-ai/ima2-gen/tree/HEAD/skills/ima2-uiux

Perguntar na sua IA favorita

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

Documentação

ima2 UI/UX: Descoberta de Intenção, Padrões e Vocabulário de Produto

Configuração

npm install -g ima2-gen    # instalar globalmente (Node.js >= 20)
ima2 setup                 # autenticação inicial (GPT OAuth recomendado)
ima2 serve                 # iniciar servidor local
ima2 ping                  # verificar
ima2 status                # status da configuração e OAuth

Bootstrap do agente: Execute ima2 ping primeiro. Se inalcançável: ima2 serve &. Se não instalado: npm install -g ima2-gen && ima2 setup. Use ima2 skill path para localizar skills; leia ../ima2-uiux/SKILL.md (este arquivo) para direção de design, ../ima2-front/SKILL.md para ativos de implementação.

Ativa-se pela superfície de mudança quando:

  • A direção de design do usuário é vaga ("깔끔하게", "모던하게", "apenas faça ficar bonito")
  • Está construindo UI de onboarding, estado vazio, estado de erro ou estado de carregamento
  • O usuário referencia uma estética de produto ("estilo Notion", "como o Linear")
  • Está iniciando um novo sistema de design ou gerando uma paleta de cores
  • Está escolhendo padrões de layout ou arquitetura de navegação
  • Está configurando favicons, logos de produto ou elementos de identidade de marca
  • Está lidando com variantes de modo escuro de logotipo, imagens OG ou meta de compartilhamento social

Leia isto antes de referências específicas de estilo quando o usuário não conseguir articular uma direção de design clara. Para detecção e padrões banidos, consulte ima2 skill front ref anti-slop, especialmente o orçamento de gradiente de 2026 e a proibição de temas monótonos.

Proibição de emoji (stub): sem emoji como elementos visuais de UI (RIGOROSO). Regra canônica, escopo e isenções: ima2-front §5 / ima2 skill front ref anti-slop § Emoji Slop.

Separação de papéis: Esta skill é responsável pelo julgamento de design: descoberta de intenção, arquitetura da informação, significado do estado de UX, direção de tipografia/cor/layout, personalidade do produto, vocabulário de marca, julgamento de padrões anti-slop e decisões de sistema de design. ima2-front é responsável pela implementação: HTML/CSS/componentes, mecânicas responsivas, fiação de acessibilidade, comportamento em tempo de execução e verificação renderizada. Após escolher a direção de design aqui, carregue ima2-front para implementação concreta.

Evidências de design externas/atuais: Para alegações de referência de produto ao vivo, documentação atual do sistema de design, comportamento da API do navegador, orientação de acessibilidade que pode ter mudado, ou evidência de fonte renderizada pelo navegador, pesquise na web e siga suas regras de reescrita de consulta, busca de fonte e status de evidência. Use busca no navegador/abrir/obter-texto/obter-dom/instantâneo apenas após existirem URLs candidatos.

Trabalho C0/C1 (pequenos patches locais): Para patches pequenos, pule a cadeia de referência completa.

Nota de classe de regra (UX-STYLE-01): Tudo nesta skill que expressa gosto — personalidades de produto, design-ismos, tokens predefinidos, vocabulário estético — é STYLE_SAMPLE: exemplos para se inspirar, nunca requisitos universais. Correção objetiva de UX (cobertura de estado, acessibilidade, legibilidade) é de responsabilidade do ima2-front §1.5 e permanece RIGOROSA/PADRÃO.

Referências Modulares

Recomendado: instale skills no diretório de skills do seu agente.

ima2 skill install --dir <caminho-da-skill-do-agente>   # o agente fornece seu próprio caminho
ima2 skill install --tmp                                 # fallback efêmero

O agente determina seu próprio diretório de skills e o passa via --dir. Após a instalação, SKILL.md e references/ estão no disco para leitura nativa.

Leitura ad-hoc (sem instalação):

ima2 skill uiux refs              # lista todos os módulos de referência com contagem de linhas
ima2 skill uiux ref design-isms   # imprime um módulo (correspondência de nome base)
ArquivoQuando LerO Que Abrange
references/design-isms.mdO usuário nomeia um estilo/movimento16 movimentos de design com assinaturas CSS, incl. kit padrão Liquid Glass + Liquid Editorial (2025-2026) + AI Serif Editorial + Organic Capsule (verificado em 2026-07-09)
references/design-award-sources.mdProcurando referências de design reaisGuia de sourcing em camadas: sites de premiação e galeria, para que cada um é melhor e como pesquisar
references/compositional-patterns.mdCompondo herói, navegação, movimento ou estrutura de conteúdoPadrões composicionais canônicos de pesquisa de premiação com portões de responsividade e acessibilidade
references/design-trends.mdVerificando prevalência datada, técnicas emergentes ou status de promoçãoInstantâneo de frequência de eixo de 2026-07-14, sinais de técnica, livro de assinaturas e protocolo de recaptura
references/design-read-example.mdAprendendo ou revisando o formato Design ReadExemplo preenchido de Design Read + configuração de dial
references/product-personalities.mdO usuário referencia um produto10 perfis de DNA de produto com tokens exatos, incl. pastel de produto AI 2026 + quente-sans orgânico OpenAI + serifado livresco Anthropic
references/layout-macrostructures.mdEscolhendo layout de página/componenteLayouts de componente + composições de nível de página
references/ux-states.mdConstruindo qualquer UI com estadoOnboarding, vazio, erro, carregamento, divulgação progressiva
references/color-system.mdGerando cores/paletaGeração de paleta baseada em OKLCH, orçamento de matiz, neutros matizados, modo escuro, acessibilidade
references/design-system-bootstrap.mdNovo projeto / sistema de designArquitetura de tokens, hierarquia de componentes, formato DESIGN.md (google-labs-code/design.md)
references/responsive-nav.mdTrabalho responsivo ou de navegaçãoBreakpoints, consultas de contêiner, padrões de navegação por densidade
references/ux-preflight.mdAntes da entregaLista de verificação de verificação de estado de UX
references/typography-line-breaks.mdSempre para UI com muito textoQualidade de quebra de título, categoria de descritor curto (subtítulo de herói, descrição de card — use balance não pretty), prevenção de órfãos, unidades ch, critérios de órfão coreano, conflito -webkit-line-clamp
references/favicon-logo.mdTrabalho de favicon, logotipo de produto ou identidade de marcaConjunto de arquivos favicon, modo escuro SVG, logotipo no nav/rodapé, variantes de modo escuro, imagens OG, tokens de marca, erros comuns
references/logo-trust-sections.mdLogotipos de integração/parceiro/clienteDecisão entre marquee e grade, antipadrões, tratamento em escala de cinza, posicionamento
references/visual-hierarchy.mdQualquer decisão de layout / composição6 alavancas: escala de tamanho, contraste de peso, ênfase de cor, espaçamento, posição, densidade
references/form-patterns.mdFormulários, assistentes, autenticação, upload de arquivoTempo de validação, múltiplas etapas, UX de senha, upload de arquivo, pesquisa/filtro
references/mobile-native-ux.mdDecisões de UX de aplicativo móvel nativoiOS HIG vs Material 3, gestos, deep linking, privacidade coreana, UX de loja de aplicativos
references/intent-discovery-ladder.mdAprofundamento opcional de UX-INTENT-01 (Etapas 1-6)Escada de humor/claridade/densidade/forma/viewport/referência, desambiguação de solicitação vaga
references/korean-design-vocabulary.mdBriefs de design coreanos ou UI coreana como primeira línguaTradução de descritor coreano → token CSS, tabela de correspondência rápida, diretrizes de seleção de fonte

Gate do Usuário Preguiçoso (UX-LAZY-01, PADRÃO — disciplina ponytail aplicada a UX)

Projete para o usuário cognitivamente frugal: usuários não leem, eles escaneiam; eles satisfazem; eles trocarão escolha por uma próxima ação óbvia. Antes de enviar qualquer ponto de decisão voltado ao usuário — opção, configuração, etapa, confirmação, campo de entrada, modo — justifique sua existência do jeito ponytail, em ordem:

  1. Não faça nada: um padrão correto pode eliminar esta decisão completamente?
  2. Exclua: a etapa/campo ganha seu custo de taxa de conclusão (lei de Hick)?
  3. Absorva: o sistema pode assumir a complexidade em vez do usuário (lei de Tesler)?
  4. Rebaixe: ainda necessário para alguns usuários → divulgação progressiva, nunca uma bifurcação de nível superior.

Cada tela tem UMA ação primária. Superfície condicional: fluxos de consumo/uso único minimizam DECISÕES; ferramentas de trabalho repetido (perfis densos) minimizam MOVIMENTOS repetidos — colapsar controles de especialista em assistentes é a falha inversa. Isenções RIGOROSAS: ações destrutivas/irreversíveis, consentimento/privacidade/legal, confirmação de pagamento e afacilidades de acessibilidade nunca são colapsadas em padrões mágicos.

Contrato de Estado de UX (UX-STATE-01)

Para trabalho de onboarding, vazio, carregamento, erro ou divulgação progressiva, o corpo deve responder ao significado do estado antes da estilização. Padrões profundos estão em references/ux-states.md.

  • Onboarding ensina a primeira ação significativa, não o produto inteiro.
  • Vazio explica por que o estado existe e nomeia a próxima ação.
  • Carregamento escolhe esqueleto para estrutura conhecida, spinner/progresso para esperas curtas desconhecidas, e evita conclusão falsa.
  • Erro expõe repetição, recuperação ou escalação; nunca deixe o usuário em um beco sem saída.
  • Divulgação progressiva nomeia o que permanece oculto, por que permanece oculto e onde se torna disponível.

Escolhedor de IA (UX-IA-01)

Arquitetura de navegação padrão por forma de trabalho; leia references/responsive-nav.md para detalhes responsivos.

Forma de trabalhoIA Padrão
Trabalho repetido denso em desktopSidebar + paleta de comandos
Trabalho seccionado médioAbas ou navegação segmentada
Fluxo de consumo móvel primárioNavegação inferior, sheet ou ações de zona de polegar
Assistente/auth/configuraçãoStepper ou fluxo linear empilhado

1. Protocolo de Descoberta de Intenção do Usuário

Quando a solicitação de design do usuário é vaga ("깔끔하게 해줘", "모던하게", "apenas faça ficar bonito"), não produza saída genérica. Execute o fluxo de ambiguidade compacto (UX-INTENT-01):

  1. Produza o Design Read da §2 usando sinais disponíveis.
  2. Se uma decisão ainda bloquear a direção, faça UMA melhor bifurcação de esclarecimento com escolhas binárias/ternárias.
  3. Proceda a partir da resposta; se o usuário não responder e a tarefa puder continuar, escolha o padrão mais correto para o domínio e declare a suposição. Em superfícies EXPRESSIVAS (landing/consumidor/criativo/produto-AI), esse padrão é a Direção Padrão Sem Brief abaixo (UX-DEFAULT-ISM-01); superfícies silenciosas mantêm padrões silenciosos corretos para o domínio.

Pule esta seção se o usuário forneceu especificações de design explícitas ou se este é um patch de ≤5 linhas.

Direção Padrão Sem Brief (UX-DEFAULT-ISM-01, PADRÃO — conteúdo do kit STYLE_SAMPLE)

Este é o FALLBACK da etapa 3 de UX-INTENT-01, nunca um desvio: ele é acionado apenas após o Design Read e após a bifurcação bloqueadora ser resolvida ou não respondida, e a direção aplicada é SEMPRE declarada como uma suposição explícita na entrega. Uma direção nomeada, específica e com portão de domínio substitui os padrões genéricos de LLM; ela NÃO deve reintroduzir gosto genérico de glassmorphism / card centralizado / bege padrão sob um novo rótulo.

Kit padrão para superfícies expressivas: Liquid Editorial (composto de 2026, decidido em 2026-07-07 a partir de pesquisa de tendência Tier-2 — veja references/design-isms.md §1.14 para a assinatura completa):

  • Estrutura: composição editorial liderada por tipografia (escala de título autoral superdimensionada, grotesk padrão, serifado para exibição apenas com justificativa editorial por UX-TYPE-01), textura tátil/fotográfica sobre lavagens de gradiente planas, layout assimétrico com peso baseado em conteúdo.
  • Destaque de material: Liquid Glass ou chrome de pílula quase opaca APENAS em camadas funcionais flutuantes (nav/barras de ferramentas/aglomerados de chip); unidades de conteúdo de pílula-chip; camada de conteúdo permanece sólida (ima2-front FE-LIQUID-LAYER-01). Filhos dentro de chrome de pílula não carregam bordas/contornos de cápsula em repouso — ênfase via preenchimentos/matizes apenas (ima2-front FE-PILL-NEST-01); estados de scroll da barra superior por ima2-front/references/top-bar.md FE-TOPBAR-STATE-01.
  • Movimento: linha de base de feedback + um momento de assinatura (chips de proximidade de ponteiro ou revelação acionada por scroll) + >= 1 revelação de scroll de suporte em superfícies de landing bucket (mínimo 2, máximo ~4 — ima2-front/references/motion.md FE-MOTION-BUCKET-01); apenas feedback em outros lugares, por portões de domínio de movimento.
  • Cor: destaque único derivado de OKLCH + neutros matizados (orçamento de matiz, references/color-system.md).

Portão de domínio (RIGOROSO): dashboards, admin, operações, finanças, governo, ferramentas de trabalho repetido B2B NUNCA recebem este kit por padrão — "chique" nunca substitui correção de domínio (§ Escolhedor de IA + perfis de densidade de produto ima2-front).

Aprofundamento opcional: use a escada abaixo apenas quando a primeira bifurcação falhar ou o usuário quiser explicitamente exploração guiada.

  • Use escolhas binárias/ternárias, não perguntas abertas.
  • Referencie produtos conhecidos — os usuários reconhecem o que querem mais rápido do que articulam.
  • Se a skill de diagrama estiver disponível, ofereça: "참고로 스타일 비교를 다이어그램으로 보여드릴 수도 있어요."
  • Se o usuário nomear uma referência de produto específica, pule as etapas restantes e mapeie diretamente via references/product-personalities.md.

Para a escada guiada completa de 6 etapas (Humor → Claridade → Densidade → Forma → Viewport → Referência) e tabela de desambiguação de solicitação vaga, leia references/intent-discovery-ladder.md. Carregue-a apenas quando o fluxo compacto acima precisar de exploração guiada mais profunda.


2. Design Read (OBRIGATÓRIO para novas páginas, componentes ou layouts. Opcional para patches de ≤5 linhas — veja dev §0.1 Caminho Rápido de Patch.)

Antes de gerar QUALQUER código de frontend, produza um Design Read. Se o projeto tiver um arquivo DESIGN.md, leia-o primeiro — seus tokens e prosa substituem tudo abaixo.

Suporte a ferramentas nativas (estrutura/60): leia referências visuais — telas existentes, capturas de concorrentes, exportações de design — no contexto com view_image antes de escrever o Design Read; produza os ativos bitmap necessários (ícones, ilustrações, imagens mock) com ima2 (verifique ima2 status, tente ima2 serve se estiver inativo; ima2 é a ferramenta principal apenas quando ima2 está realmente indisponível) em vez de deixar caixas de espaço reservado; e verifique o resultado construído visualmente por verificação visual (screenshot do navegador -> view_image).

Formato de saída (mini DESIGN.md)

Exemplo preenchido: references/design-read-example.md.

---
name: <nome-do-projeto>
colors:
  primary: "<hex>"
  accent: "<hex>"
  background: "<hex>"
typography:
  heading: { fontFamily: <fonte>, fontSize: <tamanho> }
  body: { fontFamily: <fonte>, fontSize: <tamanho> }
---

Lendo isto como: <tipo de página> para <público>, com uma linguagem . <1-2 frases: referência específica, não adjetivos. "Apostila de palestra dos anos 1970" > "moderno e limpo">

Faça: <positivos específicos do contexto do briefing> Não faça: <negativos específicos do contexto do briefing>

Habilidades Relacionadas