Communitygithub.com

design-theme (Thème de Design pour Portfolio Développeur AI)

Définit les normes UI/UX et de conception visuelle pour un portfolio de développeur individuel, orienté produit et intelligence artificielle.

Qu'est-ce que design-theme (Thème de Design pour Portfolio Développeur AI) ?

Cette compétence établit un système de conception complet pour un portfolio développeur, axé sur la lisibilité, le minimalisme technique et la mise en avant des projets réels. Elle spécifie les couleurs (fond #FAFAFA, accent bleu #2563EB), la typographie (Pretendard, Geist Mono), la grille (2 colonnes desktop/tablet, 1 colonne mobile), les espacements, et les composants clés (Header, Hero, Project Cards, Status, Tags). L'objectif est de transmettre l'image d'un développeur qui résout des problèmes concrets en utilisant l'IA et le logiciel, plutôt que de simplement lister des technologies. La compétence interdit les décorations excessives, les badges arc-en-ciel, les animations superflues, et les données inventées. Elle s'applique à tout assistant codant un portfolio Next.js/React/TypeScript/Tailwind CSS, en imposant une séparation stricte entre le contenu et l'UI, et en priorisant l'accessibilité et la conception réactive. Les règles non négociables incluent : ne jamais générer de fausses informations, toujours vérifier les modifications majeures avec l'utilisateur, et maintenir un design professionnel, moderne, minimal et technique.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wjdgus6480/portfolio/tree/HEAD/claude/skills/design-theme

Demander à votre IA préférée

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

Documentation

Compétence Thème de Design

1. Identité de la Compétence

  • Nom : design-theme
  • Objectif : Définir les normes UI/UX et de conception visuelle pour un portfolio de développeur individuel.
  • Cible : Portfolio de développeur IA / Logiciel / Produit
  • Objectif Principal : Transmettre l'impression d'un développeur qui découvre de vrais problèmes et crée des produits avec l'IA et les logiciels, plutôt qu'un simple portfolio énumérant des technologies.

2. Philosophie de Conception Fondamentale

Ce portfolio privilégie les impressions suivantes :

  • Professionnel
  • Moderne
  • Minimal
  • Technique
  • Orienté Produit
  • Lisible
  • Digne de Confiance

Principes Clés

"Le contenu et les projets doivent être les vedettes, pas la décoration."

L'utilisateur doit pouvoir comprendre rapidement dès le premier écran :

  1. Qui est-ce ?
  2. Que crée-t-il ?
  3. Quels problèmes résout-il ?
  4. Quels projets a-t-il réalisés ?
  5. Quelles technologies utilise-t-il ?
  6. Est-ce une personne capable de développer concrètement ?

3. Direction Visuelle

Orientation de Base

  • Mode Clair en priorité
  • Fond blanc/gris clair épuré
  • Accent Bleu limité
  • Bordures fines
  • Espaces blancs généreux
  • Typographie forte
  • Grille ordonnée
  • Décoration excessive minimisée

Orientations à Éviter

Les designs suivants sont fondamentalement exclus :

  • Dégradé excessif
  • Lueur forte
  • Glassmorphisme
  • Effets 3D excessifs
  • Animations sans signification
  • Ombres excessives
  • Couleurs arc-en-ciel
  • Badges trop nombreux
  • Illustrations décoratives abusives
  • Template générique commun dans les portfolios IA
  • Badges technologiques utilisant des couleurs différentes pour chaque technologie
  • Layout où le design prime sur le contenu

4. Système de Couleurs

Base

Arrière-plan      #FAFAFA
Surface           #FFFFFF
Premier plan      #18181B
Texte Secondaire  #52525B
Texte Faible      #71717A
Espace réservé    #A1A1AA
Bordure           #E4E4E7
Arrière-plan Faible #F4F4F5

Accent

Accent            #2563EB
Accent Survol     #1D4ED8
Accent Doux       #EFF6FF

L'accent est utilisé de manière limitée sur l'ensemble de l'écran.

Emplacements d'Utilisation de l'Accent

  • CTA Principal
  • Liens importants
  • Navigation active
  • État Focus
  • Informations importantes
  • Statuts de projet nécessitant une mise en évidence

L'accent ne doit pas être utilisé de manière excessive comme fond d'écran ou décoration.

Statuts

Succès #16A34A
Avertissement #D97706
Erreur   #DC2626

Les couleurs de statut sont utilisées uniquement pour exprimer un état réel.


5. Typographie

Priorité des Polices

La lisibilité du coréen est prioritaire.

Ordre recommandé :

Pretendard
system-ui
sans-serif

Pour le code, les noms de technologies, les chiffres et les métadonnées, on peut utiliser :

Geist Mono
monospace

Échelle Typographique

Hero

Desktop :

56px ~ 72px
font-weight: 700 ~ 800
line-height: 1.05 ~ 1.15

Mobile :

40px ~ 48px
font-weight: 700 ~ 800
line-height: 1.1 ~ 1.2

H2

Desktop :

36px ~ 44px

Mobile :

30px ~ 34px

H3

20px ~ 24px

Corps de Texte

16px ~ 18px
line-height: 1.6 ~ 1.75

Petit / Méta

13px ~ 14px

6. Système de Mise en Page

Conteneur

Largeur maximale par défaut :

1200px

Padding Horizontal

Desktop :

32px ~ 48px

Tablette :

24px

Mobile :

20px

Espacement des Sections

Desktop :

120px ~ 160px

Mobile :

80px ~ 100px

L'espacement n'est pas appliqué de manière uniforme à toute la page.

Ajustez l'espacement en fonction de l'importance du contenu.


7. Système de Grille

La zone Projet utilise par défaut la structure suivante.

Desktop

2 Colonnes

Tablette

2 Colonnes

Mobile

1 Colonne

Les grilles de 3 colonnes ou plus ne sont pas utilisées sans raison particulière.

La lisibilité du contenu des cartes de projet est plus importante que le nombre de colonnes.


8. En-tête

L'en-tête est composé d'une UI minimale pour faciliter la navigation dans le portfolio.

Structure recommandée :

Logo / Nom
Projets
À propos / Approche
Contact

Si souhaité, un lien vers le CV ou GitHub peut être ajouté.

Principes de l'En-tête

  • Interdiction d'un en-tête trop grand
  • Ne pas étendre excessivement la navigation
  • En mobile, réduire au menu si nécessaire
  • L'état Actif utilise l'accent de manière limitée

9. Hero

Le Hero est la zone la plus importante du premier écran.

L'objectif n'est pas d'être flashy, mais de transmettre immédiatement l'identité du développeur.

Structure recommandée :

Surtitre
↓
Titre Principal
↓
Brève Description
↓
CTA Principal / CTA Secondaire

Exemple d'orientation :

Quand je découvre un problème,
je le résous moi-même.

Développeur qui résout des problèmes réels avec l'IA et les logiciels
et les transforme en produits, Jeonghyeon Yun

Cependant, le texte final réel est géré dans un fichier de contenu séparé.

Ne pas coder en dur le contenu du composant Hero.


10. Conception du Projet

Les projets sont le contenu central du portfolio.

Une carte de projet ne doit pas être simplement une carte affichant des noms de technologies.

Dans la mesure du possible, transmettez les informations suivantes :

Nom du Projet
Statut
Résumé Court
Problème
Solution
Technologies
Période

Ne forcez pas toutes les informations dans une seule carte.

Si les informations sont nombreuses, redirigez vers une page de détail.


11. Carte de Projet

Style de base :

Arrière-plan : #FFFFFF
Bordure : 1px solid #E4E4E7
Rayon de Bordure : 12px ~ 16px
Padding : 24px ~ 32px
Ombre : none ou très légère

L'effet de survol est minimisé.

Recommandé :

Changement de border-color
Changement de background
transform : très léger

N'utilisez pas d'effets de zoom excessifs ou de lueur.


12. Statut du Projet

Le statut du projet est exprimé clairement.

Exemples :

En ligne
En cours
Archivé

Ne transmettez pas le sens uniquement par la couleur.

Utilisez du texte ou une icône en complément.


13. Étiquettes Technologiques

Les étiquettes technologiques sont des éléments auxiliaires pour une identification rapide.

N'appliquez pas de couleurs arc-en-ciel à chaque technologie.

Utilisez un style Neutre par défaut.

Exemple :

Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
Agent IA

Les étiquettes technologiques ne doivent pas être plus visibles que la description du projet.


14. Page de Détail du Projet

Lors du clic sur une carte de projet, la structure suivante peut être utilisée :

En-tête du Projet
↓
Aperçu
↓
Problème
↓
Approche
↓
Implémentation
↓
Défis
↓
Résultat
↓
Ce que j'ai appris
↓
Technologies
↓
Liens

Tous les projets ne doivent pas nécessairement avoir toutes les sections.

Affichez uniquement les informations existantes dans le projet réel.


15. Projets Mis en Avant

Sur la page d'accueil, n'affichez pas tous les projets avec le même poids.

Sélectionnez les projets principaux en fonction du statut featured.

Exemple :

featured: true

L'UI affiche les projets en fonction de la valeur featured.

Par conséquent, il ne doit pas être nécessaire de modifier le code du composant pour exclure un projet de la section "À la Une".


16. Plus de Projets

Sous les projets mis en avant, une zone peut être prévue pour voir d'autres projets.

Objectif :

Il ne s'agit pas d'éviter que les projets paraissent peu nombreux, mais de montrer la diversité des problèmes que le développeur a résolus.

Maintenez une hiérarchie visuelle entre les projets mis en avant et les projets généraux.


17. Section Approche

Au lieu d'un "À propos de moi" générique, privilégiez une zone montrant l'approche de développement.

Exemple :

01 Problème
02 Découverte
03 Apprentissage
04 Construction
05 Résultat

Le message clé est le suivant :

Découvrir un problème → Enquêter → Apprendre les technologies nécessaires → Construire soi-même → Vérifier le résultat.

Privilégiez la présentation du processus de développement réel et de la mentalité plutôt qu'une simple introduction personnelle.


18. Compétences

Les compétences ne sont pas une simple liste de technologies, mais montrent le contexte d'utilisation réel.

Classification recommandée :

Frontend
Backend
IA / Automatisation
Base de données
Outils

Exemple :

Frontend
Next.js
React
TypeScript
Tailwind CSS

Backend
Python
FastAPI
Flask

IA / Automatisation
Agent IA
RAG
API LLM
Automatisation

Base de données
SQLite
PostgreSQL
Supabase

Outils
Git
GitHub
VS Code

Cependant, n'ajoutez pas de technologies sans expérience réelle d'utilisation.


19. Représentation des Compétences

N'exprimez pas le niveau de compétence technique par des chiffres ou des étoiles arbitraires.

Interdit :

Python ★★★★★
React 90%
IA 95%

À la place, reliez les technologies aux projets réels et à leur objectif.

Exemple :

Python
→ Utilisé pour des projets d'Agent IA / Automatisation / Backend

20. Contact

La zone de contact est conçue de manière simple et claire.

Recommandé :

Message Court
Email
GitHub
LinkedIn ou autres liens réels

Ne créez pas de contacts ou de liens qui n'existent pas réellement.


21. Pied de Page

Le pied de page est minimal.

Exemple :

© 2026 Jeonghyeon Yun
Construit avec Next.js

N'ajoutez pas plus d'informations que nécessaire.


22. Conception Réactive

Tenez impérativement compte des environnements suivants.

Desktop
Tablette
Mobile

N'implémentez pas le responsive en réduisant simplement la taille de l'écran.

En particulier sur Mobile, appliquez :

  • Modification de la structure de navigation
  • Ajustement de la typographie Hero
  • Grille → 1 Colonne
  • Ajustement de la taille des boutons
  • Réduction du padding
  • Vérification du retour à la ligne des textes longs
  • Ajustement des priorités d'information sur les cartes de projet

23. Accessibilité

Tenez impérativement compte de l'accessibilité de base.

  • Hiérarchie de titres appropriée
  • Contraste de couleurs suffisant
  • Focus clavier
  • Boutons / Liens clairs
  • Texte alternatif des images
  • Zones tactiles de 44px ou plus recommandées
  • Ne pas distinguer les états uniquement par la couleur
  • Configurer pour que l'information soit transmise même sans animation

24. Animation

Les animations ne sont utilisées que si elles aident la fonctionnalité.

Recommandé :

150ms ~ 300ms
ease-out

Zones autorisées :

  • Survol de bouton
  • Survol de lien
  • Survol de carte
  • Navigation
  • Court dévoilement de section

Zones interdites :

  • Effet Parallaxe
  • Animation de défilement excessive
  • Mouvement continu
  • Animation décorative sans signification
  • Mise en scène excessive à l'entrée de la page

25. Mode Sombre

Actuellement, pour la version 1, le mode clair est prioritaire.

Le mode sombre sera ajouté lorsqu'une exigence distincte apparaîtra.

Évitez que le mode sombre ne complexifie le système de design ou la structure des composants actuels.


26. Règles de Conception Technique

Tailwind CSS est utilisé comme système de style par défaut.

Les variables CSS sont utilisées pour gérer les jetons de design globaux.

Recommandé :

Tailwind
+
Variables CSS

N'utilisez pas de styles en ligne inutiles.


27. Règles des Composants

Utilisez React Server Component comme valeur par défaut.

Utilisez Client Component uniquement dans les cas suivants :

  • Saisie utilisateur
  • Gestion d'état
  • API navigateur
  • Interaction basée sur des événements
  • Cas nécessitant une exécution côté client (bibliothèque d'animations, etc.)

Ne faites pas de la page entière un Client Component inutilement.


28. Séparation Contenu / UI

Séparez le contenu et l'UI.

Structure recommandée :

content/
├─ profile.ts
├─ projects.ts
├─ skills.ts
└─ types.ts

N'écrivez pas directement les informations du projet dans les composants UI.

Pour ajouter ou modifier un projet, si possible :

content/projects.ts

Concevez-le de manière à ce que la modification de ce seul fichier suffise à mettre à jour l'affichage.


29. Principe des Données de Projet

Les données de projet sont gérées sous une forme structurée.

Exemple :

{
  slug,
  title,
  summary,
  problem,
  solution,
  tech,
  status,
  featured,
  period,
  image,
  links,
  highlights
}

Utilisez uniquement les valeurs nécessaires.

Ne remplissez pas arbitrairement des informations qui n'existent pas réellement.


30. Règles des Images

Si une image de projet n'existe pas réellement, ne générez ni n'importez une image arbitraire.

Si un espace réservé (placeholder) est nécessaire, indiquez clairement qu'il s'agit d'un placeholder.

Créez une structure permettant de remplacer l'image par une capture d'écran réelle du projet dès qu'elle sera disponible.


31. Intégrité des Données

C'est l'un des principes les plus importants du portfolio.

Ne générez jamais arbitrairement les éléments suivants :

  • Projets inexistants
  • Expériences techniques inexistantes
  • Réalisations inexistantes
  • Chiffres inexistants
  • Clients inexistants
  • Expériences en entreprise inexistantes
  • Liens inexistants
  • Certifications/qualifications inexistantes
  • Résultats de projets inexistants

En cas de manque d'informations, privilégiez :

Laisser vide

ou

Vérifier auprès de l'utilisateur

32. Préservation des Projets Existants

Ne modifiez pas arbitrairement le sens des projets existants.

Travaillez en vous basant sur les descriptions de projet ou les exigences fournies par l'utilisateur.

Si la suppression ou la réduction de fonctionnalités existantes est nécessaire, expliquez d'abord la raison et demandez une confirmation.


33. Architecture de l'Information du Portfolio

La structure d'accueil par défaut privilégie l'ordre suivant :

En-tête
↓
Hero
↓
Projets Mis en Avant
↓
Plus de Projets
↓
Approche
↓
Compétences
↓
Contact
↓
Pied de Page

Cependant, elle peut être ajustée en fonction du contenu réel et de l'utilisabilité.


34. Priorité des Décisions de Conception

En cas de conflit de conception, suivez l'ordre de priorité suivant :

1. Lisibilité du contenu
2. Hiérarchie de l'information
3. Accessibilité
4. Utilisabilité réactive (responsive)
5. Cohérence
6. Esthétique visuelle
7. Effets décoratifs

Privilégiez un design facile à lire et à comprendre plutôt qu'un design simplement joli.


35. Flux de Travail d'Implémentation

Pour créer une nouvelle page ou UI, suivez l'ordre suivant :

ÉTAPE 1. Analyser

Vérifiez d'abord la structure actuelle du projet et l'UI existante.

ÉTAPE 2. Planifier

Proposez la structure d'information et la composition d'écran nécessaires.

ÉTAPE 3. Concevoir

Proposez une direction visuelle basée sur les principes de conception de ce SKILL.md.

ÉTAPE 4. Composant

Proposez la structure de composant nécessaire.

ÉTAPE 5. Confirmer

Avant l'implémentation, obtenez la confirmation de l'utilisateur pour les changements de structure majeurs ou les nouvelles fonctionnalités.

ÉTAPE 6. Implémenter

Implémentez uniquement le périmètre confirmé.

ÉTAPE 7. Vérifier

Vérifiez les points suivants :

TypeScript
Build
Responsive
Accessibilité
Cohérence visuelle
Fonctionnalités existantes

36. Gestion du Changement

Pour les petites modifications, conservez autant que possible la structure existante.

Avant un changement important :

  1. Vérifier la structure actuelle
  2. Expliquer la raison du changement
  3. Vérifier le périmètre d'impact
  4. Proposer des alternatives
  5. Obtenir l'approbation de l'utilisateur
  6. Implémenter

Suivez cet ordre.


37. Dépendances

N'ajoutez de nouvelles bibliothèques que si la nécessité est claire.

Si les fonctionnalités existantes de Next.js / React / TypeScript / Tailwind peuvent résoudre le problème, n'ajoutez pas de nouvelle bibliothèque.

Si une bibliothèque doit être ajoutée, examinez d'abord :

Pourquoi est-elle nécessaire
Quel problème résout-elle
Existe-t-il une alternative ?

38. Principe Supabase / Backend

Actuellement, la version 1 du portfolio commence avec un contenu statique.

Utilisez d'abord :

content/*.ts

Un backend comme Supabase ne sera ajouté que lorsque les besoins suivants se présenteront réellement :

  • Page d'administration
  • CRUD de projets
  • Blog
  • Journal de développement
  • Enregistrement des demandes de contact
  • Authentification
  • Gestion de données dynamiques

N'introduisez pas de base de données à un stade où un backend n'est pas nécessaire.


39. Flux de Travail Git

Effectuez un commit lorsqu'une unité de travail significative est terminée.

Flux de base :

git add .
git commit -m "Contenu du travail"
git push

Le format Conventional Commit est recommandé pour les messages de commit.

Exemple :

feat: add portfolio homepage
feat: add project section
style: improve project cards
fix: resolve mobile layout
refactor: simplify project components
docs: update portfolio documentation
chore: update dependencies

Ne regroupez pas les unités de travail de manière excessivement large.


40. Norme de Qualité Finale

L'écran terminé doit pouvoir répondre "Oui" aux questions suivantes :

  • L'identité du développeur est-elle visible dès le premier écran ?
  • Les projets apparaissent-ils comme le contenu central ?
  • Comprend-on ce que chaque projet a résolu ?
  • Les résultats et le processus réels sont-ils mis en avant plutôt que la simple liste de technologies ?
  • Le portfolio est-il facile à lire sur mobile ?
  • Le contenu et l'UI sont-ils séparés ?
  • Est-il facile d'ajouter un nouveau projet ?
  • Aucune information inexistante n'est-elle incluse ?
  • L'impression professionnelle est-elle donnée sans effets de conception excessifs ?
  • Aucune fonctionnalité existante n'a-t-elle été supprimée inutilement ?

41. Règles Non Négociables

Les principes suivants sont toujours maintenus.

  1. La décoration ne prime jamais sur le contenu.
  2. Les projets sont le cœur du portfolio.
  3. N'inventez pas de contenu qui ne correspond pas à une expérience réelle.
  4. N'ajoutez pas arbitrairement des réalisations ou des chiffres que l'utilisateur n'a pas fournis.
  5. Séparez le contenu et l'UI.
  6. La conception réactive est un prérequis.
  7. Tenez compte de l'accessibilité.
  8. N'ajoutez pas de bibliothèques inutiles.
  9. Ne supprimez pas arbitrairement des fonctionnalités existantes.
  10. Les changements de structure majeurs sont confirmés avec l'utilisateur avant l'implémentation.
  11. Le design maintient une orientation Professionnelle / Moderne / Minimale / Technique.
  12. Le mode clair reste la valeur par défaut de la version 1.
  13. Concevez le système pour que l'ajout de projets ne nécessite pas de modification du code UI.
  14. Toutes les décisions de conception privilégient la lisibilité et la transmission de l'information.

Skills associés