Communitygithub.com

Sistema de Pasos y Progreso

Diseña e implementa indicadores de progreso estructurados y secuencias de múltiples pasos que guían a los usuarios a través de tareas complejas, proporcionando retroalimentación clara sobre su posición actual y el esfuerzo restante.

¿Qué es Sistema de Pasos y Progreso?

El Sistema de Pasos y Progreso proporciona una metodología para diseñar y documentar cómo los usuarios avanzan a través de procesos de múltiples pasos o esperan tareas en segundo plano. Es útil para flujos de trabajo complejos como carritos de compra, formularios largos, incorporación de usuarios y estados de carga, ya que reduce la carga cognitiva al comunicar claramente dónde se encuentra el usuario, qué ha completado y qué falta. El skill cubre la categorización del tipo de progreso (horizontal, vertical, barra continua o círculo), la definición de jerarquía de pasos con etiquetas primarias y secundarias, y la visualización de estados (pendiente, activo, completado, error) con distinciones visuales claras. Además, incluye reglas de decisión como la regla de los 5 pasos, lineamientos de accesibilidad (roles ARIA, `aria-current`, contraste adecuado) y estrategias de adaptación responsiva para dispositivos móviles, garantizando que los indicadores de progreso sean funcionales, accesibles y no causen desbordamiento horizontal.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/step-progress-system

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Sistema de Pasos y Progreso?

Propósito

El skill Sistema de Pasos y Progreso proporciona una metodología para diseñar y documentar cómo los usuarios avanzan a través de procesos de múltiples pasos o esperan tareas en segundo plano. Garantiza que los flujos de trabajo complejos (como pagos o incorporación) se dividan en partes manejables, reduciendo la carga cognitiva al comunicar dónde se encuentra el usuario, qué ha completado y qué queda por hacer.

Casos de Uso

  • Pagos en Comercio Electrónico: Guiar a los usuarios a través de envío, pago y revisión.
  • Formularios de Múltiples Pasos: Dividir tareas largas de entrada de datos en secciones lógicas.
  • Incorporación de Usuarios: Visualizar el proceso de configuración de una nueva cuenta.
  • Estados de Carga/Subida: Comunicar el estado de operaciones de larga duración.
  • Rutas de Aprendizaje: Mostrar el progreso a través de un curso o plan de estudios.

Cuándo NO Usar

  • Tareas de una Solo Vista: Si una tarea se puede completar en una sola vista sin cambiar de contexto, un sistema de progreso añade ruido innecesario.
  • Flujos Infinitos: Desplazarse por contenido donde no hay un "fin" definido del progreso.
  • Interacciones Críticas de Alta Velocidad: Donde el retraso de mostrar indicadores de progreso dificultaría una tarea sensible al tiempo (por ejemplo, IU de juegos en tiempo real).

Entradas

  1. Inventario de Pasos: Una lista de las etapas discretas necesarias para completar la tarea.
  2. Tipo de Tarea: ¿Es una secuencia impulsada por el usuario (Pasos) o un proceso impulsado por el sistema (Barras de Progreso)?
  3. Linealidad: ¿Los pasos deben completarse en orden, o el usuario puede saltar entre ellos?
  4. Restricciones de Contenido: Etiquetas, descripciones e iconos para cada paso.

Salidas

  1. Marco de Progreso: Una definición del tipo de componente (Horizontal, Vertical o Circular).
  2. Matriz de Estados: Especificaciones visuales para los estados Pendiente, Activo, Completado y Error.
  3. Estrategia de Adaptación: Cómo se adapta el indicador a las pantallas móviles (por ejemplo, ocultar etiquetas, cambiar a numérico).
  4. Especificaciones de Accesibilidad: Roles ARIA, regiones en vivo y reglas de interacción con el teclado.

Flujo de Trabajo

1. Categorizar el Tipo de Progreso

Determinar el patrón visual más apropiado:

  • Paso Horizontal: Mejor para procesos lineales con 3–5 pasos en escritorio.
  • Paso Vertical: Mejor para procesos no lineales, pasos con longitudes de contenido variables o flujos centrados en móvil.
  • Barra de Progreso Continua: Mejor para tareas impulsadas por el sistema (subidas, carga) o procesos con un alto número de micro-pasos.
  • Círculo de Progreso: Mejor para widgets de panel de control o cuando el espacio es extremadamente limitado.

2. Definir Jerarquía y Etiquetas de Pasos

  • Etiqueta Primaria: Nombre conciso del paso (por ejemplo, "Envío").
  • Etiqueta Secundaria (Opcional): Breve descripción o estado (por ejemplo, "En Progreso").
  • Indicador Visual: Números (para orden), Iconos (para contexto) o Puntos (para diseño minimalista).

3. Establecer Visualización de Estados

Definir distinciones visuales claras para cada estado:

  • Pendiente: Bajo contraste, típicamente atenuado.
  • Activo: Alto contraste, a menudo usando el color primario de la marca o un efecto de "brillo".
  • Completado: Usar un icono de "marca de verificación" y un color distintivo (a menudo verde o una versión atenuada del color activo).
  • Error: Usar un icono de "advertencia" y un color semántico de error (rojo).

4. Diseñar para Movimiento y Retroalimentación

  • Transiciones: Usar animaciones sutiles al moverse entre pasos para reforzar la progresión.
  • Capacidad de Clic: Determinar si los usuarios pueden hacer clic en pasos anteriores para retroceder.
  • Validación: Visualizar que un paso es válido/completo antes de permitir la progresión.

5. Planificar Adaptaciones Responsivas

Los indicadores de múltiples pasos son famosos por romperse en móvil:

  • Reducción de Etiquetas: En móvil, ocultar etiquetas de texto y mostrar solo números o iconos.
  • Transición a "Paso X de Y": Reemplazar la barra visual completa con un resumen textual o numérico simple.
  • Cambio Vertical: Convertir barras horizontales en listas verticales en pantallas pequeñas.

Reglas de Decisión

  • La Regla de los 5 Pasos: Si un paso horizontal tiene más de 5 pasos, cambiar a un paso vertical o un indicador de texto simple "Paso X de Y" para evitar saturación.
  • Icono vs. Número: Usar números si el orden de la secuencia es crítico; usar iconos solo si proporcionan un valor semántico inmediato (por ejemplo, un icono de "Tarjeta de Crédito" para pago).
  • Linealidad: Si los usuarios deben completar los pasos en orden, deshabilitar los clics en pasos "futuros". Si es una configuración flexible, permitir saltos.
  • Preservación del Contexto: Mostrar siempre las etiquetas del paso actual, anterior y siguiente. Los demás se pueden truncar si es necesario.

Restricciones

  • Accesibilidad:
    • Usar role="progressbar" con aria-valuenow, aria-valuemin, aria-valuemax y un aria-valuetext legible por humanos (por ejemplo, "Paso 2 de 4: Pago") para barras continuas.
    • Usar aria-current="step" para identificar el paso activo en una secuencia.
    • Asegurar que las relaciones de contraste para pasos activos vs. inactivos cumplan con WCAG AA (4.5:1).
    • Si los pasos son clickables, sus objetivos deben cumplir con WCAG 2.2 SC 2.5.8 (mínimo 24x24px, preferible 44px) y exponer estados :focus-visible visibles.
  • Jerarquía: El indicador de progreso debe ser una guía, no el enfoque principal. Generalmente se sitúa en la parte superior (horizontal) o izquierda (vertical) del contenido.
  • Capacidad de Respuesta: No debe causar desbordamiento horizontal.

Patrones Comunes de Fallo

  • El "Progreso Misterioso": Mostrar una barra sin etiqueta ni porcentaje, dejando al usuario preguntándose "¿cuánto falta?"
  • Estados Inaccesibles: Usar solo color (por ejemplo, verde vs. gris) para indicar finalización sin iconos ni texto.
  • Horizontales Saturados: Forzar demasiados pasos en un diseño horizontal, causando superposición de texto o objetivos pequeños en móvil.
  • Falta de Persistencia: Ocultar el indicador de progreso en algunas páginas de un flujo de múltiples pasos, haciendo que los usuarios pierdan su sentido de ubicación.

Criterios de Validación

  • El paso actual está claramente distinguido de los pasos completados y próximos.
  • Los pasos completados usan un indicador sin color (como una marca de verificación).
  • La vista móvil es funcional y no se desborda ni satura.
  • Los roles ARIA y aria-current se aplican correctamente.
  • El sistema maneja estados de "Error" para pasos individuales.
  • El indicador se coloca de manera consistente en todos los pasos del flujo.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Skills relacionados