Communitygithub.com

ulasalyesil/personal-website-v2

Struktur und Ablauf von Interaktionen modellieren – erzeugt Breadboard-Notation mit Randfällen, Fehlerpfaden und offenen Entscheidungen.

Was ist personal-website-v2?

Dieses Skill strukturiert und dokumentiert die Interaktionsebene eines Produkts, also die Orte, Aktionen, Inhalte und Übergänge, die ein Benutzer durchläuft. Es setzt auf die Breadboard-Methode aus Ryan Singers "Shape Up" als Standard, ergänzt durch Alternativen wie User Story Mapping oder Service Blueprinting für komplexere Szenarien. Ziel ist es, noch vor der visuellen Gestaltung eine präzise, textbasierte Notation zu erstellen, die alle Zustände – Erfolgs- und Fehlerpfade, leere Zustände, Lade- und Post-Action-Zustände – explizit macht. Das Skill unterstützt die Erstellung von Flussdiagrammen in Mermaid (graph LR) und endet mit einer Zusammenfassung aus Job Story, vollständiger Breadboard-Notation, Diagramm, offenen Entscheidungen und Risiken. Es eignet sich vor allem für Claude Code, Cursor und andere KI-Agenten, die bei der Konzeption von Benutzerabläufen helfen sollen. Der Leitgedanke: Interaktionslogik definieren, bevor visuelle Details die Änderungen teuer machen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

/layers-interaction-flow

Setzt voraus, dass /layers-intro für den Framework-Kontext geladen wurde.

Die Interaktionsstruktur- und Ablaufebene definiert, wie eine Person mit dem Produkt interagiert: die Orte, die sie aufsucht, die verfügbaren Aktionen, die dargestellten Inhalte und der Fluss zwischen den Zuständen. Sie liegt über dem konzeptionellen Modell (das definiert, was existiert) und unter der Oberfläche (die definiert, wie es aussieht).

Entscheidungen, die auf dieser Ebene getroffen werden müssen:

  • Welche verschiedenen Orte durchläuft dieser Fluss?
  • Was kann der Benutzer an jedem Ort tun, und wohin führt ihn jede Aktion?
  • Welche Inhalte müssen an jedem Ort angezeigt werden?
  • Was passiert bei Fehlerpfaden, leeren Zuständen und Randfällen?
  • Ist der Ablauf so einfach wie möglich, während er dennoch den Zweck erfüllt?

Methoden:

MethodeWann
Breadboarding (Ryan Singer / Shape Up)Standard für die meisten Abläufe. Textbasierte Notation, die erzwingt, dass die Interaktionslogik bewertet wird, bevor visuelles Design Änderungen teuer macht.
User Story Mapping (Jeff Patton)Komplexes Produkt, viele Benutzertypen, schrittweise Planung. Kartiert Aktivitäten → Aufgaben → Storys über eine Zeitleiste.
AufgabenanalyseNeugestaltung eines bestehenden Ablaufs. Zerlegt die aktuelle Aufgabe, um herauszufinden, wo sich Reibung, Fehler und Workarounds konzentrieren.
Service BlueprintingDer Ablauf erstreckt sich über mehrere Kanäle oder umfasst Backstage-Operationen (Personal, Systeme, Dritte), die die Benutzererfahrung beeinflussen.
Critical User Journeys (CUJs)Entscheidung, an welchem ​​Ablauf gearbeitet werden soll. Eine CUJ ist der minimale Pfad, um den Kernproduktwert zu realisieren – Typen: stark frequentiert, umsatzstark oder metrikkritisch.

Standard: Breadboarding.

Breadboard-Notation:

Ortsname
- Aktion → Zielort
- Aktion → Zielort
[ Inhalt, der an diesem Ort angezeigt wird ]

Qualitätssignale – wie gut aussieht:

  • Jede Aktion hat ein benanntes Ziel
  • Fehlerpfade sind im Breadboard enthalten – nicht als nachträgliche Gedanken behandelt
  • Leere, Lade- und Post-Action-Zustände sind definiert
  • Keine kaputten Objekte – die Attribute und Aktionen eines Objekts sind zusammen verfügbar, nicht über Bildschirme verteilt ohne Querverweise
  • Keine isolierten Objekte – Beziehungen aus dem konzeptionellen Modell sind im Ablauf sichtbar und navigierbar
  • Der Ablauf ist minimal: Mehr als 5–6 Orte für eine einzelne Job Story ist ein Signal, nach Möglichkeiten zur Zusammenlegung zu suchen

Geführte Sitzung

Sagen Sie mir, für welche User Journey Sie entwerfen, oder sagen Sie "führe mich", um eine Breadboarding-Sitzung zu starten.

Frage: "Wo soll ich die Ergebnisse dieser Sitzung festhalten?" (siehe /layers-intro für Optionen)

Prüfen Sie die darunterliegende Ebene: "Haben Sie ein konzeptionelles Modell – definierte Objekte, Beziehungen und Vokabular –, von dem Sie ausgehen können? Oder entwerfen wir den Ablauf ohne ein stabiles Modell darunter?" Abläufe, die erstellt werden, bevor das konzeptionelle Modell stabil ist, müssen oft überarbeitet werden.

Frage: "Für welche User Journey oder Job Story entwerfen wir?" Ein Breadboard ist immer für einen bestimmten Benutzer in einer bestimmten Situation, der eine bestimmte Aufgabe erledigt.


Phase 1 – Den Ablauf rahmen

  1. Welche Job Story bedient dieser Ablauf?
  2. Wo beginnt der Benutzer? In welcher Situation befindet er sich?
  3. Wie sieht Erfolg aus – was hat der Benutzer erreicht, wenn der Ablauf abgeschlossen ist?
  4. Neuer Ablauf, Neugestaltung oder Erweiterung eines bestehenden Ablaufs?

Bei Neugestaltung: Beschreiben Sie zuerst den aktuellen Ablauf, auch grob. Bestehende Abläufe offenbaren bereits getroffene Entscheidungen – manche bewusst, viele nicht.

Phase 2 – Die Orte identifizieren

"Was sind die verschiedenen Orte – Bildschirme oder Zustände –, die dieser Ablauf durchläuft? Denken Sie noch nicht an das Layout. Benennen Sie einfach die Orte."

Frage: Sind einige davon derselbe Ort in einem anderen Zustand? Sollten es separate Orte oder ein Ort mit Zuständen sein? Gibt es anderswo im Produkt Orte, an die dieser Ablauf anknüpft?

Orte zu benennen ist selbst eine Designentscheidung. Beschreibende, benutzerverständliche Namen: "Empfehlungs-Dashboard" nicht "Seite 3."

Phase 3 – Aktionen und Verbindungen kartieren

Gehen Sie für jeden Ort durch, was der Benutzer dort tun kann und wohin jede Aktion führt. Verwenden Sie die obige Breadboard-Notation.

Für jede Aktion: Wohin genau führt diese? Was passiert, wenn sie erfolgreich ist? Fehlschlägt? Ist sie immer verfügbar oder nur unter bestimmten Bedingungen?

Bedingungen – wann Aktionen verfügbar sind oder nicht – sind oft der Ort, an dem sich die wirklichen Designentscheidungen verbergen.

Phase 4 – Den Ablauf durchgehen

Erzählen Sie als Benutzer: "Ich bin ein Benutzer, der [Job-Story-Situation]. Ich komme an [Startort] an. Ich sehe [Inhalt]. Ich möchte [Motivation]. Also [Aktion] ich..."

Gehen Sie den vollständigen Erfolgspfad durch. Gehen Sie dann die Ränder durch:

  • Leere Zustände: Wie sieht dieser Ort aus, bevor Daten existieren? Oft das Erste, was ein neuer Benutzer sieht.
  • Lade-/Async-Zustände: Was sieht der Benutzer, während Daten abgerufen oder eine Aktion verarbeitet wird?
  • Post-Action-Zustand: Was passiert nach dem Absenden? Hier bleiben, Weiterleitung, Inline-Bestätigung? Wenn zu einer Liste weitergeleitet – wird die Änderung sofort angezeigt? Bei Verzögerung könnte es so aussehen, als hätte die Aktion nicht funktioniert.
  • Optimistisch vs. pessimistisch: Ergebnis vor Serverbestätigung anzeigen oder warten? Präferenz angeben; als benannte offene Frage kennzeichnen, wenn die Implementierung unsicher ist.
  • Fehlerpfade: Für jede Aktion – Validierungsfehler, Serverfehler, Netzwerkunterbrechung, Timeout, gleichzeitige Bearbeitung. Wohin geht der Benutzer? Wie erholt er sich? Dies sind erforderliche Breadboard-Schritte.
  • Abbruchpfad: Wenn der Benutzer auf halbem Weg aufhören möchte, wohin geht er?
  • Alternative Einstiegspunkte: Setzt der Ablauf einen vorherigen Zustand voraus, der nicht immer gegeben ist?

Jede Lücke ist eine ungetroffene Designentscheidung. Nennen Sie sie explizit.

Phase 5 – Den Ablauf hinterfragen

  • Gibt es einen Schritt, den Benutzer wahrscheinlich abbrechen? Warum ist er da – ist er notwendig?
  • Gibt es Aktionen, die Benutzer erwarten würden, die der Ablauf aber nicht bietet?
  • Stimmt das Vokabular im Ablauf mit der allgegenwärtigen Sprache des konzeptionellen Modells überein?
  • Gibt es eine einfachere Version, die dieselbe Aufgabe erfüllt?

Auf kaputte Objekte prüfen: Für jedes Objekt aus dem konzeptionellen Modell, das in diesem Ablauf vorkommt – sind seine Attribute und Aktionen zusammen verfügbar oder über Bildschirme verteilt ohne Querverweise? Wenn verteilt, entweder konsolidieren oder explizite Verbindungen zwischen den Orten hinzufügen, an denen seine Teile erscheinen.

Auf isolierte Objekte prüfen: Für jede Beziehung, die im konzeptionellen Modell definiert ist – macht der Ablauf diese Beziehung sichtbar und navigierbar? Wenn eine Beziehung im Modell existiert, aber im Ablauf unsichtbar ist, entweder sichtbar machen oder eine bewusste Entscheidung treffen, dass sie von diesem Ablauf aus nicht navigierbar sein muss.

Phase 6 – Das Breadboard erstellen

Erstellen Sie das vollständige Breadboard: alle Orte, alle Aktionen und Ziele, Inhalt für jeden Ort, wichtige bedingte Zustände notiert.

Erstellen Sie ein Flussdiagramm in von links nach rechts verlaufender Ausrichtung – der Fluss durch die Zeit verläuft von links nach rechts. In Mermaid: graph LR.

Hinweis: Das Diagramm dient der Orientierung – das Text-Breadboard ist das primäre Dokument. Das Diagramm verliert Inhalts- und Bedingungsdetails.


Abschluss

Erstellen Sie:

  1. Job Story – das Benutzerbedürfnis, das dieser Ablauf bedient
  2. Breadboard – vollständige Textnotation
  3. Flussdiagramm – Mermaid graph LR
  4. Offene Entscheidungen – Lücken, Randfälle, bedingte Zustände, die noch nicht gelöst sind
  5. Risiken – Abhängigkeiten von ungeklärten Entscheidungen des konzeptionellen Modells oder Annahmen über die Oberfläche

Schließen Sie ab mit: "Dieses Breadboard definiert die Interaktionslogik, ohne sich auf eine visuelle Form festzulegen. Was auch immer als Nächstes kommt – Arbeiten im Code, Bauen im echten Medium oder detailliertes visuelles Design – stellen Sie sicher, dass das konzeptionelle Modell unter diesem Ablauf zuerst stabil ist."

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

Verwandte Skills