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 doima2-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êmeroO agente determina seu próprio diretório de skills e o passa via
--dir. Após a instalação, SKILL.md ereferences/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)
| Arquivo | Quando Ler | O Que Abrange |
|---|---|---|
references/design-isms.md | O usuário nomeia um estilo/movimento | 16 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.md | Procurando referências de design reais | Guia de sourcing em camadas: sites de premiação e galeria, para que cada um é melhor e como pesquisar |
references/compositional-patterns.md | Compondo herói, navegação, movimento ou estrutura de conteúdo | Padrões composicionais canônicos de pesquisa de premiação com portões de responsividade e acessibilidade |
references/design-trends.md | Verificando prevalência datada, técnicas emergentes ou status de promoção | Instantâ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.md | Aprendendo ou revisando o formato Design Read | Exemplo preenchido de Design Read + configuração de dial |
references/product-personalities.md | O usuário referencia um produto | 10 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.md | Escolhendo layout de página/componente | Layouts de componente + composições de nível de página |
references/ux-states.md | Construindo qualquer UI com estado | Onboarding, vazio, erro, carregamento, divulgação progressiva |
references/color-system.md | Gerando cores/paleta | Geração de paleta baseada em OKLCH, orçamento de matiz, neutros matizados, modo escuro, acessibilidade |
references/design-system-bootstrap.md | Novo projeto / sistema de design | Arquitetura de tokens, hierarquia de componentes, formato DESIGN.md (google-labs-code/design.md) |
references/responsive-nav.md | Trabalho responsivo ou de navegação | Breakpoints, consultas de contêiner, padrões de navegação por densidade |
references/ux-preflight.md | Antes da entrega | Lista de verificação de verificação de estado de UX |
references/typography-line-breaks.md | Sempre para UI com muito texto | Qualidade 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.md | Trabalho de favicon, logotipo de produto ou identidade de marca | Conjunto 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.md | Logotipos de integração/parceiro/cliente | Decisão entre marquee e grade, antipadrões, tratamento em escala de cinza, posicionamento |
references/visual-hierarchy.md | Qualquer decisão de layout / composição | 6 alavancas: escala de tamanho, contraste de peso, ênfase de cor, espaçamento, posição, densidade |
references/form-patterns.md | Formulários, assistentes, autenticação, upload de arquivo | Tempo de validação, múltiplas etapas, UX de senha, upload de arquivo, pesquisa/filtro |
references/mobile-native-ux.md | Decisões de UX de aplicativo móvel nativo | iOS HIG vs Material 3, gestos, deep linking, privacidade coreana, UX de loja de aplicativos |
references/intent-discovery-ladder.md | Aprofundamento 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.md | Briefs de design coreanos ou UI coreana como primeira língua | Traduçã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:
- Não faça nada: um padrão correto pode eliminar esta decisão completamente?
- Exclua: a etapa/campo ganha seu custo de taxa de conclusão (lei de Hick)?
- Absorva: o sistema pode assumir a complexidade em vez do usuário (lei de Tesler)?
- 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 trabalho | IA Padrão |
|---|---|
| Trabalho repetido denso em desktop | Sidebar + paleta de comandos |
| Trabalho seccionado médio | Abas ou navegação segmentada |
| Fluxo de consumo móvel primário | Navegação inferior, sheet ou ações de zona de polegar |
| Assistente/auth/configuração | Stepper 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):
- Produza o Design Read da §2 usando sinais disponíveis.
- Se uma decisão ainda bloquear a direção, faça UMA melhor bifurcação de esclarecimento com escolhas binárias/ternárias.
- 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-frontFE-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-frontFE-PILL-NEST-01); estados de scroll da barra superior porima2-front/references/top-bar.mdFE-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.mdFE-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>