Hallmark
Uma habilidade de design para assistentes de codificação de IA. Faz com que as UIs que eles geram pareçam feitas, não geradas.
Hallmark é opinativo, curto e chato de propósito. Ele codifica um conjunto restrito de regras — extraídas do consenso do campo de design anti-AI-slop (habilidade de design de front-end da Anthropic, o livro de receitas Claude sobre estética de front-end e o movimento 'tátil de rebelião' de 2026) — e se recusa a deixar o modelo cair nos padrões nos quais todo LLM foi treinado.
O diferencial: o Hallmark insiste em variedade estrutural, não apenas variedade visual. Duas páginas do Hallmark para dois briefings diferentes não devem compartilhar o mesmo ritmo herói → 3 recursos → CTA → rodapé. Elas devem parecer sites diferentes, não apenas trocas de cores do mesmo modelo. Consulte references/structure.md.
Desenvolvido por Together AI.
Como usar esta habilidade
O Hallmark tem um comportamento padrão e três verbos explícitos.
| Invocação | O que faz |
|---|---|
| (padrão) | O usuário pediu para você projetar ou construir algo novo. Siga o Fluxo de Design abaixo. |
hallmark audit <alvo> | Leia o alvo, pontue-o contra a lista de antipadrões, retorne uma lista priorizada de itens a corrigir. Não edite. |
hallmark redesign <alvo> [--mood <nome>] | Pegue o conteúdo e a intenção do alvo, depois redesenhe a estrutura visual dentro dos limites de implementação existentes, a menos que o usuário confirme explicitamente uma reconstrução completa. Novo ritmo de seção, novo posicionamento de títulos, nova voz de componente. Preserve as rotas existentes, a propriedade dos componentes, a intenção da cópia, a marca e a arquitetura da informação; substitua apenas a camada visual/de interação necessária para o escopo solicitado. |
| `hallmark study <captura de tela | URL>` |
Se o usuário digitar algo que não corresponda claramente a audit, redesign ou study, trate como padrão. Se o usuário anexar uma imagem ou colar uma URL sem um prefixo de verbo, pergunte: 'Devo study (estudar) isso (extrair o DNA) ou devo tratar como referência para uma nova construção?'
Trilho de segurança de implementação. Hallmark é uma habilidade de design, não uma licença para arrasar uma base de código. Em qualquer projeto existente:
- Nunca exclua arquivos de produção, árvores de rotas, diretórios de componentes ou um site antigo, a menos que o usuário solicite explicitamente a exclusão ou aprove um plano no nível do arquivo que liste as exclusões.
- Padrão para edições in loco dos arquivos nomeados, ou componentes/ tokens aditivos que sejam conectados através da rota existente. Se o redesenho exigir a remoção de vários componentes, pare e peça confirmação primeiro.
- Trate PDFs, arquivos README, briefings
.md, documentos, transcrições e baralhos de pitch como material de referência. Não os copie palavra por palavra para a página, a menos que o usuário diga explicitamente para usar esse texto literalmente. - Antes de editar, declare os arquivos exatos que você espera modificar/criar/excluir. Exclusões exigem confirmação explícita.
O Fluxo de Design padrão sempre escolhe um tema. Por padrão, escolhe um dos 20 temas nomeados — o catálogo — e alterna entre eles de acordo com a regra de diversificação. Há também um ramo personalizado silencioso que constrói uma paleta OKLCH única + pareamento de fontes gratuitas para o briefing; a rota personalizada é acionada apenas quando o briefing carrega um sinal de intenção criativa (o usuário nomeia uma cor da marca, nomeia um clima de múltiplos atributos que o catálogo não pode carregar, ou solicita explicitamente um tema personalizado). Para briefings comuns, o usuário nunca vê as palavras 'catálogo' ou 'personalizado' — o catálogo é executado silenciosamente. Consulte a Etapa 1 (detecção de sinal) e a Etapa 2.6 (despacho); o protocolo vive em references/custom-theme.md.
Disciplinas que valem para todos os verbos
Estas seis disciplinas não são específicas de verbos. Elas se aplicam ao Design padrão, audit, redesign, study e escopo de componente igualmente. Elas ficam ao lado do teste slop, não dentro de um ramo dele.
-
Autocrítica pré-emissão. Antes de entregar qualquer saída, pontue-a de 1 a 5 em seis eixos — Filosofia, Hierarquia, Execução, Especificidade, Restrição, Variedade. Qualquer coisa < 3 dispara uma revisão. Carimbe as seis pontuações no topo do artefato (
/* Hallmark · pré-emissão crítica: P5 H4 E5 S4 R5 V5 */). Consultereferences/slop-test.md§ Autocrítica pré-emissão. -
Cópia honesta — sem conteúdo fabricado. Se o usuário não forneceu uma métrica, não invente uma. Layouts liderados por estatísticas, linhas de comparação e barras de prova devem usar números reais, um espaço reservado ('—' mais um bloco cinza rotulado 'métrica a confirmar') ou uma macroestrutura diferente. '+47% de conversão', 'confiado por mais de 50.000 equipes' e '10× mais rápido' são slop no momento em que são inventados. Mesma regra para depoimentos, logotipos e contagens de estudos de caso. Consulte
references/anti-patterns.md§ Métricas inventadas e o portão 46 do teste slop. -
Tokens bloqueados — sem improvisação durante a renderização. Uma vez que um tema é selecionado na Etapa 2.6, toda cor e toda declaração
font-familyno artefato deve referenciar um token nomeado (var(--color-accent),font-family: var(--font-display)). Valores OKLCH / hex /rgb()em linha, ou uma declaraçãofont-family: 'Alguma Fonte'que ignore o bloco de token, não são permitidos. Se um valor for necessário que não exista como token, eleve-o para o bloco de token como uma nova variável nomeada e, em seguida, referencie-o. Consultereferences/anti-patterns.md§ Improvisação de token durante a renderização e o portão 48 do teste slop. -
Cromo redesenhado proibido. O Hallmark não deve construir manualmente barras de navegador falsas (pílula de URL + pontos de semáforo), molduras de telefone falsas, janelas de bloco de código falsas (barra de título fictícia + pontos envolvendo um
<pre>) ou cromo IDE falso — o ambiente do usuário já fornece cromo real. Use capturas de tela reais envolvidas em um<figure>(com no máximo uma borda fina) ou omita o cromo e deixe o conteúdo se sustentar sozinho. Consultereferences/anti-patterns.md§ Cromo de UI redesenhado e o portão 47 do teste slop. -
Responsividade móvel — cada emissão verificada em 320 / 375 / 414 / 768 px. A saída do Hallmark deve renderizar perfeitamente em todas as quatro larguras. Os itens não negociáveis: sem rolagem horizontal + raiz
overflow-x: cliptanto emhtmlquanto embody, nuncahidden(portão 34); sem texto clicável de duas linhas — botões, links de navegação primários, links de rodapé, breadcrumbs, CTAs (portão 49); trilhas de grade que contêm imagens usamminmax(0, 1fr), nunca1frsimples (portão 50); cabeçalhos de exibição quebram palavras longas viaoverflow-wrap: anywhere; min-width: 0(portão 51); cabeçalhos de seção colapsam para uma coluna no celular em todas as variantes de tema (portão 52); padrões de guia de rádio não saltam de rolagem (portão 53). Consultereferences/responsive.md§ Móvel — não negociável. Este é um piso duro, não uma lista de desejos. -
Pureza tipográfica — sem cabeçalhos em itálico. Títulos e tipos de exibição são sempre romanos (
font-style: normal). Uma palavra de ênfase em itálico dentro de um título que de outra forma está na vertical ('Construído para pensar') é um dos sinais de IA mais confiáveis; o mesmo acontece com uma face de exibição totalmente em itálico nos títulos. Carregue a ênfase com peso, cor de destaque ou um sublinhado desenhado. O itálico sobrevive apenas como ênfase no corpo do texto dentro de parágrafos corridos. Consultereferences/anti-patterns.md§ Cabeçalhos em itálico e o portão 38a do teste slop.
Quando o briefing é um componente, não uma página
Antes de entrar no Fluxo de Design completo, verifique o escopo. Se algum destes itens for acionado, execute o fluxo de Escopo de Componente — a maioria das solicitações diárias de desenvolvimento são em forma de componente, não em forma de página, e o aparato no nível da página (macroestrutura, enriquecimento de herói, arquétipo de rodapé, memória de projeto) está errado para eles.
Sinais de Escopo de Componente:
- O briefing nomeia um único elemento de UI: um botão · uma entrada · um cartão · um modal · um dropdown · uma dica de ferramenta · um select · uma caixa de seleção · um interruptor · uma faixa de guia · um chip · um emblema · um banner · uma snackbar · um popover · um controle deslizante · um seletor de data · um avatar.
- O briefing é curto (≤ 30 palavras) e se refere a um elemento.
- O arquivo alvo é um único componente (por exemplo,
./Button.tsx,./components/Input.css,app/components/Card.vue). - O usuário diz explicitamente 'apenas o X', 'somente o Y', 'este único elemento', 'um único ___'.
Se dois sinais forem acionados, rota de componente. Se apenas o fluxo de página for acionado (briefing de várias seções, 'construa uma landing page para mim'), permaneça no Fluxo de Design.
O que o Escopo de Componente mantém do fluxo de página
- Etapa 0 · Varredura de pré-voo — igual. Leia tokens existentes, fontes, framework, postura de microinteração. Um botão em um projeto Tailwind baseado em Geist deve adotar esses tokens, não inventar novos.
- Etapa 1 · Detecção de gênero — igual. Editorial / minimalista moderno / atmosférico / lúdico. O componente herda o gênero de seu ambiente (padrão silencioso para editorial quando desconhecido).
- Etapa 2.6 · Rota de tema — igual. Se um
tokens.cssoudesign.mdexistir, o componente usa esses tokens. Caso contrário, pergunta 'existe um sistema a seguir ou devo escolher um?' — padronizando para catálogo se o usuário estiver em silêncio. - Disciplina de 2+1 fontes — igual.
- Disciplina de estado — MAIS RIGOROSA. Cada componente interativo DEVE conter código para todos os 8 estados: normal · hover ·
:focus-visible·:active· desabilitado · carregando · erro · sucesso. A lista de verificação de 8 estados eminteraction-and-states.mdé obrigatória, não consultiva. - Teste slop — subconjunto universal apenas. Execute os portões de visual / microinteração / contraste (portões 40–41) / a11y / tipografia. Pule os portões de diversificação (sem entrada
.hallmark/log.json— componentes não alternam) e pule os portões de segurança de layout que assumem uma página completa.
O que o Escopo de Componente pula
- Etapa 2 · Escolha de macroestrutura. Componentes não têm macroestruturas. Declare isso explicitamente: 'Escopo de componente: pulando macroestrutura.'
- Escolhas de arquétipo de navegação e rodapé. N1–N9 e Ft1–Ft8 são apenas para escopo de página. Um componente é um elemento; não tem navegação, não tem rodapé. Pule ambos.
- Padrões de polimento de herói (HP1–HP4). Apenas para escopo de página. Um botão ou cartão não tem herói.
- Etapa 4 · Enriquecimento. Sem ilustração de herói, sem vídeo de demonstração, sem fundo abstrato. O componente É o artefato.
- Etapa 5 · Pré-visualização de várias seções. Substituído pelo wrapper de demonstração de 8 estados (abaixo).
- Anexo de memória de projeto. Sem entrada
.hallmark/log.jsonpara execuções de componente. A regra de diversificação não se aplica.
O que o Escopo de Componente emite
Dois arquivos, lado a lado:
-
O artefato do componente — um único arquivo autocontido que corresponde às convenções do projeto:
- React / Vue / Svelte:
Button.tsx/Button.vue/Button.svelte - Web simples:
button.css+button.html - Tailwind: um
.tsxcom cadeiasclassNameE umtokens.cssse ausente - O componente consome tokens Hallmark pelo nome (
var(--color-accent)), nunca valores OKLCH em linha.
- React / Vue / Svelte:
-
Um wrapper de demonstração de 8 estados —
<NomeDoComponente>.preview.html(ou.preview.tsx). Uma pequena página independente que renderiza o componente em todos os 8 estados empilhados verticalmente, cada um rotulado. O usuário abre uma vez, vê o componente funcionando e, em seguida, o exclui. O wrapper não faz parte do código de produção. Formato:┌──── Botão — 8 estados ────────────────────────┐ │ │ │ normal [ Clique aqui ] │ │ hover [ Clique aqui ] │ ← .is-hover força estilo :hover │ foco [ Clique aqui ] │ ← .is-focus força :focus-visible │ ativo [ Clique aqui ] │ ← .is-active força :active │ desabilitado [ Clique aqui ] │ ← atributo disabled │ carregando [ ⌛ Trabalhando… ] │ ← data-state="loading" │ erro [ ⚠ Tente novamente ] │ ← data-state="error" │ sucesso [ ✓ Salvo ] │ ← data-state="success" │ │ └────────────────────────────────────────────────┘Cada linha rotulada usa uma classe (por exemplo,
.is-hover) que o CSS do componente visa além da pseudo-classe real, para que todos os 8 estados sejam renderizados de uma vez na página de demonstração. Exemplo:.btn:hover, .btn.is-hover { background: var(--color-paper-3); } .btn:focus-visible, .btn.is-focus { outline: 2px solid var(--color-focus); } .btn:active, .btn.is-active { transform: translateY(1px); }
Formato de carimbo para saída de componente
Componentes carimbam de forma diferente das páginas:
/* Hallmark · componente: <tipo> · gênero: <gênero> · tema: <tema>
* estados: normal · hover · foco · ativo · desabilitado · carregando · erro · sucesso
* contraste: passa (46–50)
*/
O prefixo componente: informa às execuções futuras do Hallmark que este artefato tem escopo de componente e não deve acionar diversificação no nível da página.