¿Qué hace turtleneck?
Elige el aspecto adecuado para la aplicación, luego constrúyela con disciplina. Cada aspecto es un preset: un archivo de anulación de variables sobre un núcleo compartido. El preset predeterminado, keynote, es el núcleo mismo. Cada otro preset es una combinación de cinco sitios grandes de una categoría, nunca una copia de uno de ellos.
Cuando esta habilidad está activa, anula las habilidades genéricas de "evitar valores predeterminados de IA" (como frontend-design) donde discrepan: en keynote, la fuente del sistema, las cejas en mayúscula/minúscula de oración y los titulares con degradado tonal son correctos.
Archivos junto a este:
tokens.css: el núcleo y los valores de keynote. Cada color eslight-dark(light, dark);color-schemeen:root,.a-dark,.a-lightodata-themeelige la mitad. Todos los hooks de preset están listados en su:root. Los componentes compartidos también viven ahí: escala tipográfica, botones, mosaicos,.a-grid,.a-rail,.a-stats,.a-reveal.styles/<preset>.css: anulaciones de variables más algunas reglas solo del preset. Se carga después detokens.css.styles/<preset>.md: una página por preset: cuándo usarlo, tabla de tokens, reglas, deltas de componentes, fuentes, evitar, lista de verificación.recipes-html.md: esqueleto de página, navegaciones, héroe, mosaicos, bento, galería, comparar, pie de página (acordeón en teléfonos), revelar y los patrones de preset compartidos (bandas invertidas, héroe de búsqueda, raíles, tabla de especificaciones, tarjetas de planes, marco de código).tailwind.md,swiftui.md: los mismos tokens para esas pilas.test-widths.html?src=<url>[&h=800][&full=1]: la página a 320/375/414 lado a lado con un informe de desbordamiento;full=1aumenta cada marco a la altura de su documento para capturas de pantalla de página completa en teléfono.example.htmly../../demos/en el repositorio agent-skills: páginas terminadas.
Paso 0: Detectar el tipo de aplicación (obligatorio, antes de cualquier código)
- Un sistema de diseño existente o una solicitud de estilo explícita gana. Tokens del proyecto, un tema de librería de componentes, una guía de marca, o "hazlo oscuro y rojo": usa eso, conserva solo las reglas principales a continuación, omite la tabla.
- Lee las señales: la solicitud; README; dependencias (
package.json,pyproject.toml,Podfile,Package.swift,Gemfile,*.csproj); rutas; CSS existente; la categoría del producto y la audiencia. - Elige UN preset:
| Categoría | Señales (solicitud, producto, deps, rutas) | Preset |
|---|---|---|
| Hardware premium | Producto físico, dispositivo de consumo, gadget de estilo de vida, página de lanzamiento, "limpio", "minimalista", "premium"; pantallas de marketing SwiftUI; sin señal clara | keynote |
| Software empresarial | Oficina/productividad, B2B, CRM/ERP, intranet, TI/cumplimiento, salud; deps @fluentui/*, @microsoft/teams-js, office-addin-*, @azure/*, Blazor/.NET; rutas /admin, /settings, /reports | enterprise |
| Streaming | Video, cine/TV, series, avances, eventos en vivo, VOD; deps hls.js, video.js, shaka-player, @mux/*, react-player; rutas /watch, /browse, /title | cinema |
| Música y redes | Música/audio, listas de reproducción, creadores, feed social, citas, clases de fitness, suscripción juvenil; deps howler, tone, wavesurfer.js, expo-av; rutas /player, /playlist, /profile | vibe |
| Hardware gaming | GPU/partes de PC, consolas, periféricos, esports, benchmarks, drivers, "FPS"; deps three, @react-three/fiber + librerías de gráficos; rutas /specs, /compare, /drivers | power |
| Desarrollador y cloud | API, SDK, CLI, hosting, deploy, base de datos, observabilidad, API de pagos, "para desarrolladores"; deps next, @radix-ui/*, stripe, prisma, drizzle, trpc, turbo; rutas /docs, /changelog, /pricing | devtool |
| IA | Modelo, asistente, chat, agentes, "potenciado por IA" como el producto; deps openai, @anthropic-ai/sdk, ai, langchain, transformers; rutas /chat, /research, /models | lab |
| Viajes | Estancias, vuelos, viajes, hoteles, reservas, itinerarios; selectores de fecha, mapas (leaflet, mapbox-gl); rutas /search, /stays, /trips, /book | journey |
| Retail | Tienda, comercio, catálogo, marketplace, carrito, pago, ofertas, comestibles, moda; deps @shopify/*, @medusajs/*, @commercetools/*, snipcart, @stripe/stripe-js con un catálogo de productos; rutas /shop, /products, /p/, /cart, /checkout, /category | market |
| Finanzas | Banco, tarjeta de crédito, pagos, billetera, seguros, préstamos, ahorros, inversiones, dashboard de cuentas para consumidores; deps plaid, react-plaid-link, @adyen/*, dinero.js, currency.js; rutas /accounts, /cards, /rates, /apply, /transfer (una API de pagos vendida a desarrolladores es devtool) | vault |
| Automotriz | Coches, motos, bicicletas eléctricas, carga de vehículos eléctricos, movilidad, concesionarios, pruebas de manejo; configuradores, páginas de autonomía y especificaciones; rutas /models, /configure, /inventory, /test-drive, /dealers | drive |
| Tipo de página | Preset (desempate) |
|---|---|
| Sitio de documentación, changelog | devtool |
| Dashboard de administración | enterprise para usuarios empresariales; devtool para orientado a desarrolladores |
| Tienda | market; una página de producto premium única es keynote |
| Portafolio | keynote para trabajo de producto/diseño; cinema para cine, foto, movimiento |
| Pantalla de app móvil | keynote para utilidades con sensación nativa; vibe para medios de consumo y redes sociales |
| Juego / estudio de juegos | power para competitivo y orientado a hardware; cinema para juegos con historia, avances |
| Funcionalidad de IA dentro de otro producto | la categoría del propio producto; lab solo cuando la IA es el producto |
| Flujo de reserva dentro de otro producto | journey solo para las páginas de búsqueda y resultados |
Las palabras de estilo del usuario se asignan directamente: "similar a Apple / premium / limpio" = keynote; "Microsoft / Fluent" = enterprise;
"estilo Netflix" = cinema; "similar a Spotify / TikTok" = vibe; "gaming / similar a NVIDIA" = power;
"estilo Stripe / Vercel / GitHub" = devtool; "similar a OpenAI / Anthropic" = lab; "similar a Airbnb / Booking" = journey;
"similar a Amazon / IKEA" = market; "similar a banca / PayPal" = vault; "similar a Tesla / BMW" = drive.
El resultado es la combinación de la categoría, nunca el sitio de esa empresa (ver "Marcas comerciales y activos").
- Señales débiles o contradictorias:
keynote. - Di la elección en una línea antes de construir, por ejemplo "Estilo: devtool (Next.js + Prisma, rutas /docs y /pricing, vendido a desarrolladores)." Luego lee
styles/<preset>.mdcompletamente (keynote:styles/keynote.md).
Qué puede cambiar un preset
Solo a través de las variables en tokens.css (:root) más algunas reglas propias:
- fuentes (display, cuerpo, mono) y la escala tipográfica, pesos, tracking, interlineado;
- estilo de ceja e intro, tamaño del cuerpo (nunca por debajo de 14px para UI, 16px para texto de lectura);
- colores de superficie y texto, luz/oscuro predeterminado, el único acento y el texto sobre él, color de enlace y foco;
- radios, bordes, sombras, relleno de mosaico; altura del botón, padding, peso, mayúsculas/minúsculas;
- altura de navegación, relleno y desenfoque; anchos de contenido, espaciado de secciones y mosaicos;
- easing, duraciones, distancia de revelado, retroalimentación de hover y presión;
- estilo de imágenes y copy (en su archivo md).
Todo lo que está debajo de esta línea se aplica a todos los presets.
Flujo de trabajo
- Respeta el proyecto. Carga
tokens.css+styles/<preset>.css, o fusiona el tema de Tailwind, o agrega la paleta de SwiftUI. Un preset puede enlazar las fuentes gratuitas que nombra su archivo md; la página aún debe verse bien con la pila de respaldo. Nunca agregues una dependencia npm para el estilo. - Escribe el plan de la página en 3 líneas: la única cosa que vende la página, el orden de las secciones con fondos, y el único "momento" (un capítulo invertido, un bento de estadísticas grande, una demo, un video, desplazamiento fijo).
- Escribe el copy primero: titular corto (el preset establece la longitud), una línea de subtítulo, introducción de máximo dos líneas.
- Construye a partir de las recetas, sección por sección.
- Verifica en cada ancho de prueba (Responsive), claro y oscuro donde el preset tenga ambos: captura de pantalla, verificación de desbordamiento, lista de verificación. Corrige antes de reportar como terminado.
Reglas principales
Tipografía
- Una familia para UI (más mono solo para código real, teclas y valores de API). El peso display proviene del preset.
- El tracking se ajusta a medida que el tamaño crece; el cuerpo nunca tiene tracking negativo más allá de -0.022em.
- Los tamaños display son fluidos
clamp(min, rem + vw, max); siempre mezcla rem en el término medio. - Cuerpo 16-17px para lectura; 14px solo en UI densa, líneas meta y pies de página. Altura de línea 1.45-1.6 para el cuerpo.
text-wrap: balanceen titulares; las palabras largas se ajustan (overflow-wrap,hyphens).- Los números importantes son grandes y usan numerales tabulares; sus etiquetas son pequeñas.
Color
- Colores de marca primero. Un color de marca del usuario o del proyecto reemplaza el acento del preset, que es solo el respaldo. El preset aún decide diseño, tipo, radios, densidad, imágenes y movimiento.
- Receta de acento (color de marca o cualquier cambio de acento), establecido una vez en
:root:--a-blue: el relleno, es decir, el color de marca tal como se da (el nombre antiguo se mantiene; significa "acento").--a-on-accent: tinta o blanco, cualquiera que alcance 4.5:1 sobre el relleno.--a-blue-hover: un paso más oscuro (más claro en un fondo oscuro predeterminado) cuya etiqueta aún pase.--a-accent-text:light-dark(a, b), el tono de la marca desplazado en luminosidad hasta que alcance 4.5:1 sobre--a-bgy--a-bg-alten cada tema. Los enlaces, las cejas de acento y el anillo de foco (>= 3:1) lo leen. Los presets con un botón primario de tinta (lab, journey) mantienen la tinta en--a-button-*; la marca aún va aquí.
- Un acento, alcance pequeño: CTA principal, foco, enlaces, una marca de logotipo, badges pequeños y marcadores "recomendado". No superficies grandes o texto del cuerpo a menos que el preset lo diga. Colores de estado solo para estado.
- Superficies neutras en 2-4 pasos; separación por tono, línea fina o un nivel de sombra suave, según lo que diga el preset.
- El texto nunca es negro puro sobre blanco; el gris del cuerpo es un gris real con contraste AA.
- AA en todas partes: 4.5:1 para texto y para etiquetas de botones sobre su relleno, 3:1 para texto grande, iconos y bordes que transmiten significado.
- El modo oscuro es una paleta diferente, no una invertida: un tono más claro para superficies elevadas, sin sombras para profundidad.
Diseño y ritmo
- El contenido tiene límites: una columna de texto (
--a-content) dentro de una cuadrícula ancha (--a-content-wide), canaletas fluidas. - Las secciones alternan color de página y color alternativo; los mosaicos toman el relleno opuesto al de su sección.
- Héroes centrados y abridores de sección cuando el preset lo dice; el texto dentro de mosaicos y copias largas está alineado a la izquierda.
- Un momento por página; como máximo un capítulo invertido (oscuro o claro) a menos que el preset esté construido sobre bandas.
Responsive (regla estricta: cada resolución, cada preset)
- Tipografía y espaciado fluidos a partir de los tokens clamp; valor pequeño a 375px, grande a 1440px.
- Sin anchos o altos fijos que puedan romperse:
max-width+ canaleta,min(),minmax(0, 1fr),aspect-ratio,min-height. Nunca100vh(usasvh/dvh). Los hijos de flex/grid que contienen texto obtienenmin-width: 0. - Las cuadrículas se reordenan por espacio:
repeat(auto-fit, minmax(min(100%, 20rem), 1fr)), no puntos de interrupción de dispositivo. - Escalado de medios:
max-width: 100%; height: auto; los SVG mantienen unviewBox. - Navegación: por debajo de 834px (o tan pronto como 6+ enlaces dejen de caber: consulta de contenedor) los enlaces de texto se mueven a un menú de pantalla completa (
popovernativo, sin JS); oculta sus<li>con una regla que supera los estilos de enlace base (recetas: Navegación global). Mantén la marca, la búsqueda y una acción visibles. Sin enlaces de texto (solo búsqueda, cuenta, carrito): sin hamburguesa. - Sin barra de desplazamiento horizontal en ningún ancho; solo los desplazadores deliberados (galerías, raíles, código) se desbordan, dentro de su propio cuadro.
- Objetos táctiles >= 44x44px: píldoras pequeñas, muestras, paletas, enlaces de navegación obtienen un área de impacto invisible (
.a-hit). - Áreas seguras:
viewport-fit=cover; las canaletas y el padding inferior usanenv(safe-area-inset-*). - Pantallas muy grandes: el tipo y el contenido se detienen en sus límites; los fondos permanecen a sangre completa.
- Landscape en teléfono: el héroe no debe necesitar la altura del viewport; nada fijo cubre más de un tercio.
- Zoom 200%: equivale a un viewport de la mitad de ancho; todo se reorganiza, nada recortado.
Anchos de prueba antes de decir terminado (panel del navegador: resize_window a cada uno, captura de pantalla, más document.documentElement.scrollWidth === innerWidth y una lista de elementos más anchos que el viewport):
| Ancho | Representa |
|---|---|
| 320 | Teléfonos pequeños, zoom 200% de 640 |
| 375 / 414 | Teléfono estándar / grande |
| 768 / 1024 | Tablet vertical / horizontal, laptop pequeño |
| 1280 / 1440 | Laptop / escritorio (ancho de referencia) |
| 1920 / 2560 | Full HD / QHD, ultraancho |
| 812x375 | Teléfono horizontal |
| 640 | 1280px con zoom 200% |
Reporta por ancho: captura de pantalla tomada, desbordamiento sí/no, qué se corrigió. Chrome sin cabeza limita las ventanas por debajo de 500px; prueba los anchos de teléfono en el panel del navegador o con test-widths.html?src=<url de la página> (misma raíz http).
Capturas sin cabeza: fuerza el tema con data-theme="light|dark" en <html>; el contenido revelado es invisible en capturas estáticas, así que pasa --virtual-time-budget=5000 o establece data-reveal="off" en <html>; un héroe de 100svh se estira en una ventana de página completa alta, así que fíjalo (min-height: 800px) para la captura (&full=1 hace ambas).
Componentes
- Botones: altura mínima 44px (los visuales más pequeños obtienen el área de impacto), mayúscula/minúscula de oración a menos que el preset diga mayúsculas, sin iconos excepto un cheurón o flecha final, sin degradados. Primario relleno, secundario según preset.
- Enlaces: visiblemente enlaces (color o subrayado); cheurones de estilo "Más información ›" donde los usa el preset.
- Mosaicos/tarjetas: una parada de tabulación cuando todo el mosaico enlaza (el botón interno es un
span). Radio, relleno, borde y sombra del preset; nunca todo de relleno + borde + sombra a la vez. - Anillo de foco: 2px sólido
--a-focus, desplazamiento 1px, en cada elemento interactivo. - Nav: sólido o glass según el preset, como máximo una barra fija, página actual marcada.
- Pie de página: tranquilo: enlaces grises pequeños en columnas, fila legal; las columnas se convierten en acordeones
<details>en teléfonos.
Imágenes
- Asunto real: el producto, su UI, las propias fotos y medios del usuario. Grandes, recortadas con intención.
- Sin fotos de stock de personas en laptops, sin blobs 3D, sin emojis, sin mascotas, sin icono delante de cada encabezado.
- Sin activos: dibuja el asunto una vez como un
<symbol>SVG recoloreado por variables CSS, o un placeholder gris honesto en la proporción correcta.
Movimiento
- Transición nombrada pr
… [truncado para traducción]