Communitygithub.com

ulasalyesil/personal-website-v2

Define la estructura y el flujo de interacción, produciendo notación de breadboard con casos extremos, caminos de fallo y decisiones abiertas.

¿Qué es personal-website-v2?

Esta skill guía el diseño de la capa de estructura y flujo de interacción para productos digitales. Se enfoca en mapear cómo una persona navega, qué acciones puede realizar, qué contenido ve y cómo fluye entre estados. Utiliza principalmente la técnica de "breadboarding" (notación textual basada en lugares y acciones) para evaluar la lógica de interacción antes de invertir en diseño visual. La skill ayuda a identificar decisiones clave como los lugares del flujo, las acciones en cada lugar, el contenido necesario, los caminos de fallo, estados vacíos y casos extremos. También proporciona métodos alternativos como user story mapping, task analysis, service blueprinting y Critical User Journeys (CUJs). Ideal para desarrolladores, diseñadores de UX y gerentes de producto que trabajan con metodologías como Shape Up, y que buscan una manera estructurada de diseñar flujos que sean mínimos, sólidos y centrados en el usuario.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/layers-interaction-flow

Preguntar en tu IA favorita

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

Documentación

/layers-interaction-flow

Asume que /layers-intro ha sido cargado para el contexto del framework.

La capa de estructura y flujo de interacción define cómo una persona interactúa con el producto: los lugares que navega, las acciones disponibles, el contenido presentado y el flujo entre estados. Se sitúa por encima del modelo conceptual (que define lo que existe) y por debajo de la superficie (que define cómo se ve).

Decisiones que esta capa necesita tomar:

  • ¿Cuáles son los lugares distintos por los que se mueve este flujo?
  • ¿Qué puede hacer el usuario en cada lugar y hacia dónde lo lleva cada acción?
  • ¿Qué contenido necesita mostrar cada lugar?
  • ¿Qué sucede en los caminos de fallo, estados vacíos y casos extremos?
  • ¿Es el flujo tan simple como puede ser, mientras sigue cumpliendo su propósito?

Métodos:

MétodoCuándo usarlo
Breadboarding (Ryan Singer / Shape Up)Valor predeterminado para la mayoría de los flujos. Notación basada en texto que obliga a evaluar la lógica de interacción antes de que el diseño visual haga que los cambios sean costosos.
User story mapping (Jeff Patton)Producto complejo, muchos tipos de usuarios, planificación incremental. Mapa de actividades → tareas → historias a lo largo de una línea de tiempo.
Task analysisRediseñar un flujo existente. Descomponer la tarea actual para encontrar dónde se concentran la fricción, los errores y las soluciones alternativas.
Service blueprintingEl flujo abarca múltiples canales o implica operaciones internas (personal, sistemas, terceros) que afectan la experiencia del usuario.
Critical User Journeys (CUJs)Decidir en qué flujo trabajar. Una CUJ es el camino mínimo para obtener el valor central del producto. Tipos: de alto tráfico, de altos ingresos o críticos para métricas.

Valor predeterminado: breadboarding.

Notación de breadboard:

Nombre del lugar
- acción → lugar de destino
- acción → lugar de destino
[ contenido mostrado en este lugar ]

Señales de calidad — cómo se ve un buen trabajo:

  • Cada acción tiene un destino nombrado.
  • Los caminos de fallo están en el breadboard, no se dejan como ideas secundarias.
  • Los estados vacío, de carga y posteriores a la acción están definidos.
  • No hay objetos rotos: los atributos y acciones de un objeto están disponibles juntos, no dispersos en pantallas sin enlaces cruzados.
  • No hay objetos aislados: las relaciones del modelo conceptual son visibles y navegables en el flujo.
  • El flujo es mínimo: más de 5–6 lugares para una sola historia de trabajo es una señal para buscar qué se puede colapsar.

Sesión guiada

Dime para qué viaje de usuario estás diseñando, o di "guíame" para iniciar una sesión de breadboarding.

Pregunta: "¿Dónde debería capturar el trabajo de esta sesión?" (consulta /layers-intro para opciones)

Verifica la capa inferior: "¿Tienes un modelo conceptual — objetos definidos, relaciones y vocabulario — desde el cual trabajar? ¿O estamos diseñando el flujo sin un modelo establecido debajo?" Los flujos construidos antes de que el modelo conceptual sea estable a menudo necesitan ser revisados.

Pregunta: "¿Para qué viaje de usuario o historia de trabajo estamos diseñando?" Un breadboard siempre es para un usuario particular en una situación particular haciendo un trabajo particular.


Fase 1 — Enmarcar el flujo

  1. ¿A qué historia de trabajo sirve este flujo?
  2. ¿Dónde comienza el usuario? ¿En qué situación se encuentra?
  3. ¿Cómo se ve el éxito? ¿Qué ha logrado el usuario cuando el flujo se completa?
  4. ¿Flujo nuevo, rediseño o extensión de un flujo existente?

Si es un rediseño: describe primero el flujo actual, aunque sea de manera aproximada. Los flujos existentes revelan decisiones ya tomadas — algunas deliberadamente, muchas no.

Fase 2 — Identificar los lugares

"¿Cuáles son los lugares distintos — pantallas o estados — por los que se mueve este flujo? No pienses en el diseño aún. Solo nombra los lugares."

Pregunta: ¿algunos de estos son el mismo lugar en un estado diferente? ¿Deberían ser lugares separados o un solo lugar con estados? ¿Hay lugares en otras partes del producto a los que este flujo se conecta?

Nombrar lugares es en sí mismo una decisión de diseño. Nombres descriptivos y significativos para el usuario: "Panel de referidos" no "Página 3".

Fase 3 — Mapear acciones y conexiones

Para cada lugar, trabaja en lo que el usuario puede hacer allí y hacia dónde lleva cada acción. Usa la notación de breadboard anterior.

Para cada acción: ¿hacia dónde va exactamente? ¿Qué sucede si tiene éxito? ¿Falla? ¿Está siempre disponible, o solo bajo ciertas condiciones?

Las condiciones — cuándo las acciones están o no disponibles — suelen ser donde se esconden las verdaderas decisiones de diseño.

Fase 4 — Recorrer el flujo

Narrar como el usuario: "Soy un usuario que [situación de la historia de trabajo]. Llego a [lugar inicial]. Veo [contenido]. Quiero [motivación]. Entonces [acción]..."

Recorre todo el camino exitoso. Luego recorre los bordes:

  • Estados vacíos: ¿Cómo se ve este lugar antes de que existan datos? A menudo es lo primero que ve un nuevo usuario.
  • Estados de carga / asíncronos: ¿Qué ve el usuario mientras se obtienen datos o se procesa una acción?
  • Estado posterior a la acción: Después de enviar, ¿qué sucede? ¿Permanecer aquí, redirigir, confirmación en línea? Si se redirige a una lista — ¿muestra inmediatamente el cambio? Si hay retraso, ¿podría parecer que la acción no funcionó?
  • Optimista vs. pesimista: ¿Mostrar el resultado asumido antes de que el servidor confirme, o esperar? Indica la preferencia; márcalo como una pregunta abierta nombrada si la implementación es incierta.
  • Caminos de fallo: Para cada acción — fallo de validación, error del servidor, desconexión de red, tiempo de espera, edición concurrente. ¿A dónde va el usuario? ¿Cómo se recupera? Estos son pasos obligatorios del breadboard.
  • Camino de cancelación: Si el usuario quiere detenerse a mitad de camino, ¿a dónde va?
  • Puntos de entrada alternativos: ¿El flujo asume un estado previo que podría no ser siempre cierto?

Cada brecha es una decisión de diseño no tomada. Nómbrala explícitamente.

Fase 5 — Desafiar el flujo

  • ¿Hay un paso que los usuarios probablemente abandonen? ¿Por qué está ahí? ¿Es necesario?
  • ¿Hay acciones que los usuarios esperarían y que el flujo no ofrece?
  • ¿El vocabulario del flujo coincide con el lenguaje ubicuo del modelo conceptual?
  • ¿Existe una versión más simple que sirva para el mismo trabajo?

Verificar objetos rotos: Para cada objeto del modelo conceptual que aparece en este flujo — ¿sus atributos y acciones están disponibles juntos, o están divididos en pantallas sin enlaces cruzados? Si están divididos, consolida o agrega conexiones explícitas entre los lugares donde aparecen sus partes.

Verificar objetos aislados: Para cada relación definida en el modelo conceptual — ¿el flujo hace que esa relación sea visible y navegable? Si una relación existe en el modelo pero es invisible en el flujo, ya sea hazla visible o toma una decisión deliberada de que no necesita ser navegable desde este flujo.

Fase 6 — Generar el breadboard

Produce el breadboard completo: todos los lugares, todas las acciones y destinos, contenido para cada lugar, estados condicionales clave anotados.

Genera un diagrama de flujo en orientación de izquierda a derecha — el flujo a través del tiempo se lee de izquierda a derecha. En Mermaid: graph LR.

Nota: el diagrama es para orientación — el breadboard en texto es el documento principal. El diagrama pierde detalle de contenido y condicional.


Finalización

Produce:

  1. Historia de trabajo — la necesidad del usuario que este flujo satisface
  2. Breadboard — notación textual completa
  3. Diagrama de flujo — Mermaid graph LR
  4. Decisiones abiertas — brechas, casos extremos, estados condicionales aún no resueltos
  5. Riesgos — dependencias de decisiones no resueltas del modelo conceptual o supuestos de superficie

Cierra con: "Este breadboard define la lógica de interacción sin comprometerse con una forma visual. Lo que venga después — trabajar en código, construir en el medio real o diseño visual detallado — asegúrate primero de que el modelo conceptual debajo de este flujo sea estable."

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Skills relacionados