Communitygithub.com

umby-discover

Realiza un descubrimiento quirúrgico y de alto impacto para el producto y la identidad visual antes de construir o rediseñar un sitio web o aplicación web. Elimina el contenido genérico de IA resolviendo la dirección de marca, las dudas del comprador, la prioridad de conversión, la tensión estética y los activos de prueba reales con 4 o 5 preguntas precisas, para luego fijar un Contrato Creativo y Funcional concreto. Úsalo al inicio de cualquier proyecto nuevo de sitio web/app, rebranding o solicitud de interfaz poco especificada.

¿Qué es umby-discover?

Umby Discover es un skill para agentes de IA (como Claude Code, Cursor o Codex) que realiza una fase de descubrimiento quirúrgico y de alta palanca antes de construir o rediseñar un sitio web o aplicación web. Su objetivo es evitar el contenido genérico de IA ("slop") resolviendo de manera eficiente los puntos críticos de dirección de marca, dudas del comprador, prioridad de conversión, tensión estética y activos de prueba reales. En lugar de someter al usuario a una larga encuesta de 20 preguntas, el agente primero audita los archivos del workspace (package.json, tokens CSS, activos de marca, rutas existentes) para no preguntar nada que el repositorio ya responda. Luego evalúa la solicitud contra cinco pilares (Trabajo y Acción Principal, Arquetipo Estético y Tensión, Prueba y Realidad de Contenido, Alcance Superficial y Stack, y Restricciones Brownfield) y, si faltan dos o más pilares, plantea de 3 a 5 preguntas quirúrgicas seleccionadas de un banco de preguntas. Estas preguntas ofrecen contrastes concretos (nunca preguntas abiertas como "¿qué colores te gustan?") y usan la interfaz de opción múltiple del entorno cuando está disponible. Finalmente, el agente redacta un Contrato Creativo y Funcional compacto (audiencia, escepticismo, acción principal, arquetipo, pares tipográficos, paleta OKLCH, ritmo de secciones y antimetas) y lo pasa a skills posteriores como umby-architect y umby-craft. Es ideal para proyectos greenfield, rebranding o solicitudes de UI poco especificadas, y soporta tanto ejecución autónoma como guiada por preguntas.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Umbylicus/umby-beast-code/tree/HEAD/skills/umby-discover

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Umby Discover: Brief Quirúrgico y Dirección Creativa

Se aplican las reglas permanentes. Antes de cambiar algo, lee ../umby-beast-code/references/standing-rules.md: compuertas de aprobación, sin deploy ni merge sin un visto bueno explícito, rama de funcionalidad con vista previa, código protegido, mantener o redirigir cada URL, solo pruebas reales y el registro de trabajo.

Los prompts genéricos obligan a los agentes a adivinar, y la suposición de un LLM es el promedio estadístico de internet. Tu trabajo aquí es fijar una identidad visual y de producto específica, con opinión y líder en su categoría antes de escribir una línea de código de componente, sin someter al usuario a una tediosa encuesta de 20 preguntas.


Paso 1: Separar los Hechos Observables de la Intención Faltante

  1. Revisa primero los archivos del workspace (package.json, tokens CSS existentes, activos de marca, README.md, rutas existentes). Nunca hagas una pregunta que el repositorio ya responda.
  2. Audita la solicitud del usuario contra los Cinco Pilares de un Brief No Genérico:
    • Pilar 1 — Trabajo y Acción Principal: ¿Quién llega aquí, qué escepticismo traen y cuál es la única acción que queremos que completen?
    • Pilar 2 — Arquetipo Estético y Tensión: ¿Dónde se sitúa visualmente esto? (Lee references/aesthetic-archetypes.md para conocer los 12 arquetipos no IA.)
    • Pilar 3 — Prueba y Realidad de Contenido: ¿Tenemos datos reales del producto, métricas, fotografía o mecánicas interactivas en vivo, o deberíamos construir una simulación interactiva honesta en lugar de relleno falso de "10,000+ clientes"?
    • Pilar 4 — Alcance Superficial y Stack: ¿Qué páginas/flujos pertenecen al Pase 1 y qué restricciones de stack aplican (velocidad estática de Astro vs. app interactiva de Next.js vs. Shopify headless)?
    • Pilar 5 — Restricciones Brownfield (Solo Actualizaciones): ¿Qué URL, logotipos, colores hexadecimales de marca o contratos de checkout/auth son sagrados?

Paso 2: Ejecutar la Puerta de Admisión de 4 a 5 Preguntas

Si faltan genuinamente 2 o más pilares (y el usuario no solicitó ejecución autónoma inmediata), haz una pausa antes de escribir código de UI y plantea de 3 a 5 preguntas quirúrgicas seleccionadas de references/question-bank.md.

Reglas para Hacer Buenas Preguntas de Descubrimiento

  • Usa la Interfaz de Preguntas del Anfitrión Cuando Esté Disponible: Si tu entorno proporciona una herramienta estructurada de preguntas de opción múltiple (ej. ask_question), úsala con 3 o 4 opciones concretas y contrastantes por pregunta, y coloca tu opción recomendada primero con el prefijo (Recomendado). De lo contrario, presenta una lista de texto plano numerada y limpia.
  • Ofrece Contrastes Concretos, No Tareas Abiertas: Nunca preguntes "¿Qué colores y fuentes te gustan?" En su lugar, ofrece pares direccionales definidos: ej., "(Recomendado) Monolito Oscuro de Precisión (calibre Linear/Raycast: obsidiana #0b0c0e, bordes finos y nítidos, un solo acento eléctrico, escenario interactivo del producto)" vs. "Luz Alta Editorial (calibre Stripe Press/Mercury: alabastro cálido #faf9f6, display serif editorial + cuerpo grotesco limpio, espaciado generoso tipo luz diurna)".
  • Máximo 5 Preguntas: Una ronda de preguntas precisas es vigorizante; tres rondas de detalles minuciosos se sienten como algo roto.

Paso 3: Fijar el Contrato Creativo y Funcional

Una vez que el usuario responda (o inmediatamente usando tu mejor coincidencia de arquetipo si estás operando bajo una concesión autónoma explícita), redacta el Contrato de Diseño y Producto compacto (ya sea en línea en 12 a 15 líneas o guardado en .umby/DESIGN_BRIEF.md en proyectos con múltiples rutas):

  1. Audiencia y Escepticismo: Una oración que nombre quién visita y la duda exacta que la página debe superar en 5 segundos.
  2. Acción Principal del Viewport: Exactamente una frase verbal de CTA principal (ej., "Iniciar sandbox interactivo", "Añadir bolsa de 250 g · $24").
  3. Arquetipo Elegido y 3 Referencias de Calidad: Arquetipo nombrado de references/aesthetic-archetypes.md + 3 productos reales cuyo nivel de calidad (nunca IP/activos copiados) ancla la construcción.
  4. Par Tipográfico y Escala: Familia de display + Familia de cuerpo + Familia mono, con pesos explícitos y reglas de tracking.
  5. Ancla de Paleta OKLCH: Luminosidad superficial base/matiz de tinte, tinta primaria, alfa de línea fina y el único color de acento de alta convicción.
  6. Secuencia de Ritmo de Secciones: Lista ordenada de 5 a 8 beats de página donde no hay dos secciones adyacentes que compartan la misma geometría de cuadrícula.
  7. Antimetas (Exclusiones Explícitas): 3 clichés específicos prohibidos para este proyecto (ej., "Sin brillo SaaS púrpura-azul, sin fila de 3 columnas con iconos de Lucide, sin fotos de clientes no verificadas").

Pasa este contrato directamente a ../umby-architect/SKILL.md y ../umby-craft/SKILL.md.

Skills relacionados