¿Qué hace app-design-studio?
Objetivo: a partir de un nombre de aplicación, producir un repositorio de diseño que sea hermoso y usable al mismo tiempo, consistente en todas las pantallas y listo para entregar a un diseñador, a un agente que construya Compose/Flutter/React Native, o al puente Compose-to-Figma.
Por qué existe esta habilidad: los modelos de imagen dibujan pantallas individuales atractivas pero se desvían entre pantallas, olvidan estados y rompen silenciosamente la usabilidad (texto pequeño, bajo contraste, objetivos táctiles reducidos). Solución: fijar primero un sistema de diseño, generar a partir de él y luego verificar lo que se puede medir con scripts y lo que no (el gusto) con una rúbrica más una selección humana.
Objetivo = perfil (decidir PRIMERO, en S0; nunca establecer por defecto en silencio cuando el usuario dijo sitio web/portal/dashboard)
| Objetivo | Orientación / tamaños | Leer estos (y SÓLO estos para la redacción del objetivo) |
|---|---|---|
mobile (app) | retrato 9:19.5 pantallas, un tamaño | screen-taxonomy.md, bloques mobile de design-bible-template.md y prompt-templates/README.md, suelos en dp/sp |
web tipo site (sitio web, aterrizaje, tienda, blog) | horizontal escritorio 16:10 (1440x900) páginas, más un diseño responsivo estrecho de 390px de la misma página | web-design.md, prompt-templates/web.md, bloque web de design-bible-template.md, suelos en px |
web tipo app (portal, dashboard, admin, SaaS) | horizontal escritorio primero; diseño estrecho después. Solo si el usuario dice que los teléfonos son el dispositivo principal, establecer "mobile_first": true y hacer que el diseño estrecho sea el principal | igual que site |
both | una biblia y tokens compartidos, dos perfiles | ambos conjuntos, nunca mezclados dentro de un mismo prompt |
| Establecer `"platform": "mobile" | "web"eninventory.json`. Un prompt se escribe exactamente con el vocabulario de un perfil. |
Higiene de palabras clave (la razón por la que existe esta sección): los modelos de imagen obedecen las palabras que se les dan. Un prompt de sitio web que diga "retrato", "teléfono", "barra de estado", "9:19.5", "navegación inferior", "zona del pulgar", "Android/iOS" o "pantalla de app" devuelve una pantalla de teléfono. Los prompts web dicen "página web", "escritorio horizontal 16:10, 1440 de ancho", "cabecera con enlaces", "barra lateral", "sin navegador". El diseño estrecho se llama "diseño responsivo estrecho, 390px de ancho", nunca "pantalla de teléfono". python scripts/prompt_lint.py <design-dir> falla cualquier prompt en prompts/ que use palabras de otro perfil; ejecutarlo antes de enviar un lote.
Reglas de salida (siempre)
- La imagen es la interfaz en sí, de borde a borde: sin marco de dispositivo, sin maqueta de teléfono/portátil, sin marco del navegador, sin fondo extra, sin lienzo alrededor. (Marcos de presentación solo si el usuario pide paneles.) Móvil: pantallas en retrato. Web: páginas de escritorio en horizontal y, donde se indique, el diseño estrecho; páginas largas como una sola imagen alta o 2-3 imágenes de sección del mismo ancho.
- Los ejemplos en esta habilidad son ilustraciones de un patrón, nunca contenido: no copiar sus nombres, copia, paletas, tipografía o diseños en un prompt (guía contra sesgos en
references/design-craft.md). - Alta fidelidad: copia real, iconos reales, imágenes reales. Sin lorem ipsum, sin nombres de marca placeholder.
- Un sistema de diseño en todo el conjunto. Nunca inventar un nuevo estilo por pantalla.
- Dos modos de prompt (
references/design-craft.md): brief (intención corta + los pocos datos que importan + la sensación; por defecto para primeros renders y direcciones S2, da el resultado más distintivo) y locked (cadenas exactas, recuentos, bloque de biblia; para hermanos después de la selección y correcciones). Renderizar brief primero, mirar, luego bloquear lo que debe coincidir. Los modelos fallan mucho más en consistencia que en belleza, pero sobre-constreñir el primer render lo vuelve mecánico. - Editar, no regenerar: corregir una cadena incorrecta con un pase de edición nombrando solo ese cambio; una regeneración completa tira todo lo ya aprobado.
- Sin marcas reales, logotipos o rostros de personas reales; solo nombres ficticios y marcas genéricas. Nunca escribir claves API en el repositorio.
- Responder al usuario en el idioma en que escribe (a menudo urdu romanizado/hinglish); los archivos y prompts permanecen en inglés.
Flujo de trabajo (S0-S9)
Trabajar en la carpeta del proyecto del usuario bajo design/<app-slug>/ (estructura: references/repo-layout.md). Registrar el estado de la fase en design/<app-slug>/STATUS.md. Preguntar al usuario solo cuando la respuesta cambie el resultado (máx. 3 preguntas en S0); de lo contrario, elegir un valor predeterminado sensato y decirlo.
S0 Toma de requisitos. Nombre de la app/sitio, propósito en una línea, audiencia, objetivo + tipo (tabla anterior; preguntar si aparecen las palabras "sitio web", "portal", "dashboard" o "aterrizaje" y el objetivo no está claro), sensación de plataforma (móvil por defecto: Android + iOS neutro, Material 3 tirando; web: neutro), palabras de tono, claro/oscuro (por defecto: tokens claro + oscuro, pantallas en claro). Escribir BRIEF.md (problema, audiencia, alcance, no objetivos); si el usuario no está disponible, indicar la interpretación que se tomó al principio en lugar de esperar. Leer references/aesthetic-vs-usability.md una vez.
S1 Inventario de pantallas. Construir inventory.json desde references/screen-taxonomy.md (web: references/web-design.md sección 4): núcleo fijo (splash, idioma, onboarding, permisos, autenticación, inicio, ajustes) + pantallas de características específicas de esta app + detalles + estados + diálogos + hojas + componentes. Cada elemento tiene id, grupo, propósito, estados, prioridad. Mostrar al usuario una lista compacta; confirmar antes de gastar créditos de imagen.
S2 Plan de diseño + biblia + 3 direcciones (puerta humana). Primero escribir un plan de diseño de 10 líneas por dirección (references/design-craft.md sección 2) y autoevaluarlo contra los valores predeterminados genéricos. Luego escribir la biblia (references/design-bible-template.md) como tres alternativas cortas (diferente estado de ánimo, lógica de paleta, tipo, lenguaje de formas). Cada biblia nombra el color del texto sobre cada color relleno (sobre-primario, sobre-acento, texto de insignia) y la barra de estado de la plataforma (Android: hora a la izquierda, iconos a la derecha; iOS: estilo 9:41). Antes de renderizar, poner la paleta de cada dirección en un pequeño archivo de tokens y ejecutar scripts/contrast_check.py sobre él: una dirección que solo se vea bien con contraste deficiente no debe llegar a la selección humana. Escribir cada prompt en prompts/<id>.<direction>.md primero y enviar exactamente el texto de ese archivo (el prompt guardado es el reproducible). Renderizar una pantalla principal por dirección (web: la misma página, escritorio y móvil). Enviar las tres en una sola llamada de Codex. Detenerse y dejar que el usuario elija - el gusto es lo único que los scripts no pueden juzgar, así que aquí es donde el humano decide. Registrar la elección en DESIGN.md.
S3 Tokens. Desde la dirección elegida escribir tokens.json (colores claro/oscuro, escala tipográfica, espaciado cuadrícula 4/8, radio, elevación, tamaño de icono, objetivo táctil). Ejecutar scripts/contrast_check.py tokens.json y corregir los pares que fallen ahora - más barato que corregir 40 pantallas después.
S4 Panel de componentes. Generar la hoja de componentes (botones, campos de entrada, chips, tarjetas, filas de lista, navegación, barra superior, toasts, diálogos, hojas) a partir de los tokens. Esta imagen es la referencia visual pasada a cada generación posterior, lo que mantiene las pantallas consistentes.
S5 Pantallas. Generar pantallas en orden de inventario usando references/prompt-templates/. Cada prompt comienza con el bloque de biblia bloqueado, luego cadenas y recuentos exactos, luego una lista explícita "no añadir". Elegir el motor según el trabajo: un modelo con capacidad de texto (gpt-image/Codex, Nano Banana, Stitch) para pantallas completas, o la ruta de renderizado HTML (texto y recuentos exactos, luego captura de pantalla; probado de extremo a extremo en un conjunto de 21 pantallas de lector de PDF: escribir html/<group>/<id>.html desde variables CSS de tokens.json e iconos Iconify, luego node scripts/render_screens.mjs <design-dir> escribe el PNG más un <id>.spec.json medido desde el DOM real, y run_gates.py lo audita; necesita Node + playwright, env PLAYWRIGHT_MODULE/CHROME_PATH si no está instalado localmente) - FLUX/Runware distorsiona el texto y los recuentos de la interfaz, así que usarlo solo para arte que va dentro de una pantalla. Usar Iconify MCP para los iconos para que el estilo de icono siga siendo una familia. Pasar el panel de componentes como referencia de estilo cuando la herramienta lo permita. Guardar como screens/<group>/<id>.png más <id>.spec.json (elementos con tamaño, tamaño de fuente, colores, indicador interactivo - esquema en references/repo-layout.md).
S6 Estados, diálogos, hojas. Mismos prompts, misma biblia. Los estados vacíos guían la siguiente acción; el error es visualmente diferente de vacío; la carga utiliza esqueletos que coinciden con el diseño real.
S7 Autocrítica, veredictos y registro de prompts. Criticar cada renderización uno mismo antes de mostrarla (references/critique-template.md: aprobado/fallido de usabilidad con evidencia + rúbrica estética, escrito en reports/critique/<id>.md); por debajo de 4.0 o cualquier FALLO de usabilidad significa corregir mediante pase de edición o rechazar y regenerar, sin esperar al usuario. Después de mirar CADA imagen generada escribir un veredicto (aceptar / corregir / rechazar) y registrarlo: python scripts/prompt_log.py add <design-dir> --id ... --image ... --prompt ... --mode brief|locked|edit --verdict ... --tags ... --reason ...; las imágenes rechazadas se mueven a rejected/. prompt_log.py summary muestra la tasa de aceptación por modo de prompt y las etiquetas de fallo recurrentes; cualquier etiqueta rechazada dos veces se convierte en una línea en references/design-craft.md "Lecciones aprendidas" (así es como la habilidad mejora). Luego ejecutar python scripts/run_gates.py design/<app-slug>. Ejecuta contraste, lint de tokens, auditoría de elementos (objetivos táctiles, tamaño de texto mínimo) y cobertura de estados, y escribe reports/gates.md. Luego puntuar cada pantalla con la rúbrica en references/aesthetic-vs-usability.md (abrir el PNG y mirar - no puntuar de memoria). Regenerar las pantallas que fallen, máximo 2 intentos cada una; si siguen fallando, marcarlo para el usuario en lugar de repetir.
S8 Exportación. Ensamblar el repositorio (references/repo-layout.md): PNGs, especificaciones, tokens, DESIGN.md, inventario, mapa de flujo, copy/strings.json, informes. Extras opcionales, solo cuando el usuario los quiera: (a) capa de verdad HTML para valores CSS exactos (references/image-qa-loop.md), (b) almacenar activos - icono, gráfico de características, capturas de pantalla de la tienda con titulares renderizados como texto HTML, validados por scripts/validate_assets.py contra references/store-asset-specs.md. Para capturas de pantalla de marketing de la tienda (conjuntos liderados por titulares como aplicaciones de los primeros puestos) usar la habilidad store-screenshots con estas pantallas como entrada. Entrega opcional: tokens/especificaciones alimentan el código Compose + puente Figma; decirlo en HANDOFF.md.
S9 Revisión humana. Presentar la hoja de contactos y el informe de puertas. Cualquier cosa generada antes de que exista la aplicación real se etiqueta como concept (nunca presentar gráficos de tienda conceptuales como capturas reales).
Guía de juicio (estética vs usabilidad)
Los suelos dependen del objetivo: móvil = números dp/sp a continuación; web = suelos px en references/web-design.md sección 3 (área de impacto de 44px, cuerpo >= 16px, líneas de 65 caracteres, sin desplazamiento horizontal a 390). Tratar la usabilidad como un suelo y la estética como el techo. Los números de suelo no son negociables porque son medibles: objetivos táctiles >= 48dp (44pt iOS), texto del cuerpo >= 16sp y nada por debajo de 12sp, contraste 4.5:1 (3:1 para texto grande e iconos), una acción principal por pantalla, acciones clave en la zona inferior del pulgar, cuadrícula de espaciado 4/8. Por encima del suelo, gastar personalidad: un emparejamiento tipográfico distintivo, un acento controlado, un momento memorable de ilustración o imagen por flujo, espaciado generoso. Cuando entren en conflicto (por ejemplo, una etiqueta elegante gris pálido), la usabilidad gana y se recupera la elegancia en otro lugar (peso, espaciado, contraste de tamaño), no bajando el suelo.
Evitar ("marcas de IA")
Leer references/design-craft.md, references/interaction-and-density.md y references/ai-tells-avoid.md antes de escribir el primer prompt (los breves indican el objetivo de densidad: pocas palabras, espacio generoso, una acción principal). La versión corta: degradados púrpura-azul, tarjetas de vidrio sin motivo, anidación caja-en-caja, spam de gráficos falsos, pantallas de inicio con doce widgets, mezclas genéricas de paquetes de iconos, pequeñas etiquetas decorativas, lorem ipsum, pantallas clonadas con pequeñas ediciones.
Mapa de referencias
references/screen-taxonomy.md- qué pantallas/estados/diálogos/hojas existen y cuándo (solo objetivo MÓVIL).references/web-design.md- objetivo sitio web / aplicación web: viewports, suelos px, taxonomía de páginas, diseño, marcas de IA web.references/prompt-templates/web.md- bloques de FORMATO/CONTENIDO web y prompts por tipo de página.references/aesthetic-vs-usability.md- diales, suelos, rúbrica, reglas de regeneración.references/design-bible-template.md- el bloque repetido en cada prompt.references/prompt-templates/- prompts por tipo de pantalla.references/design-craft.md- prompts breves vs bloqueados, plan de diseño, valores predeterminados genéricos, audacia en un solo lugar, reglas de copia, bucle de crítica.references/ai-tells-avoid.md- antipatrones.references/repo-layout.md- estructura de carpetas y esquemas JSON.references/image-qa-loop.md- el bucle de verificación/edición por imagen, capa de verdad HTML opcional, strings.json.references/store-asset-specs.md- tamaños y reglas de Play/App Store (revisar páginas oficiales antes de enviar).references/interaction-and-density.md- presupuesto de palabras/densidad, revelación progresiva, estado de interacción visible, preguntas de revisión (usar en cada breve y crítica).references/critique-template.md- el bucle de autocrítica y corrección por imagen.scripts/prompt_log.py- registro de veredictos + resumen de aprendizajes (ver S7).assets/- ejemplo detokens.json,inventory.json,spec.json, esqueleto deDESIGN.md.scripts/- puertas deterministas (Python):contrast_check.py,run_gates.py,render_screens.mjs,prompt_lint.py,validate_assets.py,prompt_log.py.templates/-screen.html.mustache,spec.json.mustache.ai-tells-avoid.md- patrones de interfaz que delatan a la IA (guardar como referencia).
Nota del traductor
El texto de los archivos, prompts y código permanece en inglés tal como se especifica en las reglas. La documentación traducida aquí es para que el usuario humano entienda la habilidad en su idioma.