Back to list
vjrivmon

mapping-principle

by vjrivmon

Sistema de orquestación de agentes para Claude Code - Transforma ideas en MVPs funcionales

1🍴 0📅 Jan 24, 2026

SKILL.md


name: mapping-principle description: Los controles deben corresponder naturalmente a sus efectos. Use cuando diseñe controles de UI, layouts de controles, o cualquier relación causa-efecto. metadata: author: ux-ui-skills version: "1.0" category: design-principles

Principio de Mapping (Correspondencia)

Resumen

La relación entre controles y sus efectos debe ser obvia y natural. Un buen mapping aprovecha analogías físicas y espaciales para que el uso sea intuitivo.

Origen

  • Autor: Don Norman
  • Año: 1988
  • Fuente: "The Design of Everyday Things"

Tipos de Mapping

Mapping Espacial

  • Control ubicado cerca de lo que controla
  • Botón izquierdo controla elemento izquierdo
  • Slider vertical para control vertical
  • Layout que refleja relación física

Mapping Conceptual

  • Analogías con el mundo real
  • Volumen: más = más fuerte
  • Brillo: más = más claro
  • Temperatura: derecha = más caliente

Mapping Cultural

  • Convenciones aprendidas
  • Scroll down = contenido sube (controversial)
  • Verde = continuar, rojo = parar
  • X = cerrar

Aplicación en Diseño

Controles de UI

  • Sliders horizontales para valores horizontales
  • Toggles que van de izquierda (off) a derecha (on)
  • Volume que sube al mover hacia arriba
  • Zoom con pinch natural

Layouts

  • Controles de texto cerca del text area
  • Settings de elemento junto al elemento
  • Preview al lado de controles que lo modifican
  • Navegación que refleja estructura de contenido

Formularios

  • Labels directamente sobre o junto a campos
  • Botones de acción al final del flujo
  • Grupos que reflejan categorías de datos
  • Progress que va de izquierda a derecha

Interfaces Espaciales

  • Mapas con controles de zoom intuitivos
  • Editores gráficos con paletas contextuales
  • Dashboards con métricas relacionadas agrupadas
  • Timelines con controles temporales lógicos

Ejemplos

  • Stovetop controls: Disposición que coincide con hornillas
  • Car mirrors: Controles ubicados en el espejo
  • iOS volume: Botones físicos arriba/abajo
  • Figma: Properties panel junto a objeto seleccionado
  • Google Maps: Zoom con + arriba, - abajo

Anti-patterns

  • ❌ Controles alejados de lo que controlan
  • ❌ Sliders verticales para valores horizontales
  • ❌ Botones en orden no lógico
  • ❌ Settings globales mezclados con locales
  • ❌ Mappings que contradicen convenciones

Métricas

  • Mapping Intuitiveness Score: Evaluación de naturalidad
  • Control Discovery Time: Tiempo para encontrar control
  • Error Rate by Mapping: Errores por mapping pobre
  • Learning Time: Tiempo para dominar controles

Principios Relacionados

  • [[affordances]] - Controles que sugieren su uso
  • [[proximity]] - Gestalt: cercanía indica relación
  • [[nielsen-match-real-world]] - Coincidencia con mundo real

Referencias

Score

Total Score

65/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon