Skill de design Halo
Halo é uma forma de projetar, não um tema para copiar. Ele corrige a gramática (tokens, tipo, movimento, acessibilidade, layout bilíngue, QA) e deixa o caráter do produto para você: sua assinatura visual, significados dos acentos, ilustrações, texto e som. O plano de treino em examples/ e os dois modelos são demonstrações da mecânica, não conteúdo para reutilizar.
Regras básicas
- Projete por produto. Escreva o brief primeiro (
templates/brief.md) e escolha uma assinatura visual que se ajuste a este produto (docs/00-creative-direction.md). Anéis, pictogramas de exercício e texto de treino estão errados a menos que o produto seja sobre fechar metas diárias. - Plataforma → Halo → biblioteca comprovada. Nunca invente mecanismos (
docs/16-libraries.md). - Tokens são a única fonte de cor, curva e raio. Sem literais de cor fora de
tokens/tokens.css;scripts/check_skill.pyaplica isso para o CSS do Halo. - Ambos os temas, ambas as direções, todos os breakpoints são projetados e testados.
- Números primeiro: rótulo cinza → valor grande com acento → frase simples. Visuais repetem o número, nunca o substituem.
- Movimento é leve: uma curva, revelar uma vez, nada em loop, seguro para movimento reduzido. Atualizações de dados ao vivo ocorrem no lugar e nunca re-animam.
- Sem logotipos. O espaço da marca é o nome do produto em texto. Use uma marca apenas se o usuário fornecer uma.
- Pronto significa QA aprovado (
docs/13-qa.md).
Leia apenas o que a tarefa precisa
Os documentos são curtos (menos de 1.500 tokens cada). Não leia tudo; roteie por tarefa:
| Tarefa | Leia | Comece de |
|---|---|---|
| Qualquer novo produto ou página | docs/00, docs/02, docs/03, docs/05 | templates/starter.html (app pessoal) ou templates/dashboard.html (dados / operações) |
| Tela com muitos dados | docs/10, docs/04 | templates/dashboard.html |
| Curdo / Árabe / Persa | docs/08, docs/03 | qualquer modelo com lang=ckb |
| Polimento para celular | docs/07 | — |
| Movimento, luz de borda, rolagem | docs/06 | — |
| Som | docs/14 | js/halo-sound.js |
| Ícones ou ilustrações | icons/README.md, docs/09 | icons/ |
| Documento impresso ou PDF | docs/11 | templates/print-a4.html |
| React / Next / Tailwind / Vue | docs/17 | — |
| Escolha de biblioteca | docs/16 | — |
| Figma ou tokens de design para outras ferramentas | docs/15, tokens/*.tokens.json | — |
| Acessibilidade | docs/12 | — |
| Testes | docs/13 | qa/ |
Nunca leia examples/workout-plan/index.html inteiro (cerca de 42k tokens). Pesquise um padrão específico nele (grep -n "restTimer" …).
Fluxo de trabalho
- Brief. Preencha
templates/brief.md: para quem é, o que eles voltam para conferir, os 1–3 números heróis, a assinatura visual, significados dos acentos, linguagem de ilustração, intensidade de movimento e som, superfícies, idiomas e seções. Se a solicitação for ambígua, mostre o brief e faça uma pergunta; caso contrário, declare-o em um parágrafo curto e construa. - Fundação. Vincule
tokens/tokens.css,css/halo.css,js/halo.js(maisjs/halo-sound.jsapenas se o brief tiver som) e chameHalo.init({dict}). Fontes: Google Sans + IBM Plex Sans Arabic (docs/03). - Componha seções a partir dos componentes em
docs/05:- Construa a assinatura visual com peças existentes:
Halo.rings,Halo.spark,.metercom um marcador.target,.bars,.timeline, a grade de status, ou um herói tipográfico. Ou invente um que siga as regras emdocs/00. - Substitua todo o conteúdo do modelo. Se sua página disser "Feche os anéis" ou "GPUs saudáveis" e o produto não for sobre isso, você copiou.
- Construa a assinatura visual com peças existentes:
- Equilibre o celular e o laptop separadamente (
docs/04,docs/07). - Bilíngue: toda string vai no dicionário, com regras RTL de
docs/08. Se você mesmo escrever curdo, avise o usuário e recomende uma revisão nativa. - Movimento e som na intensidade que o brief escolheu (
docs/06,docs/14). - QA, servido via http:
Adicione as próprias verificações de interação do produto e axe-core. Revise capturas de tela em 390 e 1440 em ambos os temas.python3 qa/qa_layout.py http://localhost:8000/page.html # 9 larguras × 2 temas × 2 idiomas python3 qa/qa_touch.py http://localhost:8000/page.html # suíte de toque para celular - Impressão se necessário: HTML →
scripts/print_pdf.py→qpdfmerge →scripts/verify_pdf.sh(0 imagens). Incorpore fontes.ttf.
Lista de verificação pré-entrega
- Um brief existe, e a assinatura visual se ajusta ao produto (não anéis por padrão, não conteúdo copiado).
- No máximo três significados de acentos, usados consistentemente; acentos de texto usam
--XT. - Sem literais de cor fora dos tokens; sem logotipo que o usuário não forneceu.
- Laptop: colunas equilibradas, rodapés alinhados, gráficos preenchem seus cards. Celular: ≤ 4 controles de navegação, alvos de 44 px, sem rolagem lateral em 320.
- RTL:
dir/lang, chevrons invertidos, gráficos espelhados,<bdi>ao redor de termos latinos e unidades latinas. - Movimento reduzido respeitado; som (se houver) tem um alternador e nunca é o único sinal.
- Fontes vinculadas para afirmações factuais; Desfazer para ações destrutivas.
-
qa_layout.pyeqa_touch.pypassam; sem erros no console; PDFs verificados como vetoriais.
Reprodutibilidade
make setupinstala dependências fixadas (requirements.txt) e Chromium.make checkvalida o próprio skill: links, tokens em sincronia, sem cores soltas, sem logotipos, sintaxe JS, frontmatter.make qatesta todos os modelos e o exemplo;make assetsre-renderiza as imagens do README;make tokensreconstrói o JSON DTCG.- CI executa o mesmo em
.github/workflows/qa.yml.
Mapa de arquivos
| Caminho | O que é |
|---|---|
docs/00-creative-direction.md | Leia primeiro. Brief, catálogo de assinatura visual, significados de acentos, linguagem de ilustração, anti-padrões |
templates/brief.md | O brief a ser preenchido |
templates/starter.html | Mecânica de app pessoal: herói dividido, anéis, tarefas, temporizador, planilha, som |
templates/dashboard.html | Mecânica de dados/operações: grade de status, sparklines, medidores com alvos, atualizações ao vivo, movimento parado |
templates/print-a4.html | Página de impressão vetorial |
tokens/ | tokens.css (fonte da verdade) + JSON DTCG 2025.10 |
css/halo.css · js/halo.js · js/halo-sound.js | Componentes · runtime · som calmo |
icons/ | Ícones de UI (grade Lucide), glifos, gramática de pictograma + galeria |
docs/01–17 | Princípios, cor, tipo, layout, componentes, movimento, celular, RTL, ícones, visualização de dados, impressão, a11y, QA, som, Figma, bibliotecas, frameworks |
qa/ · scripts/ | Suítes de teste · impressão, verificação, tokens, assets, auto-checagem |
fonts/ | IBM Plex Sans Arabic + Inter (TTF, OFL) para offline, CI e impressão |
examples/workout-plan/ | Um produto completo feito com Halo (site + 4 PDFs vetoriais). Apenas referência. |