Communitygithub.com

ulasalyesil/personal-website-v2

Framework-Orientierung für die Schichten des Produktdesigns – zuerst laden; bietet den Kontext, von dem alle anderen Skills abhängen

Was ist personal-website-v2?

Dieser Skill etabliert das Framework „Layers of Product Design“ als Grundlage für alle nachfolgenden Design-Sessions. Er organisiert Designarbeit in sieben Schichten, die über drei Zonen verteilt sind – Problemraum, Lösungsraum und die zugrunde liegende Realität. Das Framework basiert auf der Idee, dass untere Schichten logische Grundlagen für obere darstellen: Schwache untere Schichten erzeugen UX-Schulden, die sich nach oben fortsetzen. Der Skill definiert zentrale Prinzipien wie „Entscheidungen, nicht Outputs“ und „Arbeite eine Schicht nach der anderen“, und adressiert häufig übersehene zeitliche Dimensionen des Designs. Er unterstützt alle gängigen AI-Engineering-Plattformen wie Claude Code, Cursor und Codex, die mit Skill-Dateien arbeiten. Der Skill dient als Einstiegspunkt für die gesamte Skill-Familie und leitet den Benutzer je nach Fokus zu spezifischen Skills wie `/layers-orient` oder den einzelnen Schichten-Skills weiter.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/layers-intro

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

/layers-intro

Laden Sie diesen Skill zu Beginn jeder Design-Session. Er liefert den Framework-Kontext, von dem alle anderen /layers-*-Skills abhängen.


Das Framework

Layers of Product Design organisiert Designarbeit in sieben Schichten über drei Zonen. Schichten haben logische Abhängigkeiten: Untere Schichten sind Grundlagen für obere. Schwache untere Schichten erzeugen UX-Schulden, die sich nach oben ausbreiten.

Realität – komplex, widersprüchlich, sich entwickelnd. Quelle allen Lernens.

Problemraum – aus der Realität gewonnenes Wissen:

  1. Beobachtetes Verhalten – was Benutzer tatsächlich tun
  2. Die Domäne – Konzepte, Terminologie und mentale Modelle, die unabhängig von jedem Produkt existieren
  3. Benutzerbedürfnisse – was wir glauben, dass Benutzer erreichen wollen, und warum

Lösungsraum – bewusste Entscheidungen darüber, was gebaut werden soll: 4. Produkt- und Servicestrategie – welche Bedürfnisse bedient werden und welche Geschäftsergebnisse angestrebt werden 5. Konzeptuelles Modell – Objekte, Beziehungen, Zustände, Vokabular – unabhängig von jeder Oberfläche 6. Interaktionsstruktur und -ablauf – Orte, Affordanzen, Verbindungen und Ablauflogik 7. Oberfläche – Wörter, Visuals, Feedback, Hierarchie – was Benutzer tatsächlich sehen

Die Schichten sind kein linearer Prozess. Sie können überall einsteigen – aber prüfen Sie immer, ob die darunterliegenden Grundlagen solide sind.

Inspiriert von Jesse James Garretts The Elements of User Experience (2000).


Design ist Entscheidungsfindung

Design = Entscheidungen über die Form einer Lösung treffen (Christopher Alexander). Form ist die Lösung; Kontext sind die Anforderungen, Einschränkungen und die Umgebung, in die sie passen muss. Gutes Design ist gute Passung.

Vier Arten von Fortschritt:

  1. Entscheidungen treffen – etwas Unentschiedenes klären
  2. Ungetroffene Entscheidungen aufdecken – entdecken, was noch nicht entschieden wurde (oft wertvoller als 1)
  3. Entscheidungen bewerten – bereits getroffene Entscheidungen identifizieren, die riskant, inkonsistent oder falsch sind
  4. Entscheidungen priorisieren – untere Schichten sind grundlegender und tragen mehr Risiko, wenn sie falsch sind

Die Aufgabe jedes Skills ist es, dem Designer zu helfen, bessere Entscheidungen zu treffen – nicht, Entscheidungen für ihn zu treffen.


Prinzipien – gelten für alle Sessions

  1. Entscheidungen, nicht Outputs. Artefakte sind nur insofern nützlich, als sie getroffene oder aufgedeckte Entscheidungen repräsentieren. Benennen Sie die Entscheidung, nicht nur das Diagramm.
  2. Aufdecken vor Klären. Entscheidungen, die der Designer nicht kannte, sind oft wertvoller als die, die er bereits kannte.
  3. Arbeiten Sie eine Schicht nach der anderen. Die Vermischung von Problemraum und Lösungsraum oder von Oberfläche und konzeptuellem Modell führt zu verwirrten Ergebnissen.
  4. Prüfen Sie Grundlagen, bevor Sie nach oben bauen. Bevor Sie an einer oberen Schicht arbeiten, prüfen Sie die darunterliegende Schicht. Kennzeichnen Sie Instabilität.
  5. Das konzeptuelle Modell ist die am meisten vernachlässigte tragende Schicht. Schenken Sie ihm mehr Aufmerksamkeit, als Ihnen angenehm ist.
  6. Kennzeichnen Sie schlechte Entscheidungen, nicht nur fehlende. Eine bereits getroffene Entscheidung, die riskant oder inkonsistent ist, muss benannt werden, nicht umgangen.
  7. Lenken Sie, lassen Sie sich nicht lenken. Springen Sie nicht zu Oberflächen-Output, bevor grundlegende Entscheidungen getroffen sind.
  8. Designprinzipien vs. Implementierungsentscheidungen. Manche Entscheidungen können ohne Kenntnis von Systemeinschränkungen getroffen werden – was aus Benutzersicht passieren sollte. Andere sind mit der Implementierung verwoben: Formulieren Sie die Benutzererfahrungsanforderung, bilden Sie eine gut geformte Frage und tragen Sie sie in ein Design-Engineering-Gespräch. Erzwingen Sie keine vorzeitige Antwort.

Die Zeitdimension – proaktiv erkunden

Zeitliche Entscheidungen werden oft übersehen. Sie gruppieren sich auf zwei Schichten:

Schicht des konzeptuellen Modells:

  • Zwischenaktionszustände – durchläuft ein Objekt Übergangszustände (Speichern, Verarbeiten, ausstehende Genehmigung), bevor es endgültig ist? Das sind Modellzustände.
  • Read-Model-Verzögerung – Lücke zwischen dem Zeitpunkt, an dem Daten geschrieben werden, und dem, an dem sie sichtbar sind? Formulieren Sie das Benutzerbedürfnis; kennzeichnen Sie es als benannte offene Frage für die Entwicklung.
  • Beziehungszeitlichkeit – „Alle Produkte in Europa“ bedeutet die Gruppe jetzt oder die Mitgliedschaft, wie sie sich ändert? Das ist eine Designentscheidung.
  • Löschsemantik – Archivieren, Papierkorb, endgültiges Löschen oder regulatorisches Löschen? Geben Sie an, welche und warum. Implementierung folgt.
  • Historie – Spielt es eine Rolle, was ein Objekt in der Vergangenheit war? Festzustellen, dass es wichtig ist, ist eine Designentscheidung.

Schicht der Interaktionsstruktur:

  • Zustand nach der Aktion – Was sieht der Benutzer nach dem Absenden? Spiegelt eine umgeleitete Liste die Änderung sofort wider?
  • Optimistische vs. pessimistische Aktualisierungen – Zeigen Sie das angenommene Ergebnis an, bevor der Server es bestätigt, oder warten Sie? Geben Sie die Präferenz an; kennzeichnen Sie es als offene Frage, wenn die Implementierung unsicher ist.
  • Leere, Lade- und Teilzustände – Jeder Ort hat einen zeitlichen Lebenszyklus. Entwerfen Sie alle.
  • Fehler- und Fehlerpfade – Validierungsfehler, Serverfehler, Netzwerkunterbrechung, gleichzeitige Bearbeitung. Erforderliche Designschritte, keine Nebengedanken.

Fehlermodussignale

OOUX-Objektfehlermodi (Sophia Prater):

  • Gestaltwandler – dasselbe Objekt in deutlich unterschiedlichen Formen in verschiedenen Kontexten. Oberflächenfix: konsistente Objektbehandlung. Tiefergehender Fix, wenn das Modell das Objekt nicht klar definiert.
  • Maskiert – verschiedene Objekttypen sehen identisch aus. Oberflächenfix: unterschiedliche visuelle Behandlungen. Tiefergehender Fix, wenn das Modell sie nicht unterscheidet.
  • Kaputt – Daten und Aktionen eines Objekts sind über Bildschirme verteilt, ohne Querverweise. Interaktionsstrukturproblem → /layers-interaction-flow.
  • Isoliert – Objekte existieren ohne sichtbare Beziehungen zu anderen Objekten. Problem des konzeptuellen Modells → /layers-conceptual-model.

Nielsens Heuristiken – eine Wurzelschichtzuordnung: Verstöße gegen „Übereinstimmung zwischen System und realer Welt“ haben fast immer ihre Wurzel im konzeptuellen Modell, nicht in der Oberfläche. „Benutzerkontrolle und Freiheit“ ist eine Interaktionsstrukturentscheidung. Diese an der Oberfläche zu flicken, behandelt Symptome, nicht Ursachen.


Arbeiten erfassen

Fragen Sie zu Beginn jeder Design-Session, wo die Ergebnisse gespeichert werden sollen:

„Wo soll ich die Arbeit dieser Session erfassen? Die empfohlene Einrichtung ist eine Markdown-Datei in Ihrem Projekt – Diagramme werden als eingebettetes Mermaid geschrieben und in VSCode mit der Markdown Preview Mermaid Support-Erweiterung nativ dargestellt. Alternativen:

  • Notion – wenn Sie das Notion MCP angeschlossen haben
  • Einfach im Gespräch – keine Datei nötig“

Speichern Sie die Session-Zusammenfassung am Ende am gewählten Zielort.

Wenn Sie Mermaid-Diagramme schreiben, verwenden Sie <br/> für Zeilenumbrüche in Knotenbeschriftungen – nicht \n, das als Literaltext dargestellt wird.


Wo anfangen

  • Nicht sicher, worauf Sie sich konzentrieren sollen? → /layers-orient – schnelle Diagnose über alle sieben Schichten
  • Sie wissen, auf welcher Schicht Sie sind? → direkt zu diesem Skill springen

Skills: /layers-observed-behaviour · /layers-domain · /layers-user-needs · /layers-product-strategy · /layers-conceptual-model · /layers-interaction-flow · /layers-surface

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

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

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

Verwandte Skills