Communitygithub.com

bushnell

Diseña divulgación progresiva que brinda valor inmediato a principiantes y profundidad significativa a usuarios experimentados. Úsalo para desgloses, visualizaciones en capas, navegación, paneles y experiencias de uso repetido; evalúa tanto el primer encuentro como el centésimo uso.

¿Qué es bushnell?

Este skill, basado en el principio de diseño conocido como Ley de Bushnell, te ayuda a crear experiencias de software que sean fáciles de aprender pero difíciles de dominar. Está diseñado para developers y diseñadores de producto que trabajan con agentes de IA como Claude Code, Cursor o Codex, y se enfoca en diseñar cómo se revela la profundidad de una función: desde la primera impresión hasta el uso experto repetido. El skill estructura el proceso en torno a dos recompensas clave (la del primer encuentro y la del centésimo uso) y una escalera de divulgación con capas que van desde la superficie inicial hasta la maquinaria interna. Además, proporciona pautas concretas sobre contratos de interacción, comportamiento esperado del sistema y legibilidad de conceptos poco familiares. Es especialmente útil para diseñar drill-downs, visualizaciones en capas, navegación, dashboards y cualquier experiencia que se use repetidamente, evaluando tanto el primer contacto como el uso sostenido. El enfoque es práctico: incluye un flujo de trabajo paso a paso, ejemplos de aplicación recursiva y una lista de prácticas que evitar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jwexler10/bushnell-skill/tree/HEAD/skills/bushnell

Preguntar en tu IA favorita

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

Documentación

Bushnell — Valor Inmediato, Profundidad Duradera

Aplica el principio de diseño comúnmente llamado Ley de Bushnell: fácil de aprender, difícil de dominar. Para un producto, esto significa entendido en segundos, gratificante a lo largo del uso repetido. El dominio debe crecer a partir de una comprensión más rica, no de descifrar la interfaz.

Usa este skill para diseñar cómo se despliega la profundidad. Establece primero el propósito de la función y su usabilidad básica. No se requiere ningún skill complementario, librería de componentes o estructura de repositorio.

Define ambas recompensas

Recompensa del primer encuentro: lo que un usuario nuevo entiende o gana en los primeros segundos, antes de aprender los controles o explorar detalles. Un gráfico puede hacer que una tendencia sea visible de inmediato; una herramienta de creación puede proporcionar un resultado inicial útil.

Recompensa del centésimo uso: lo que sigue siendo significativo después de la familiaridad. Las fuentes útiles incluyen mayor precisión, nuevas relaciones entre objetos familiares, evidencia detrás de una afirmación, combinaciones expresivas y cambios en los propios datos o trabajo del usuario.

No ofrezcas el mismo resumen dos veces a diferentes tamaños. La capa más profunda debe responder una nueva pregunta o respaldar una nueva acción.

Construye una escalera de divulgación

La superficie inicial responde la pregunta común. Una acción explícita y descubrible abre una pregunta menos común. Elige el punto de división según las necesidades del usuario, no según cómo almacena los datos el backend.

CapaContenido adecuadoObligación de diseño
Superficie inicialResultado principal, visualización primaria, estado esencialComunicar valor sin interacción exploratoria.
Precisión bajo demandaValores exactos, definiciones, comparacionesSoportar acceso con puntero, teclado y táctil según corresponda; evitar elementos esenciales solo al pasar el ratón.
InvestigaciónMiembros, ejemplos, objetos relacionados, detalles editablesHacer que el desencadenante y su resultado sean predecibles.
Evidencia o métodoFuentes, cálculos, incertidumbre, limitacionesMantenerlo disponible y comprensible sin abrumar la tarea principal.
Maquinaria internaPuntuaciones e identificadores solo de implementaciónExponer solo si ayudan en la tarea del usuario, con etiquetas significativas.

Estos son roles, no widgets obligatorios. Colapsar una sección no crea profundidad por sí mismo; ayuda solo cuando el contenido inicial es útil y el contenido revelado responde una pregunta de seguimiento significativa.

Aplica el principio recursivamente

Una función con varias capas de profundidad aún necesita un punto de entrada comprensible y una razón para explorar. Por ejemplo:

vista general -> seleccionar un grupo -> inspeccionar un miembro -> inspeccionar evidencia de respaldo

Cada transición debe aumentar la comprensión mientras preserva la orientación. Puede requerirse más curiosidad; no debería requerirse más alfabetización de interfaz.

La profundidad proviene de relaciones significativas entre unos pocos elementos comprensibles, no del número de paneles, controles o términos inventados. La gramática visual de un diagrama no debe implicar una relación, como causalidad, que la evidencia no pueda respaldar.

Haz explícito el contrato de interacción

  • Resolver gestos en conflicto. Definir qué hacen la selección, el arrastre, los clics en el fondo, la búsqueda y la navegación cuando coexisten. Evitar la activación accidental.
  • Preservar el contexto. Una capa más profunda debe retener el padre u ofrecer una forma obvia de volver con el estado relevante intacto. Usar paneles adyacentes, migas de pan, una pila u otro patrón apropiado para el dispositivo y la tarea.
  • Responder a la pregunta que se hizo. Seleccionar un elemento dentro de un grupo debe explicar ese elemento en ese contexto. Ofrecer su historial más amplio como una ruta separada.
  • Reutilizar contenedores establecidos. Agregar un nuevo sujeto a un patrón de detalle existente antes de introducir otro sistema de navegación.
  • Revelar deliberadamente. Evitar carteles permanentes que dominen la superficie para responder una pregunta poco común.
  • Plegar honestamente. Indicar recuentos o alcance omitidos. Expandir una lista no debe cambiar silenciosamente el significado o la escala de la información ya mostrada.
  • Hacer visible la recuperación. Proporcionar cerrar, retroceder, restablecer o deshacer cuando sea relevante. Preservar los ajustes deliberados del usuario a menos que él decida restablecerlos.

Adaptar el diseño exacto y los gestos a las necesidades de accesibilidad y al espacio disponible. Una disposición de escritorio no es un requisito para una pantalla pequeña.

Diseña el comportamiento que el sistema crea

Preguntar qué harán las personas, no solo qué permite la función:

CapacidadComportamiento a verificar
Puntos de datos cliqueablesInvestigación intencionada en lugar de apertura de paneles sin rumbo.
BúsquedaOrientación en lugar de navegación no deseada o cambios de estado.
Arrastrar, desplazar y hacer zoomUna vista más clara con una ruta confiable de regreso.
Múltiples capas de detalleAcumular comprensión mientras se retiene el contexto.
PersonalizaciónControl útil sin hacer que la configuración sea un requisito previo.
Navegación profundaConfianza en que el usuario puede regresar sin perder su trabajo.

Cuando el uso real contradiga el comportamiento previsto, revisar el diseño. La recuperación y la continuidad son condiciones que hacen posible la exploración.

Haz legibles las ideas no familiares

Nombrar el referente en lugar de una unidad interna: preferir "1.4 veces tu total semanal habitual" sobre una puntuación inexplicada. Mantener un adjetivo conectado a la cantidad y la comparación que lo respaldan. Definir términos no familiares donde sean necesarios.

Indicar cuando la evidencia es escasa. No llenar un vacío con una conclusión no respaldada. La explicación generada opcional no debe bloquear un resultado por lo demás útil; el trabajo requerido aún debe comunicar honestamente el progreso, el fracaso y la recuperación.

Flujo de trabajo

  1. Ubicar la función en el recorrido general del usuario. Identificar quién la encuentra y qué sabe ya. Inspeccionar el producto o código existente cuando esté disponible.
  2. Escribir su recompensa del primer encuentro y recompensa del centésimo uso, una oración cada una.
  3. Mapear la acción principal, la pregunta que abre y el siguiente paso útil.
  4. Asignar contenido a la escalera de divulgación. Eliminar resúmenes duplicados y controles que añadan aprendizaje sin añadir valor.
  5. Especificar preservación de contexto, prioridad de gestos, acceso accesible y recuperación.
  6. Usar patrones de implementación establecidos cuando se solicite implementación.
  7. Revisar una vez como nuevo usuario y una vez como usuario recurrente. Verificar el comportamiento así como si los controles funcionan técnicamente.

Para una vista general, favorecer el valor inmediato y una ruta clara hacia material más rico. Para una función de profundidad media, organizar en torno a las preguntas del usuario. Para evidencia detrás de una afirmación, priorizar procedencia, alcance, incertidumbre y el camino de regreso.

Evitar

  • Una superficie que no dice nada hasta que se opera.
  • Ocultar funcionalidad esencial o accesibilidad detrás del descubrimiento.
  • Agregar controles, gráficos o configuraciones y llamar al resultado profundidad.
  • Requerir terminología interna para entender resultados ordinarios.
  • Reemplazar al padre tan completamente que el usuario pierda la pregunta que hizo.
  • Tratar insignias, rachas o desbloqueos artificiales como sustitutos del valor significativo.
  • Imponer límites o diseños específicos del producto sin verificar el contexto actual.

En la entrega, nombrar las dos recompensas y la ruta de descubrimiento. Escalar la explicación a la tarea, y respaldar las afirmaciones sobre el producto actual con observaciones reales o referencias de código.

Skills relacionados