Habilidad de diseño Halo
Halo es una forma de diseñar, no un tema para copiar. Arregla la gramática (tokens, tipografía, movimiento, accesibilidad, maquetación bilingüe, QA) y deja el carácter del producto para ti: su elemento visual distintivo, significados de acentos, ilustraciones, texto y sonido. El plan de trabajo en examples/ y las dos plantillas son demostraciones de la mecánica, no contenido para reutilizar.
Reglas básicas
- Diseña por producto. Escribe el breve primero (
templates/brief.md) y elige un elemento visual distintivo que se adapte a este producto (docs/00-creative-direction.md). Los anillos, pictogramas de ejercicio y texto de entrenamiento son incorrectos a menos que el producto trate sobre cerrar metas diarias. - Plataforma → Halo → biblioteca probada. Nunca inventes mecanismos (
docs/16-libraries.md). - Los tokens son la única fuente de color, curva y radio. Sin literales de color fuera de
tokens/tokens.css;scripts/check_skill.pylo aplica para el CSS de Halo. - Ambos temas, ambas direcciones, cada punto de interrupción están diseñados y probados.
- Primero los números: etiqueta gris → valor de acento grande → frase simple. Los elementos visuales repiten el número, nunca lo reemplazan.
- El movimiento es ligero: una curva, revelar una vez, nada en bucle, seguro para movimiento reducido. Las actualizaciones de datos en vivo ocurren en su lugar y nunca se reaniman.
- Sin logotipos. El espacio de marca es el nombre del producto en texto. Usa una marca solo si el usuario la proporciona.
- Terminado significa QA aprobado (
docs/13-qa.md).
Lee solo lo que la tarea necesita
Los documentos son cortos (menos de 1500 tokens cada uno). No leas todo; enruta según la tarea:
| Tarea | Leer | Comenzar desde |
|---|---|---|
| Cualquier producto o página nueva | docs/00, docs/02, docs/03, docs/05 | templates/starter.html (aplicación personal) o templates/dashboard.html (datos / operaciones) |
| Pantalla con muchos datos | docs/10, docs/04 | templates/dashboard.html |
| Kurdo / Árabe / Persa | docs/08, docs/03 | cualquiera de las plantillas con lang=ckb |
| Pulido para teléfono | docs/07 | — |
| Movimiento, luz de borde, desplazamiento | docs/06 | — |
| Sonido | docs/14 | js/halo-sound.js |
| Iconos o ilustraciones | icons/README.md, docs/09 | icons/ |
| Documento impreso o PDF | docs/11 | templates/print-a4.html |
| React / Next / Tailwind / Vue | docs/17 | — |
| Elegir una biblioteca | docs/16 | — |
| Figma o tokens de diseño para otras herramientas | docs/15, tokens/*.tokens.json | — |
| Accesibilidad | docs/12 | — |
| Pruebas | docs/13 | qa/ |
Nunca leas examples/workout-plan/index.html completo (aproximadamente 42k tokens). Búscalo con un patrón específico en su lugar (grep -n "restTimer" ...).
Flujo de trabajo
- Breve. Completa
templates/brief.md: para quién es, qué vuelven a verificar, los 1 a 3 números principales, el elemento visual distintivo, significados de acentos, lenguaje de ilustración, intensidad de movimiento y sonido, superficies, idiomas y secciones. Si la solicitud es ambigua, muestra el breve y haz una pregunta; de lo contrario, redáctalo en un párrafo corto y construye. - Fundación. Enlaza
tokens/tokens.css,css/halo.css,js/halo.js(másjs/halo-sound.jssolo si el breve incluye sonido), y llama aHalo.init({dict}). Fuentes: Google Sans + IBM Plex Sans Arabic (docs/03). - Compone secciones a partir de los componentes en
docs/05:- Construye el elemento visual distintivo con piezas existentes:
Halo.rings,Halo.spark,.metercon un marcador.target,.bars,.timeline, la cuadrícula de estado, o un héroe tipográfico. O inventa uno que siga las reglas endocs/00. - Reemplaza todo el contenido de la plantilla. Si tu página dice "Cierra los anillos" o "GPUs saludables" y el producto no trata de eso, copiaste.
- Construye el elemento visual distintivo con piezas existentes:
- Equilibra teléfono y computadora portátil por separado (
docs/04,docs/07). - Bilingüe: cada cadena va en el diccionario, con reglas RTL de
docs/08. Si escribes kurdo tú mismo, dile al usuario y recomienda una revisión nativa. - Movimiento y sonido a la intensidad que eligió el breve (
docs/06,docs/14). - QA, servido sobre http:
Agrega las propias verificaciones de interacción del producto y axe-core. Revisa capturas de pantalla a 390 y 1440 en ambos temas.python3 qa/qa_layout.py http://localhost:8000/page.html # 9 anchos × 2 temas × 2 idiomas python3 qa/qa_touch.py http://localhost:8000/page.html # suite táctil para teléfono - Impresión si es necesario: HTML →
scripts/print_pdf.py→ fusión conqpdf→scripts/verify_pdf.sh(0 imágenes). Incrusta fuentes.ttf.
Lista de verificación previa a la entrega
- Existe un breve, y el elemento visual distintivo se adapta al producto (no anillos por defecto, ni contenido copiado).
- Como máximo tres significados de acentos, usados de manera consistente; los acentos de texto usan
--XT. - Sin literales de color fuera de tokens; sin logotipo que el usuario no haya proporcionado.
- Computadora portátil: columnas equilibradas, pies de página alineados, gráficos llenan sus tarjetas. Teléfono: ≤ 4 controles de navegación, objetivos de 44 px, sin desplazamiento lateral a 320.
- RTL:
dir/lang, chevrones invertidos, gráficos reflejados,<bdi>alrededor de términos latinos y unidades latinas. - Movimiento reducido respetado; sonido (si lo hay) tiene un interruptor y nunca es la única señal.
- Fuentes enlazadas para afirmaciones fácticas; Deshacer para acciones destructivas.
-
qa_layout.pyyqa_touch.pypasan; sin errores de consola; PDFs verificados vectoriales.
Reproducibilidad
make setupinstala dependencias fijas (requirements.txt) y Chromium.make checkvalida la habilidad misma: enlaces, tokens sincronizados, sin colores sueltos, sin logotipos, sintaxis JS, frontmatter.make qaprueba cada plantilla y el ejemplo;make assetsvuelve a renderizar las imágenes del README;make tokensreconstruye el JSON DTCG.- CI ejecuta lo mismo en
.github/workflows/qa.yml.
Mapa de archivos
| Ruta | Qué es |
|---|---|
docs/00-creative-direction.md | Leer primero. Breve, catálogo de elementos visuales distintivos, significados de acentos, lenguaje de ilustración, anti-patrones |
templates/brief.md | El breve a completar |
templates/starter.html | Mecánica de aplicación personal: héroe dividido, anillos, tareas, temporizador, hoja, sonido |
templates/dashboard.html | Mecánica de datos/operaciones: cuadrícula de estado, sparklines, medidores con objetivos, actualizaciones en vivo, movimiento estático |
templates/print-a4.html | Página de impresión vectorial |
tokens/ | tokens.css (fuente de verdad) + DTCG 2025.10 JSON |
css/halo.css · js/halo.js · js/halo-sound.js | Componentes · tiempo de ejecución · sonido calmado |
icons/ | Iconos de interfaz (cuadrícula Lucide), glifos, gramática de pictogramas + galería |
docs/01–17 | Principios, color, tipo, maquetación, componentes, movimiento, teléfono, RTL, iconos, visualización de datos, impresión, a11y, QA, sonido, Figma, bibliotecas, marcos de trabajo |
qa/ · scripts/ | Suites de prueba · impresión, verificación, tokens, activos, autoverificación |
fonts/ | IBM Plex Sans Arabic + Inter (TTF, OFL) para fuera de línea, CI e impresión |
examples/workout-plan/ | Un producto completo hecho con Halo (sitio + 4 PDFs vectoriales). Solo referencia. |