Communitygithub.com

ulasalyesil/personal-website-v2

Orientation du framework pour les Couches de Conception Produit — à charger en premier ; fournit le contexte dont dépendent toutes les autres compétences

Qu'est-ce que personal-website-v2 ?

Cette compétence d'agent, nommée `/layers-intro`, est le point d'entrée obligatoire pour toute session de conception utilisant le framework **Couches de Conception Produit**. Elle établit le contexte fondamental sur lequel s'appuient toutes les autres compétences `/layers-*`. Le framework organise le travail de conception en sept couches réparties dans trois zones : l'espace problème (comportement observé, domaine, besoins utilisateur) et l'espace solution (stratégie produit, modèle conceptuel, structure d'interaction, surface). L'utilisabilité de cette compétence inclut l'intégration native avec l'extension Markdown Preview Mermaid Support pour VSCode et la possibilité de sauvegarder les résultats dans Notion ou directement dans la conversation. Elle est conçue pour aider les concepteurs à prendre de meilleures décisions en structurant la réflexion et en évitant les erreurs de couche.

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

Demander à votre IA préférée

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

Documentation

/layers-intro

Chargez cette compétence au début de toute session de conception. Elle fournit le contexte du framework dont dépendent toutes les autres compétences /layers-*.


Le framework

Couches de Conception Produit organise le travail de conception en sept couches réparties dans trois zones. Les couches ont une dépendance logique : les couches inférieures servent de fondations aux couches supérieures. Des couches inférieures faibles créent une dette UX qui se propage vers le haut.

Réalité — complexe, contradictoire, en évolution. Source de tout apprentissage.

Espace problème — connaissances rassemblées depuis la réalité :

  1. Comportement observé — ce que les utilisateurs font réellement
  2. Le domaine — concepts, terminologie et modèles mentaux qui existent indépendamment de tout produit
  3. Besoins utilisateur — ce que nous pensons que les utilisateurs essaient d'accomplir, et pourquoi

Espace solution — décisions délibérées sur ce qu'il faut construire : 4. Stratégie produit & service — quels besoins servir, et quels résultats métier viser 5. Modèle conceptuel — objets, relations, états, vocabulaire — indépendant de toute interface 6. Structure d'interaction et flux — lieux, affordances, connexions et logique de flux 7. Surface — mots, visuels, feedback, hiérarchie — ce que les utilisateurs rencontrent réellement

Les couches ne sont pas un processus linéaire. Entrez n'importe où — mais vérifiez toujours que les fondations en dessous sont solides.

Inspiré par The Elements of User Experience de Jesse James Garrett (2000).


La conception est une prise de décision

Conception = prendre des décisions sur la forme d'une solution (Christopher Alexander). La forme est la solution ; le contexte est les exigences, contraintes et environnement auxquels elle doit s'adapter. Un bon design est un bon ajustement.

Quatre types de progrès :

  1. Prendre des décisions — résoudre quelque chose d'indécidé
  2. Découvrir des décisions non prises — découvrir ce qui n'a pas encore été décidé (souvent plus précieux que 1)
  3. Évaluer les décisions — identifier les décisions déjà prises qui sont risquées, incohérentes ou erronées
  4. Prioriser les décisions — les couches inférieures sont plus fondamentales et comportent plus de risques si elles sont erronées

Le travail de chaque compétence est d'aider le concepteur à prendre de meilleures décisions — pas de prendre les décisions à sa place.


Principes — s'appliquent à toutes les sessions

  1. Décisions, pas de livrables. Les artefacts ne sont utiles que dans la mesure où ils représentent des décisions prises ou mises en lumière. Nommez la décision, pas seulement le diagramme.
  2. Découvrez avant de résoudre. Mettre en lumière des décisions que le concepteur ne savait pas devoir prendre est souvent plus précieux que de répondre à celles qu'il avait identifiées.
  3. Travaillez une couche à la fois. Confondre espace problème et espace solution, ou surface et modèle conceptuel, produit des résultats confus.
  4. Vérifiez les fondations avant de construire vers le haut. Avant de travailler sur une couche supérieure, auditez la couche inférieure. Signalez l'instabilité.
  5. Le modèle conceptuel est la couche porteuse la plus négligée. Accordez-lui plus d'attention que ce qui semble confortable.
  6. Signalez les mauvaises décisions, pas seulement celles qui manquent. Une décision déjà prise qui est risquée ou incohérente doit être nommée, pas contournée.
  7. Guide, ne te laisse pas guider. Ne sautez pas à un résultat de surface avant que les décisions fondamentales soient prises.
  8. Principes de conception vs. décisions d'implémentation. Certaines décisions peuvent être énoncées sans connaître les contraintes système — ce qui devrait se produire du point de vue de l'utilisateur. D'autres sont liées à l'implémentation : formulez l'exigence d'expérience utilisateur, formez une question bien structurée et portez-la dans une conversation conception+ingénierie. Ne forcez pas une réponse prématurée.

La dimension temporelle — sonde proactive

Les décisions temporelles sont souvent négligées. Elles se regroupent à deux couches :

Couche du modèle conceptuel :

  • États d'action intermédiaires — un objet passe-t-il par des états transitoires (sauvegarde, traitement, approbation en attente) avant d'être résolu ? Ce sont des états du modèle.
  • Décalage du modèle de lecture — écart entre le moment où les données sont écrites et celui où elles sont visibles ? Formulez le besoin utilisateur ; signalez-le comme une question ouverte nommée pour l'ingénierie.
  • Temporalité des relations — « tous les produits en Europe » signifie le groupe maintenant, ou l'appartenance telle qu'elle évolue ? C'est une décision de conception.
  • Sémantique de suppression — archiver, corbeille, suppression définitive ou suppression réglementaire ? Indiquez laquelle et pourquoi. L'implémentation suit.
  • Historique — est-ce important ce qu'un objet était dans le passé ? Dire que cela importe est une décision de conception.

Couche de la structure d'interaction :

  • État post-action — après soumission, que voit l'utilisateur ? Une liste redirigée reflète-t-elle immédiatement le changement ?
  • Mises à jour optimistes vs. pessimistes — afficher le résultat supposé avant que le serveur confirme, ou attendre ? Indiquez la préférence ; signalez comme question ouverte si l'implémentation est incertaine.
  • États vides, de chargement et partiels — chaque endroit a un cycle de vie temporel. Concevez-les tous.
  • Chemins d'erreur et d'échec — échec de validation, erreur serveur, déconnexion réseau, édition simultanée. Étapes de conception requises, pas des après-coups.

Signaux de modes d'échec

Modes d'échec d'objet OOUX (Sophia Prater) :

  • Caméléon — même objet sous des formes significativement différentes selon les contextes. Correction de surface : traitement cohérent de l'objet. Correction plus profonde si le modèle ne définit pas l'objet clairement.
  • Masqué — différents types d'objets qui semblent identiques. Correction de surface : traitements visuels distincts. Correction plus profonde si le modèle ne les différencie pas.
  • Cassé — données et actions d'un objet dispersées sur les écrans sans liens croisés. Problème de structure d'interaction → /layers-interaction-flow.
  • Isolé — des objets existent sans relations visibles avec d'autres objets. Problème de modèle conceptuel → /layers-conceptual-model.

Heuristiques de Nielsen — un mapping de couche racine : Les violations de « Correspondance entre le système et le monde réel » prennent presque toujours racine dans le modèle conceptuel, pas dans la surface. « Contrôle et liberté de l'utilisateur » est une décision de structure d'interaction. Corriger ces problèmes en surface traite les symptômes, pas les causes.


Capture du travail

Au début de toute session de conception, demandez où sauvegarder les résultats :

« Où devrais-je capturer le travail de cette session ? La configuration recommandée est un fichier Markdown dans votre projet — les diagrammes sont écrits en Mermaid intégré et s'affichent nativement dans VSCode avec l'extension Markdown Preview Mermaid Support. Alternatives :

  • Notion — si vous avez le MCP Notion connecté
  • Directement dans la conversation — aucun fichier nécessaire »

Enregistrez le résumé de session à la destination choisie à la fin.

Lors de l'écriture de diagrammes Mermaid, utilisez <br/> pour les sauts de ligne dans les étiquettes de nœud — pas \n, qui s'affiche comme du texte littéral.


Par où commencer

  • Vous ne savez pas sur quoi vous concentrer ? → /layers-orient — diagnostic rapide sur les sept couches
  • Vous savez à quelle couche vous êtes ? → accédez directement à cette compétence

Compétences : /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

Skills associés