Unidade 9 / 11

Sistema de Design: Inteligência Artificial em Componentes, Tokens e Documentação

Ganhos:

  • Capacidade de elaborar e criar tokens de design consistentes, nomenclatura de componentes e regras de uso com inteligência artificial
  • Capacidade de produzir rapidamente documentação de componentes, exemplos de fazer/não fazer e textos de uso com inteligência artificial
  • Capacidade de verificar sugestões de inteligência artificial quanto a conflitos com o sistema de design existente e preservar a singularidade

Um sistema de design é a linguagem comum que faz com que uma família de produtos pareça e se comporte de forma consistente: componentes reutilizáveis ​​(botão, cartão, campo de formulário), tokens de design (definições nomeadas de valores como cor, espaçamento, tipografia) e documentação que explica como usá-los. Um bom sistema de design permite que dez designers projetem o mesmo produto como se fosse produzido por uma única fonte. Instalar e manter este sistema é um trabalho cansativo, repetitivo e que exige muito texto; É exatamente aqui que a inteligência artificial brilha. Mas a essência do sistema é a singularidade e a consistência; As recomendações da AI não podem ser aceites sem serem verificadas quanto a conflitos com o sistema atual.

Tokens e nomenclatura: a base para consistência

Um token de design é um valor nomeado e reutilizável de uma decisão de design: cor primária, centro de espaço, título de texto maiúsculo. Graças aos tokens, você pode alterar uma cor em um só lugar e atualizá-la em todo o produto. Mas o poder dos tokens depende da consistência da nomenclatura; Se azul-1, azul principal e azul primário forem usados ​​misturados, o sistema irá travar.

A IA é boa em duas coisas aqui: revisar seu conjunto de tokens existente em relação a um esquema de nomenclatura consistente e sugerir nomes compatíveis com o esquema para novos tokens. Uma solicitação como "Traduzir esta lista de tokens para nomenclatura semântica (baseada em significado)" ajudará você a gerar nomes que transmitam significado, como color-action-primary em vez de blue-500. Mas a decisão final sobre a nomeação é o contrato da equipe; O modelo fornece apenas um esboço.

Dica: Ao nomear tokens para IA, dê de 5 a 6 exemplos do seu esquema atual e diga “mantenha o mesmo padrão”. A solicitação sem amostra produz nomes estranhos ao seu sistema.

Documentação de componentes: a área mais produtiva da IA

A documentação de um componente inclui: o que ele faz, quando usá-lo, quando não usá-lo, suas variantes, estados (padrão, pairar, passivo, erro), notas de acessibilidade e exemplos do tipo "faça/não faça". Escrever esses textos à mão leva horas, e é por isso que muitas equipes negligenciam a documentação.

A IA preenche essa lacuna: quando você descreve um componente, ela produz rascunhos de documentação, regras de uso e exemplos de fazer/não fazer em um formato consistente. Assim, a documentação passa de “não tem” para “tem rascunho, vai ser consertado”, o que é um grande ganho. Porém, o modelo não conhece o comportamento real do componente; É sua função combinar as regras que ele produz com a realidade do sistema.

fragmento de documento

Contribuição da inteligência artificial

verificação humana

O que isso faz?

Definição clara do contorno

Verdadeira aptidão para o propósito

Quando usar

Cenários gerais

Regras específicas do produto

Exemplos de fazer/não fazer

Pares de rascunho rápido

Maus usos reais

Nota de acessibilidade

Lembretes padrão

Confirmado por teste real

Lista de variantes/casos

lista possível

Aqueles que realmente existem no sistema

Verificação de contradição: preservando a singularidade

O arquiinimigo do sistema de design é a duplicação: dois botões fazendo o mesmo trabalho, duas escalas de espaço diferentes, duas regras conflitantes. Quando a IA sugere um novo componente ou regra, essa sugestão pode entrar em conflito com o sistema existente – ela não mantém todo o seu sistema modelo em mente. Então avalio cada sugestão perguntando "isso entra em conflito com algo que já existe?" Filtre com a pergunta. Você também pode usar inteligência artificial na verificação de conflitos: você pode fornecer o resumo atual do sistema e a nova recomendação e listar os conflitos. Mas a decisão final “singularmente correta” cabe à equipe.

três mini cases

Caso 1 — Dívida documental liquidada. Apenas 6 dos 24 componentes de uma equipe tinham documentação. Foram produzidos projetos de documentos para os restantes 18 componentes com inteligência artificial; A equipe consertou cada um em 10-15 minutos. A obra, adiada por semanas, foi concluída em dois dias.

Caso 2 — A nomenclatura do token tornou-se consistente. Em um sistema as cores foram misturadas como blue1, mainBlue, brand-blue. A IA traduziu os 40 tokens existentes em esquema semântico; A equipe o revisou e mudou para um padrão único. Os erros de cores foram visivelmente reduzidos nos designs subsequentes.

Caso 3 — Componente conflitante foi rejeitado. A AI propôs um novo componente chamado “botão de ação secundária”. Quando a equipe procurou contradições, descobriu que fazia o mesmo trabalho que o “botão fantasma” existente e rejeitou a sugestão. Lição: nem toda sugestão adiciona um novo componente ao sistema; Às vezes é certo usar o que está disponível.

Prompts copiáveis

Sua função: administrador do sistema de design.Documente este componente: <<componente e seu comportamento>>.Formato: O que ele faz | Quando usar | Quando NÃO usar |Variantes | Situações | Notas de acessibilidade | 2 Faça / 2 Não dê exemplo. Invente um comportamento que você não conhece; Escreva "a equipe deve preencher".

Traduza esta lista de tokens em um esquema de nomenclatura semântico (baseado em significado). Meus exemplos de esquema atuais: <<5-6 exemplos>>. Continue no mesmo padrão. Para cada token, forneça o nome antigo -> novo nome -> tabela de justificação. Lista: <<tokens>>

Procure contradições: Resumo do meu sistema de design atual: <<resumo>>. Novo componente/regra proposto: <<sugestão>>. Esta sugestão entra em conflito com o sistema existente (componente que faz o mesmo trabalho, regra conflitante, token duplicado)? Liste os conflitos e sua sugestão.

Gere pares de exemplos "faça/não faça" para este componente: uso correto realista e cenários de uso incorreto realistas. Para cada par, explique em uma frase por que é verdadeiro/falso. Componente: <<nome e finalidade>>

Alerta fraco / Alerta forte

Fraco: "Escreva documentação para este botão."

Resultado: Um texto geral formatado sem conexão com o sistema.

Forte: "Documente este botão no seguinte formato (o que ele faz / quando não usar / variantes / casos / acessibilidade / não faça); invente um comportamento que você não conhece, escreva 'a equipe deve preencher'."

Resultado: Manuscrito consistentemente formatado, com espaçamento adequado e editável.

Diferença: formato de prompt forte + proibição de fabricação + avisos de fazer/não fazer.

Erros comuns

  • Solicitando nomeação de token sem exemplo. O modelo gera nomes estranhos ao seu sistema; a consistência está quebrada.
  • Adicionar componentes sem procurar contradições. A duplicação é o arquiinimigo do sistema.
  • Supondo que o comportamento inventado pelo modelo esteja correto. A IA não conhece o comportamento real do componente.
  • Aceitar a classificação de acessibilidade sem testar. O lembrete padrão não substitui o teste real.
  • Escrever a documentação uma vez e não atualizá-la. O documento deve ser atualizado à medida que o sistema muda.

Em resumo

O sistema de design é a infraestrutura de consistência e escalabilidade; mas sua manutenção é muitas vezes negligenciada por ser muito textual e repetitiva. A IA resolve essa dívida produzindo rapidamente documentação de componentes, exemplos do que fazer/não fazer, scripts de uso e rascunhos de nomenclatura de tokens. Mas a essência do sistema é a singularidade e a consistência: cada nome de token deve ser verificado em relação ao esquema de amostra, cada proposta de componente deve ser verificada de forma contraditória, cada descrição de comportamento deve ser verificada em relação à realidade. Utilize o modelo como um redator eficiente; A equipe toma a decisão individual correta.

Tarefa de aplicativo

  1. Selecione um componente com documentação faltante e produza um rascunho do documento com o primeiro prompt.
  2. Preencha os campos marcados como "A equipe deve preencher" com o comportamento real.
  3. Com o segundo prompt, converta seus 8 a 10 tokens para o esquema semântico e crie uma tabela de nomes antiga/nova.
  4. Para uma nova ideia de componente, procure por contradições com o terceiro prompt.
  5. Com o quarto prompt, gere pares de exemplos de fazer/não fazer para um componente e adicione-os ao sistema.

lista de verificação

  • [] Vinculei a nomenclatura do token ao esquema de exemplo.
  • [] Examinei os novos componentes em busca de conflitos.
  • [ ] Verifiquei os comportamentos do modelo com a realidade.
  • [] Planejei confirmar as notas de acessibilidade com testes reais.
  • [ ] Mantive a documentação em um formato consistente.
  • [ ] Preservei a singularidade e evitei a duplicação.