/layers-surface
Assume que /layers-intro foi carregado para contexto do framework.
A camada de superfície é onde tudo o que foi decidido nas camadas abaixo se torna algo que uma pessoa realmente encontra: palavras, sons, visuais, affordances físicas, movimento, feedback. É a camada mais específica ao meio, mas as decisões mais importantes a serem tomadas primeiro são universais — elas se aplicam independentemente de a superfície ser uma tela, interface de voz, dispositivo físico ou ponto de contato de serviço.
As violações de superfície são frequentemente sintomas de problemas mais profundos. Este skill distingue entre problemas que você pode corrigir na superfície e problemas que exigem revisitar uma camada inferior.
Decisões que esta camada precisa tomar:
- A superfície honra o vocabulário e os objetos do modelo conceitual?
- Toda affordance do breadboard está presente — e há conteúdo de superfície sem nenhum modelo por trás?
- A superfície transmite o registro emocional correto para os jobs que os usuários estão realizando?
- Como o usuário sabe o que aconteceu, o que está em andamento e o que deu errado?
- O que é mais proeminente, e deveria ser?
- Cada peça de informação é acessível aos usuários que precisam dela?
Métodos:
| Método | Quando |
|---|---|
| Trabalhar diretamente no meio real (código, UI de produção) | Quando você precisa de feedback real sobre interações reais. Evita a lacuna entre como algo parece em um mockup e como se comporta no uso. |
| Mockups de alta fidelidade (Figma, etc.) | Explorar layout, hierarquia visual e forma visual — especialmente para padrões novos ou alinhamento de stakeholders. |
| Sistema de design / biblioteca de componentes | Quando o produto possui componentes e tokens estabelecidos. As decisões de superfície devem estender o sistema, não contradizê-lo. |
| Style tiles | Estabelecer a linguagem visual cedo sem se comprometer com o layout. Mais rápido que alta fidelidade para alinhamento inicial de tom. |
| Protótipos | Testar comportamento de interação — transições, tempo de feedback, fluxo — que mockups estáticos não conseguem transmitir. |
| Copy-first | Quando a linguagem é o principal material de design — mensagens, onboarding, estados de erro. Escreva o copy antes de projetar o contêiner. |
Sinais de qualidade — como são boas decisões de superfície:
- Cada termo corresponde à linguagem ubíqua do modelo conceitual
- Cada objeto tem uma representação consistente entre contextos — não é um metamorfo, nem mascarado
- Toda affordance do breadboard está presente; todo elemento de superfície tem um modelo por trás
- O registro emocional corresponde aos jobs emocionais e sociais das necessidades do usuário
- Mensagens de erro fazem três coisas: diagnosticar (o que aconteceu), explicar (por que), recuperar (o que fazer a seguir). "Algo deu errado" falha em todas as três.
- A proeminência reflete a importância — o que o fluxo precisa que o usuário perceba é o que se destaca
- Decisões de acessibilidade são tomadas explicitamente, não deixadas como padrão
Sessão guiada
Este skill tem duas partes. Diga-me o que você precisa:
- Auditoria — avaliar o trabalho de superfície existente com base em decisões de camadas inferiores (Fases 1–5)
- Inventário de decisões — trabalhar nas decisões abertas de superfície (Fases 6–10)
Descreva o que você tem, ou diga "guia-me" para começar.
Pergunte: "Onde devo capturar o trabalho desta sessão?" (veja /layers-intro para opções)
Pergunte:
- Em que produto ou funcionalidade estamos trabalhando?
- Qual meio — UI de tela, voz/conversacional, físico, pontos de contato de serviço?
- O que você tem das camadas inferiores? Modelo conceitual (objetos + linguagem ubíqua)? Breadboard ou fluxo? Job stories incluindo jobs emocionais/sociais?
Parte 1 — Auditoria
Fase 1 — Enquadrar a superfície
Existe trabalho de superfície existente — código funcional, UI implantada, copy, designs visuais? Ou a superfície ainda não foi iniciada? Se ainda não foi iniciada, pule para a Parte 2.
Fase 2 — Vocabulário e linguagem
Pegue a lista de linguagem ubíqua do modelo conceitual. Peça ao designer para compartilhar o copy da superfície — rótulos, cabeçalhos, texto de botões, mensagens de erro, notificações, texto de ajuda.
Verifique cada termo. Sinalize:
- Violações diretas — um termo do modelo usado incorretamente ou de forma inconsistente ("Conta" em um lugar, "Espaço de trabalho" em outro)
- Termos não listados — palavras na superfície que não estão na linguagem ubíqua. Novos termos para adicionar ao modelo, ou ruído de superfície?
- Desalinhamentos de tom — tecnicamente correto, mas tonalmente errado para os jobs emocionais/sociais
Para cada violação: correção de superfície (reescrever o copy) ou correção mais profunda (atualizar o vocabulário do modelo conceitual)?
Fase 3 — Consistência de objetos
Para cada objeto no modelo conceitual: onde ele aparece na superfície? Em quantas formas?
- Metamorfos — o mesmo objeto em formas visuais ou estruturais significativamente diferentes entre contextos
- Objetos mascarados — o objeto aparece em uma forma onde um usuário não conseguiria reconhecê-lo como aquele tipo de objeto
Para cada um: isso é uma decisão de superfície (estabelecer um tratamento consistente) ou um problema do modelo conceitual (a identidade do objeto não está clara nem mesmo no modelo)?
Fase 4 — Verificação de completude
Pegue o breadboard. Para cada lugar e affordance:
- Toda affordance do breadboard está presente na superfície?
- Existe conteúdo de superfície sem nenhum elemento correspondente no breadboard?
Adições que não estavam no breadboard são frequentemente decisões da camada de interação que passaram despercebidas — sinalize-as e recomende revisitar /layers-interaction-flow.
Fase 5 — Registro emocional
Retorne às job stories, particularmente aos jobs emocionais e sociais.
"Qual job emocional o usuário está realizando aqui — não apenas a tarefa funcional, mas como ele quer se sentir?" "Qual job social está em jogo — como ele quer ser percebido?"
Desalinhamentos comuns:
- A superfície enfatiza o benefício do produto ("nós ganhamos uma indicação") sobre o job do usuário ("eu ajudo um colega")
- O copy enquadra uma interação de forma transacional quando o job do usuário é relacional
- O tom parece especializado/clínico quando o usuário precisa se sentir seguro ou confiante
Parte 2 — Inventário de decisões
Fase 6 — Feedback e erros
Para cada ação significativa e transição de estado:
- "Como o usuário sabe que sua ação funcionou?"
- "Como o usuário sabe que algo está em andamento?"
- "Como o usuário sabe que algo deu errado, e o que fazer sobre isso?"
Mensagens de erro devem diagnosticar, explicar e dizer ao usuário o que fazer a seguir. Sinalize todo estado de erro que não atenda a todos os três. Produza uma decisão para cada lacuna: "Precisamos decidir como comunicar [X] ao usuário. As opções são [Y]."
Fase 7 — Hierarquia e ênfase
Para cada lugar chave:
- "Qual é a coisa mais importante que o usuário precisa notar ou agir aqui?"
- "A superfície atual torna essa coisa a mais proeminente?"
- "Algo é visualmente proeminente que não deveria ser?"
Estas são decisões agnósticas ao meio primeiro (o que deve ser primário) antes de se tornarem específicas ao meio (como torná-lo primário visualmente, auditivamente ou tátilmente).
Fase 8 — Acessibilidade
Sinalize considerações relevantes para o meio declarado:
- UI de tela: contraste de cores, tamanho do texto, alvos de toque, navegação por teclado, rótulos de leitor de tela para elementos interativos e imagens, gerenciamento de foco entre etapas do fluxo
- Voz/conversacional: todas as informações transmitidas verbalmente (sem "clique no botão à esquerda"), recuperação de erros sem contexto visual
- Físico: alcance, diferenciação tátil, visibilidade em iluminação variada, operação sem precisão motora fina
Produza uma lista de decisões de acessibilidade: "Precisamos decidir como [X] será acessível para usuários que [Y]."
Fase 9 — Consistência
- Coisas similares são tratadas de forma similar? (Mesmas ações parecem e se comportam da mesma forma; mesmos tipos de objeto representados consistentemente)
- Coisas diferentes são tratadas de forma diferente? (Primário vs. secundário, destrutivo vs. seguro)
- Esta superfície está em conformidade com as convenções de seu meio? Violar normas de plataforma é uma decisão com um custo — às vezes vale a pena, sempre intencional.
Distinga: inconsistências internas (corrigir dentro da superfície) vs. violações de convenção (escolha deliberada ou descuido — decida qual).
Fase 10 — Decisões abertas
Produza uma lista consolidada de todas as decisões de superfície que ainda precisam ser tomadas:
- Questões entre camadas para resolver primeiro — raiz está em uma camada inferior; listadas separadamente; exigem revisitar o skill relevante antes que a superfície possa estar correta
- Decisões de superfície para tomar agora — qual é a decisão? quais são as opções? quais restrições se aplicam (das camadas inferiores, do meio, da marca/consistência)?
- Adiadas — não precisam ser tomadas agora, mas devem ser rastreadas
Conclusão
Produza:
- Descobertas da auditoria — violações de vocabulário, objetos mascarados/metamorfos, lacunas de completude, desalinhamentos de registro emocional — cada um categorizado como correção de superfície ou problema de camada mais profunda
- Inventário de decisões — todas as decisões abertas de superfície, agrupadas e priorizadas
- Questões entre camadas — coisas para resolver em uma camada inferior antes que a superfície possa estar correta
- O que está funcionando — decisões de superfície já tomadas corretamente; não as perca na revisão
Feche com: "A superfície é a camada que os usuários encontram. Tudo decidido abaixo ou é honrado aqui ou minado aqui. Revisite este skill após qualquer mudança significativa no modelo conceitual ou na estrutura de interação."