Communitygithub.com

ulasalyesil/site-personnel-v2

Mappe la structure et le flux d'interaction — produit une notation de breadboard avec cas limites, chemins d'échec et décisions ouvertes.

Qu'est-ce que site-personnel-v2 ?

Cette compétence permet de concevoir et de documenter la couche d'interaction d'un produit en utilisant la méthode du **breadboarding** (notation textuelle) popularisée par Ryan Singer / Shape Up. Elle guide l'utilisateur à travers un processus structuré en six phases – de la définition du job story à la production finale du breadboard et d'un diagramme de flux – en forçant l'évaluation logique avant toute décision visuelle. Idéale pour les designers, chefs de produit et développeurs souhaitant clarifier les parcours utilisateur, elle s'applique à tous les contextes où il faut définir les places, affordances, contenus et chemins alternatifs (états vides, chargement, échecs). La compétence propose également des méthodes alternatives (user story mapping, task analysis, service blueprinting, CUJs) selon la complexité du projet. Elle repose sur l'hypothèse que la couche conceptuelle (modèle conceptuel) a déjà été définie ou est en cours de stabilisation. Le livrable final inclut un breadboard textuel complet, un diagramme Mermaid orienté gauche-droite, une liste des décisions ouvertes et des risques identifiés.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/couches-flux-interaction

Suppose que /couches-intro a été chargé pour le contexte du framework.

La couche structure d'interaction et flux définit comment une personne interagit avec le produit : les lieux qu'elle parcourt, les affordances disponibles, le contenu présenté et le flux entre les états. Elle se situe au-dessus du modèle conceptuel (qui définit ce qui existe) et en dessous de la surface (qui définit l'apparence).

Décisions que cette couche doit prendre :

  • Quels sont les lieux distincts par lesquels ce flux transite ?
  • Que peut faire l'utilisateur dans chaque lieu, et où chaque action le mène-t-elle ?
  • Quel contenu chaque lieu doit-il afficher ?
  • Que se passe-t-il sur les chemins d'échec, les états vides et les cas limites ?
  • Le flux est-il aussi simple que possible tout en servant le job ?

Méthodes :

MéthodeQuand
Breadboarding (Ryan Singer / Shape Up)Par défaut pour la plupart des flux. Notation textuelle qui force l'évaluation de la logique d'interaction avant que le design visuel ne rende les changements coûteux.
User story mapping (Jeff Patton)Produit complexe, nombreux types d'utilisateurs, planification incrémentale. Mappe les activités → tâches → stories sur une chronologie.
Task analysisRefonte d'un flux existant. Décomposer la tâche actuelle pour trouver où se concentrent les frictions, les erreurs et les contournements.
Service blueprintingLe flux traverse plusieurs canaux ou implique des opérations en coulisse (personnel, systèmes, tiers) qui affectent l'expérience utilisateur.
Critical User Journeys (CUJs)Décider sur quel flux travailler. Un CUJ est le chemin minimal pour réaliser la valeur produit de base — types : à fort trafic, à fort revenu ou critique pour les métriques.

Par défaut : breadboarding.

Notation Breadboard :

Nom du lieu
- affordance → lieu de destination
- affordance → lieu de destination
[ contenu affiché dans ce lieu ]

Signaux de qualité — à quoi ressemble un bon résultat :

  • Chaque affordance a une destination nommée
  • Les chemins d'échec sont breadboardés — pas laissés comme des réflexions après coup
  • Les états vides, de chargement et post-action sont définis
  • Pas d'objets brisés — les attributs et actions d'un objet sont disponibles ensemble, pas éparpillés sur des écrans sans liens croisés
  • Pas d'objets isolés — les relations du modèle conceptuel sont visibles et navigables dans le flux
  • Le flux est minimal : plus de 5 à 6 lieux pour une seule job story est un signal pour chercher ce qui peut être fusionné

Session guidée

Dis-moi pour quel parcours utilisateur tu conçois, ou dis "guide-moi" pour démarrer une session de breadboarding.

Demande : "Où dois-je capturer le travail de cette session ?" (voir /couches-intro pour les options)

Vérifie la couche en dessous : "As-tu un modèle conceptuel — objets définis, relations et vocabulaire — sur lequel travailler ? Ou concevons-nous le flux sans modèle stabilisé en dessous ?" Les flux construits avant que le modèle conceptuel ne soit stable doivent souvent être repris.

Demande : "Pour quel parcours utilisateur ou job story concevons-nous ?" Un breadboard est toujours destiné à un utilisateur particulier, dans une situation particulière, effectuant un job particulier.


Phase 1 — Cadrer le flux

  1. Quel job story ce flux sert-il ?
  2. Où l'utilisateur commence-t-il ? Dans quelle situation se trouve-t-il ?
  3. À quoi ressemble le succès — qu'a accompli l'utilisateur lorsque le flux se termine ?
  4. Nouveau flux, refonte ou extension d'un flux existant ?

S'il s'agit d'une refonte : décrire d'abord le flux actuel, même approximativement. Les flux existants révèlent des décisions déjà prises — certaines délibérées, beaucoup non.

Phase 2 — Identifier les lieux

"Quels sont les lieux distincts — écrans ou états — par lesquels ce flux transite ? Ne pense pas encore à la mise en page. Nomme simplement les lieux."

Demande : certains d'entre eux sont-ils le même lieu dans un état différent ? Doivent-ils être des lieux séparés ou un seul lieu avec des états ? Y a-t-il d'autres lieux ailleurs dans le produit auxquels ce flux se connecte ?

Nommer les lieux est en soi une décision de conception. Des noms descriptifs et significatifs pour l'utilisateur : "Tableau de bord des recommandations" pas "Page 3."

Phase 3 — Mapper les affordances et connexions

Pour chaque lieu, parcourir ce que l'utilisateur peut y faire et où chaque action mène. Utiliser la notation breadboard ci-dessus.

Pour chaque affordance : où exactement cela mène-t-il ? Que se passe-t-il si cela réussit ? Échoue ? Est-ce toujours disponible, ou seulement dans certaines conditions ?

Les conditions — quand les affordances sont ou ne sont pas disponibles — sont souvent là où se cachent les véritables décisions de conception.

Phase 4 — Parcourir le flux

Narrer en tant qu'utilisateur : "Je suis un utilisateur qui [situation du job story]. J'arrive à [lieu de départ]. Je vois [contenu]. Je veux [motivation]. Alors je [affordance]..."

Parcourir l'ensemble du chemin réussi. Puis parcourir les bords :

  • États vides : À quoi ressemble ce lieu avant qu'aucune donnée n'existe ? Souvent la première chose qu'un nouvel utilisateur voit.
  • États de chargement / asynchrones : Que voit l'utilisateur pendant que les données se chargent ou qu'une action est en cours de traitement ?
  • État post-action : Après avoir soumis, que se passe-t-il ? Rester ici, rediriger, confirmation en ligne ? Si redirigé vers une liste — la modification apparaît-elle immédiatement ? S'il y a un délai, cela pourrait-il donner l'impression que l'action n'a pas fonctionné ?
  • Optimiste vs. pessimiste : Afficher le résultat supposé avant confirmation du serveur, ou attendre ? Énoncer la préférence ; signaler comme question ouverte nommée si l'implémentation est incertaine.
  • Chemins d'échec : Pour chaque action — échec de validation, erreur serveur, déconnexion réseau, timeout, modification concurrente. Où va l'utilisateur ? Comment récupère-t-il ? Ce sont des étapes obligatoires du breadboard.
  • Chemin d'annulation : Si l'utilisateur veut s'arrêter à mi-chemin, où va-t-il ?
  • Points d'entrée alternatifs : Le flux suppose-t-il un état antérieur qui pourrait ne pas toujours être vrai ?

Chaque lacune est une décision de conception non prise. La nommer explicitement.

Phase 5 — Mettre au défi le flux

  • Y a-t-il une étape que les utilisateurs sont susceptibles d'abandonner ? Pourquoi est-elle là — est-elle nécessaire ?
  • Y a-t-il des actions que les utilisateurs attendraient et que le flux n'offre pas ?
  • Le vocabulaire du flux correspond-il au langage ubiquitaire du modèle conceptuel ?
  • Existe-t-il une version plus simple qui sert le même job ?

Vérifier les objets brisés : Pour chaque objet du modèle conceptuel apparaissant dans ce flux — ses attributs et actions sont-ils disponibles ensemble, ou répartis sur plusieurs écrans sans liens croisés ? Si répartis, soit consolider, soit ajouter des connexions explicites entre les lieux où ses parties apparaissent.

Vérifier les objets isolés : Pour chaque relation définie dans le modèle conceptuel — le flux rend-il cette relation visible et navigable ? Si une relation existe dans le modèle mais est invisible dans le flux, soit la faire apparaître, soit prendre une décision délibérée qu'elle n'a pas besoin d'être navigable depuis ce flux.

Phase 6 — Générer le breadboard

Produire le breadboard complet : tous les lieux, toutes les affordances et destinations, le contenu pour chaque lieu, les états conditionnels clés notés.

Générer un diagramme de flux orienté gauche-droite — le flux dans le temps se lit de gauche à droite. En Mermaid : graph LR.

Note : le diagramme sert à l'orientation — le breadboard textuel est le document principal. Le diagramme perd le contenu et les détails conditionnels.


Achèvement

Produire :

  1. Job story — le besoin utilisateur que ce flux sert
  2. Breadboard — notation textuelle complète
  3. Diagramme de flux — Mermaid graph LR
  4. Décisions ouvertes — lacunes, cas limites, états conditionnels non encore résolus
  5. Risques — dépendances vis-à-vis de décisions non stabilisées du modèle conceptuel ou d'hypothèses de surface

Conclure par : "Ce breadboard définit la logique d'interaction sans s'engager sur une forme visuelle. Quelle que soit la suite — travailler en code, construire dans le médium réel, ou conception visuelle détaillée — assurez-vous d'abord que le modèle conceptuel sous-jacent à ce flux est stable."

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 associés