Communitygithub.com

ulasalyesil/personal-website-v2

Define los objetos, relaciones, estados y vocabulario del producto de forma independiente a cualquier interfaz; la capa que soporta mayor carga estructural.

¿Qué es personal-website-v2?

Este skill, `ulasalyesil/personal-website-v2`, implementa la capa de modelo conceptual dentro del marco de trabajo de diseño por capas (`/layers-intro`). Define los objetos que el producto reconoce, sus relaciones, los estados que pueden alcanzar y el vocabulario empleado, todo ello como una decisión de diseño deliberada, no como un mero reflejo del desordenado dominio del usuario. Es la capa que más carga estructural soporta, ya que cualquier inconsistencia entre este modelo y la interfaz genera deuda tanto de UX como técnica. El skill guía al agente (Claude Code, Cursor, Codex, etc.) a través de un proceso estructurado de seis fases: encuadre del alcance, descubrimiento de objetos, definición de cada objeto, mapeo relacional, transiciones de estado y lenguaje ubicuo. Proporciona métodos como recolección de nombres, OOUX, gramática de acciones y event storming, y produce artefactos como definiciones de objetos, diagramas entidad-relación (Mermaid), diagramas de estado y un glosario de lenguaje ubicuo. Está diseñado para sesiones guiadas en las que el agente pregunta al usuario y genera la documentación del modelo conceptual.

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

Preguntar en tu IA favorita

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

Documentación

/layers-conceptual-model

Asume que /layers-intro ha sido cargado para obtener el contexto del marco de trabajo.

El modelo conceptual es la capa de carga estructural más descuidada. Define los objetos que el producto reconoce, sus relaciones, los estados que pueden alcanzar y el vocabulario empleado para todo ello. Reside en el espacio de solución: no es una captura de los modelos mentales existentes de los usuarios (que son contradictorios y desordenados — esa es la labor de la capa de dominio), sino una decisión de diseño deliberada sobre cómo el producto modelará su dominio.

Lo que es — y no es:

  • Una decisión de diseño que resuelve el dominio desordenado en una estructura coherente y con opinión.
  • No es un esquema de base de datos — los ingenieros toman sus propias decisiones sobre los datos, pero la brecha entre este modelo y lo que construyen es importante. Una brecha grande y no examinada es tanto deuda de UX (los usuarios encuentran un producto que contradice el modelo) como deuda técnica (el sistema es más difícil de evolucionar).
  • No es un wireframe ni un flujo — no hay pantallas ni navegación. Eso pertenece a las capas superiores.
  • No es neutral — cada decisión de nomenclatura, cada límite de relación, cada objeto incluido o excluido refleja un punto de vista.

Decisiones que esta capa debe tomar:

  • ¿Qué objetos reconocerá este producto y cuáles son sus límites?
  • ¿Cómo se relacionan esos objetos entre sí?
  • ¿Qué pueden hacer los usuarios con cada objeto?
  • ¿Qué estados puede alcanzar cada objeto y qué transiciones son importantes?
  • ¿Cuál es el vocabulario del producto? — un nombre por concepto, elegido y asumido.

Métodos:

MétodoCuándo usarlo
Recolección de nombres + OOUX (Sophia Prater)Por defecto cuando se dispone de investigación o notas de dominio para explotar. Extrae objetos del lenguaje natural.
Diseño de interacción semántica / gramática de acciones (Daniel Rosenberg)Cuando hay muchas acciones sobre muchos objetos y se quiere auditar la consistencia y precisión de los verbos.
Event storming — fase de comandos/políticas (Brandolini)El dominio tiene procesos complejos. Empezar por lo que ocurre y trabajar hacia atrás hasta los objetos involucrados.
Card sortingEl vocabulario no está claro o es motivo de controversia entre usuarios o equipos.
Mapeo de contextos delimitados (DDD)Varios tipos de usuarios usan las mismas palabras con significados diferentes — revela dónde el modelo tiene costuras naturales.
Recorrer el producto existenteRediseño. La interfaz actual revela el modelo implícito; compararlo con cómo piensan realmente los usuarios.

Por defecto: recolección de nombres y definición de objetos.

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

  • Cada objeto es significativo de forma independiente para el usuario — no un elemento de interfaz, no una abstracción vaga.
  • Los roles de las relaciones se nombran explícitamente cuando un objeto puede desempeñar varios roles.
  • Los atributos que en realidad son relaciones han sido cuestionados y convertidos.
  • Sin adiciones especulativas — cada objeto, atributo y relación se remonta a una necesidad del usuario.
  • Las transiciones de estado están definidas para objetos cuyo estado cambia materialmente lo que los usuarios pueden hacer.
  • Se abordan las decisiones temporales: semántica de eliminación, temporalidad de relaciones, historial.
  • Se establece un lenguaje ubicuo: un nombre por concepto, un concepto por nombre.

Sesión guiada

Dime qué producto o característica estás definiendo un modelo, o di "guíame" para empezar la recolección de nombres y la definición de objetos.

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

Comprueba qué tiene el diseñador del espacio del problema: notas de dominio, investigación, necesidades de usuario. Si no hay nada: continúa, pero advierte que un modelo construido sin conocimiento del dominio a menudo refleja suposiciones más que la realidad de los usuarios.

Si es un rediseño: "Describe el modelo actual, aunque sea informalmente — ¿qué modelo implícito tiene el producto existente?"


Fase 1 — Enmarcar el alcance

  1. ¿Para qué producto o característica estamos definiendo un modelo conceptual?
  2. ¿Cuál es la tarea principal que los usuarios intentan realizar con él?
  3. ¿Con qué material cuentas?

Fase 2 — Descubrir objetos

A partir de la investigación o notas de dominio: Extrae cada nombre — cosas, personas, roles, documentos, lugares, estados, conceptos, eventos. Amplía el alcance; no filtres aún. Presenta la lista en bruto, luego pregunta: ¿faltan nombres? ¿Mismas cosas con nombres diferentes?

A partir de un producto existente: Recórranlo juntos. "¿Qué está viendo un usuario aquí? ¿Cómo se llama esta cosa?"

A partir de primeros principios: "Si un usuario pudiera alcanzar y pasar algo a un colega, ¿qué pasaría?"

Clasifica en:

  • Objetos — cosas que persisten, tienen sus propios atributos y son importantes para el usuario por derecho propio.
  • Atributos — propiedades que describen un objeto, no objetos en sí mismos.
  • Apartar — elementos de interfaz, abstracciones vagas, acciones disfrazadas de nombres.

Un objeto verdadero debe ser significativo de forma independiente para el usuario, no solo una propiedad de otra cosa.

Fase 3 — Definir cada objeto

Trabaja con cada objeto central:

Objeto: [Nombre]
Quées: [una frase desde la perspectiva del usuario]
Atributos: [propiedades que un usuario conoce o le importan]
Relaciones: [conexiones con otros objetos — cardinalidad y nombres de roles]
Acciones (CTAs): [lo que un usuario puede hacer con o a este objeto]

Cinco comprobaciones de disciplina:

  1. Roles de relación: Cuando una relación se conecta a un objeto que puede desempeñar varios roles (por ejemplo, un Usuario que es tanto referente como referido), nombra el rol explícitamente: "pertenece a un Usuario (como referente)" no "pertenece a un Usuario".

  2. Atributos que en realidad son relaciones: Si un atributo es solo el nombre o ID de otro objeto en el modelo, es una relación — modelízalo, no lo dupliques como atributo.

  3. Sin adiciones especulativas: No añadas atributos, relaciones o acciones que no estén fundamentados en una necesidad de usuario declarada. La expansión del alcance en la capa del modelo conceptual se propaga a todas las capas superiores.

  4. Implementación vs. decisiones de diseño: Cuando la conversación derive hacia cómo se genera, almacena o computa algo — redirige: "Cómo se genera es ingeniería. Lo que importa aquí: ¿puede un usuario cambiar esto? ¿Qué sucede con las cosas que ya lo referenciaban?"

  5. Precisión del verbo: Para cada acción, pregúntate si el verbo le dice al usuario con qué se encontrará o qué operación del mundo real está realizando. "Introducir un PIN" falla porque implica que el PIN ya existe — "Crear" es preciso. Más críticamente: comprueba si un verbo genérico (Editar, Eliminar, Actualizar) está ocultando operaciones con consecuencias del mundo real significativamente diferentes. "Editar dirección" confunde corregir un error tipográfico con registrar un cambio de domicilio — dos operaciones donde una conserva el historial y la otra no, requiriendo un comportamiento del sistema diferente y una intención del usuario diferente. Una interfaz deductiva usa verbos genéricos y pide a los usuarios que mapeen su intención a ellos; una interfaz inductiva nombra la operación del mundo real ("Registrar cambio de domicilio") y preserva su significado. Cuando un verbo genérico podría significar cosas distintas dependiendo de lo que el usuario realmente está tratando de hacer, nombra las operaciones por separado.

Fase 4 — Mapa de objetos

Genera un mapa relacional de objetos: entidades como nodos, relaciones como líneas etiquetadas con marcadores de cardinalidad. Sin orientación fija — sigue lo que haga las relaciones más legibles. En Mermaid: erDiagram.

Al presentar, explica la cardinalidad: || = exactamente uno, o{ = cero o muchos, |{ = uno o muchos. La pata de cuervo siempre está en el lado "muchos". Las etiquetas de relación se leen en la dirección declarada (primera entidad → segunda entidad).

Pregunta: "¿Esto refleja cómo piensas acerca de estas cosas? ¿Faltan relaciones, direcciones invertidas, conexiones que no deberían estar?"

Fase 5 — Transiciones de estado y decisiones temporales

Para cada objeto donde el ciclo de vida o el estado importe: "¿Qué estados puede tener un [Objeto]? ¿Qué lo mueve entre estados? ¿Qué se vuelve imposible en cada estado?"

Genera un diagrama de estado: estados como nodos, transiciones como flechas etiquetadas, con un estado inicial claro. De arriba a abajo o de izquierda a derecha según el número de estados. En Mermaid: stateDiagram-v2.

También explora las decisiones temporales (de /layers-intro): estados de acción intermedia, desfase del modelo de lectura, temporalidad de relaciones, semántica de eliminación, historial. Para preguntas entrelazadas con la implementación, no fuerces una respuesta prematura — articula el requisito de experiencia de usuario y márcalo como una pregunta abierta nombrada para una conversación con ingeniería.

Fase 6 — Lenguaje ubicuo

El lenguaje ubicuo cubre tanto nombres (objetos, atributos) como verbos (acciones). El mismo principio se aplica a ambos: una palabra por concepto, un concepto por palabra.

Nombres: Enumera cada nombre de objeto y atributo elegido. Para cualquier nombre con sinónimos o conflictos de nomenclatura:

Término: [nombre elegido]
Alternativas rechazadas: [otros nombres que aparecieron]
Decisión: [por qué se eligió este término]

Verbos — vocabulario de acciones: Compila todos los verbos de acción en todos los objetos. Aplica dos pruebas:

Comprobación de sinónimos: ¿Se están usando varios verbos para la misma operación? "Crear" y "Añadir" para el mismo tipo de acción deberían consolidarse. Minimizar el vocabulario de verbos reduce lo que los usuarios tienen que aprender — el mismo verbo funcionando de forma idéntica en todos los objetos (como cortar/copiar/pegar) significa que los usuarios aprenden una vez y transfieren a todas partes. Cada sinónimo es algo nuevo que memorizar.

Comprobación de aplanamiento: El riesgo opuesto — un verbo que cubre operaciones que son genuinamente diferentes. "Editar dirección" suena simple hasta que te das cuenta de que combina dos cosas: corregir un error tipográfico (sobrescribir está bien) y registrar un cambio de domicilio (que debería crear un nuevo registro y preservar el anterior). El dominio trata estas cosas de manera diferente; la interfaz no debería ocultarlo. Para cada verbo CRUD genérico (Editar, Eliminar, Actualizar, Crear), pregúntate: ¿podría cubrir operaciones con consecuencias del mundo real diferentes — implicaciones de historial diferentes, efectos secundarios diferentes, cosas que el usuario realmente intenta lograr diferentes? Si es así, dales nombres separados. "Registrar cambio de domicilio" y "Corregir dirección" no son verbosos — son precisos.

Verbo: [nombre de acción elegido]
Se aplica a: [qué objetos]
Alternativas rechazadas: [otros verbos considerados]
Decisión: [por qué este verbo; qué operación del mundo real nombra]

"Este es el lenguaje ubicuo de tu producto. Usa estos términos de manera consistente — en la interfaz, en el texto de ayuda, en los nombres de las API, en la conversación interna. Cada inconsistencia entre este modelo y la superficie crea carga cognitiva para los usuarios."


Finalización

Produce:

  1. Definiciones de objetos — atributos, relaciones y acciones.
  2. Mapa de objetos — erDiagram.
  3. Diagramas de transición de estado — para objetos con ciclos de vida significativos.
  4. Lenguaje ubicuo — nombres y verbos elegidos con conflictos resueltos y decisiones.
  5. Preguntas abiertas — decisiones aplazadas, objetos que parecían endebles, cualquier cosa señalada pero no resuelta.

Cierra con: "El modelo conceptual define lo que existe en este producto. Siguiente: diseñar cómo los usuarios interactúan con esos objetos. Ejecuta /layers-interaction-flow."

Si no se ha realizado trabajo de dominio: "Este modelo se construyó sin investigación de dominio — es una hipótesis. Planifica revisitarlo una vez que tengas evidencia."

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

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

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

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