Design-Theme Skill
1. Skill-Identität
- Name: design-theme
- Zweck: Definiert die gesamten UI/UX- und visuellen Designstandards für ein persönliches Entwickler-Portfolio.
- Zielgruppe: KI / Software / Produktentwickler Portfolio
- Hauptziel: Nicht ein Portfolio, das Technologien auflistet, sondern den Eindruck eines Entwicklers vermitteln, der echte Probleme erkennt und Produkte mit KI und Software entwickelt.
2. Kern-Designphilosophie
Dieses Portfolio priorisiert die folgenden Eindrücke:
- Professional
- Modern
- Minimal
- Technical
- Product-oriented
- Readable
- Trustworthy
Kernprinzip
„Inhalt und Projekte sollten die Hauptdarsteller sein, nicht die Dekoration.“
Der Benutzer sollte beim Anblick des ersten Bildschirms schnell Folgendes verstehen können:
- Wer ist das?
- Was wird entwickelt?
- Welche Probleme werden gelöst?
- Welche Projekte wurden erstellt?
- Welche Technologien werden verwendet?
- Ist die Person tatsächlich in der Lage zu entwickeln?
3. Visuelle Richtung
Grundrichtung
- Light Mode priorisieren
- Saubere weiße/helle graue Basis
- Limitierte Blue Accent
- Dünne Borders
- Großzügiger Whitespace
- Starke Typografie
- Aufgeräumtes Grid
- Minimierung übermäßiger Dekoration
Zu vermeidende Richtungen
Die folgenden Designs werden grundsätzlich nicht verwendet:
- Übermäßige Gradienten
- Starke Glow-Effekte
- Glassmorphism
- Übermäßige 3D-Effekte
- Sinnlose Animationen
- Übermäßige Schatten
- Regenbogenfarben
- Zu viele Badges
- Übermäßiger Einsatz von Deko-Illustrationen
- Generische Vorlagen, die häufig in KI-Portfolios vorkommen
- Wahlloser Einsatz von Tech-Badges mit unterschiedlichen Farben für jede Technologie
- Layouts, bei denen das Design mehr hervorsticht als der Inhalt
4. Farbsystem
Basis
Background #FAFAFA
Surface #FFFFFF
Foreground #18181B
Text Secondary #52525B
Text Weak #71717A
Placeholder #A1A1AA
Border #E4E4E7
Background Weak #F4F4F5
Akzent
Accent #2563EB
Accent Hover #1D4ED8
Accent Soft #EFF6FF
Der Akzent wird auf dem gesamten Bildschirm sparsam eingesetzt.
Akzent-Positionen
- Primary CTA
- Hauptlinks
- Aktive Navigation
- Fokus-Zustände
- Wichtige Informationen
- Projektstatus, die hervorgehoben werden müssen
Der Akzent wird nicht übermäßig als Hintergrund oder Dekoration auf dem gesamten Bildschirm verwendet.
Status
Success #16A34A
Warning #D97706
Error #DC2626
Statusfarben werden nur verwendet, wenn sie einen tatsächlichen Status darstellen.
5. Typografie
Schriftarten-Priorität
Die Lesbarkeit von Koreanisch wird priorisiert.
Empfohlene Reihenfolge:
Pretendard
system-ui
sans-serif
Für Code, Technologienamen, Zahlen und Metainformationen kann Folgendes verwendet werden:
Geist Mono
monospace
Typografie-Skala
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
Body
16px ~ 18px
line-height: 1.6 ~ 1.75
Small / Meta
13px ~ 14px
6. Layout-System
Container
Standard maximale Breite:
1200px
Horizontaler Abstand (Padding)
Desktop:
32px ~ 48px
Tablet:
24px
Mobile:
20px
Abschnittsabstand (Section Spacing)
Desktop:
120px ~ 160px
Mobile:
80px ~ 100px
Einheitliche Abstände werden nicht über die gesamte Seite erzwungen.
Die Abstände werden basierend auf der Wichtigkeit des Inhalts angepasst.
7. Grid-System
Der Projektbereich verwendet standardmäßig die folgende Struktur:
Desktop
2 Spalten
Tablet
2 Spalten
Mobile
1 Spalte
Grids mit 3 oder mehr Spalten werden ohne besonderen Grund nicht verwendet.
Die ausreichende Lesbarkeit des Inhalts der Projektkarten ist wichtiger als die Anzahl der Grids.
8. Header
Der Header besteht aus einer minimalen UI, die die Navigation durch das Portfolio unterstützt.
Empfohlene Struktur:
Logo / Name
Projects
About / Approach
Contact
Bei Bedarf können ein Link zum Lebenslauf oder GitHub hinzugefügt werden.
Header-Prinzipien
- Kein übermäßig großer Header
- Navigation nicht übermäßig erweitern
- Auf Mobilgeräten bei Bedarf auf ein Menü reduzieren
- Aktiven Status mit sparsamen Akzenten kennzeichnen
9. Hero
Der Hero-Bereich ist der wichtigste Bereich auf dem ersten Bildschirm.
Das Ziel ist nicht, auffällig zu sein, sondern die Identität des Entwicklers sofort zu vermitteln.
Empfohlene Struktur:
Eyebrow
↓
Main Heading
↓
Short Description
↓
Primary CTA / Secondary CTA
Beispielrichtung:
Probleme erkennen,
selbst lösen.
Ein Entwickler, der reale Probleme mit KI und Software löst
und daraus Produkte macht, Jeonghyeon Yun
Die endgültigen Formulierungen werden jedoch in einer separaten Inhaltsdatei verwaltet.
Inhalte werden nicht fest im Hero-Komponenten codiert.
10. Projektdesign
Projekte sind der Kerninhalt des Portfolios.
Eine Projektkarte sollte nicht nur der Anzeige von Technologienamen dienen.
Nach Möglichkeit werden die folgenden Informationen vermittelt:
Project Name
Status
Short Summary
Problem
Solution
Technology
Period
Es wird nicht erzwungen, alle Informationen auf einer Karte unterzubringen.
Bei vielen Informationen wird auf eine Detailseite verlinkt.
11. Projektkarte
Standardstil:
Background: #FFFFFF
Border: 1px solid #E4E4E7
Border Radius: 12px ~ 16px
Padding: 24px ~ 32px
Shadow: none oder sehr schwach
Hover-Effekte werden minimiert.
Empfohlen:
border-color Änderung
background Änderung
transform: sehr geringes Ausmaß
Übermäßige Vergrößerungseffekte oder Glow werden nicht verwendet.
12. Projektstatus
Der Projektstatus wird klar dargestellt.
Beispiel:
Live
In Progress
Archived
Die Bedeutung wird nicht allein durch Farbe vermittelt.
Text oder Icons werden zusammen verwendet.
13. Technologie-Tags
Technologie-Tags sind Hilfselemente, um Informationen schnell zu erfassen.
Regenbogenfarben werden nicht pro Technologie angewendet.
Standardmäßig wird ein neutraler Stil verwendet.
Beispiel:
Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
AI Agent
Technologie-Tags sollten nicht auffälliger sein als die Projektbeschreibung.
14. Projektdetailseite
Beim Klick auf eine Projektkarte kann die folgende Struktur verwendet werden:
Project Header
↓
Overview
↓
Problem
↓
Approach
↓
Implementation
↓
Challenges
↓
Result
↓
What I Learned
↓
Technology
↓
Links
Nicht jedes Projekt muss alle Abschnitte enthalten.
Es werden nur die Informationen angezeigt, die im tatsächlichen Projekt vorhanden sind.
15. Featured Projects
Auf der Startseite werden nicht alle Projekte mit demselben Gewicht angezeigt.
Hauptprojekte werden basierend auf dem featured-Status ausgewählt.
Beispiel:
featured: true
Die UI zeigt Projekte basierend auf dem featured-Wert an.
Daher sollte es nicht notwendig sein, den Komponentencode zu ändern, um ein Projekt aus den Featured-Projekten zu entfernen.
16. Weitere Projekte
Unter den Featured-Projekten kann ein Bereich bereitgestellt werden, in dem andere Projekte eingesehen werden können.
Zweck:
Es geht nicht darum, das Portfolio kleiner aussehen zu lassen, sondern zu zeigen, wie vielfältig der Entwickler Probleme gelöst hat.
Die visuelle Hierarchie zwischen Featured-Projekten und normalen Projekten wird beibehalten.
17. Approach-Bereich
Anstelle eines allgemeinen „Über mich“-Bereichs wird zuerst ein Bereich in Betracht gezogen, der die Entwicklungsweise zeigt.
Beispiel:
01 Problem
02 Discovery
03 Learning
04 Building
05 Result
Die Kernbotschaft lautet:
Probleme erkennen → recherchieren → notwendige Technologien lernen → selbst bauen → Ergebnisse prüfen.
Es wird priorisiert, den tatsächlichen Entwicklungsprozess und die Denkweise zu zeigen, anstatt eine einfache Selbstvorstellung.
18. Skills
Skills zeigen nicht nur eine Liste von Technologien, sondern den tatsächlichen Verwendungskontext.
Empfohlene Kategorisierung:
Frontend
Backend
AI / Automation
Database
Tools
Beispiel:
Frontend
Next.js
React
TypeScript
Tailwind CSS
Backend
Python
FastAPI
Flask
AI / Automation
AI Agent
RAG
LLM API
Automation
Database
SQlite
PostgreSQL
Supabase
Tools
Git
GitHub
VS Code
Technologien, mit denen keine tatsächliche Erfahrung besteht, werden nicht hinzugefügt.
19. Skill-Darstellung
Technologiekenntnisse werden nicht mit willkürlichen Zahlen oder Sternen dargestellt.
Verboten:
Python ★★★★★
React 90%
AI 95%
Stattdessen werden die Technologien mit tatsächlichen Projekten und Verwendungszwecken verknüpft.
Beispiel:
Python
→ Verwendet in AI Agent / Automation / Backend Projekten
20. Kontakt
Der Kontaktbereich ist einfach und klar aufgebaut.
Empfohlen:
Short Message
Email
GitHub
LinkedIn oder andere echte Links
Es werden keine nicht existierenden Kontaktdaten oder Links erstellt.
21. Footer
Der Footer ist minimal gehalten.
Beispiel:
© 2026 Jeonghyeon Yun
Built with Next.js
Es werden keine überflüssigen Informationen hinzugefügt.
22. Responsive Design
Die folgenden Umgebungen werden unbedingt berücksichtigt:
Desktop
Tablet
Mobile
Responsive Design wird nicht einfach durch Verkleinern des Bildschirms implementiert.
Insbesondere auf Mobilgeräten werden folgende Anpassungen vorgenommen:
- Änderung der Navigationsstruktur
- Anpassung der Hero-Typografie
- Grid → 1 Spalte
- Anpassung der Button-Größe
- Reduzierung von Padding
- Überprüfung des Zeilenumbruchs bei langen Texten
- Priorisierung der Informationen in Projektkarten
23. Barrierefreiheit (Accessibility)
Eine grundlegende Barrierefreiheit wird unbedingt berücksichtigt.
- Angemessene Heading-Hierarchie
- Ausreichender Farbkontrast
- Tastaturfokus
- Klare Buttons / Links
- Alt-Text für Bilder
- Empfohlene Touch-Ziele von mindestens 44px
- Keine rein farbliche Unterscheidung von Zuständen
- Sicherstellung der Informationsvermittlung auch ohne Animationen
24. Animationen
Animationen werden nur verwendet, wenn sie die Funktion unterstützen.
Empfohlen:
150ms ~ 300ms
ease-out
Mögliche Bereiche:
- Button Hover
- Link Hover
- Card Hover
- Navigation
- Kurze Section Reveals
Nicht verwendet werden:
- Parallax
- Übermäßige Scroll-Animationen
- Dauerhafte Bewegungen
- Sinnlose Dekorationsanimationen
- Übermäßige Inszenierung beim Seitenaufruf
25. Dark Mode
In der ersten Version wird vorrangig der Light Mode verwendet.
Dark Mode wird nur hinzugefügt, wenn eine separate Anforderung besteht.
Dark Mode sollte nicht dazu führen, dass das aktuelle Designsystem oder die Komponentenstruktur unnötig komplex wird.
26. Technische Designregeln
Tailwind CSS wird als grundlegendes Stylesystem verwendet.
CSS-Variablen werden zur Verwaltung globaler Design-Tokens verwendet.
Empfohlen:
Tailwind
+
CSS Variables
Unnötige Inline-Stile werden nicht verwendet.
27. Komponentenregeln
React Server Component wird als Standard verwendet.
Ein Client Component wird nur in folgenden Fällen verwendet:
- Benutzereingaben
- Zustandsverwaltung
- Browser-APIs
- Ereignisbasierte Interaktionen
- Animationsbibliotheken oder andere Client-seitige Ausführungen
Es werden nicht unnötigerweise ganze Seiten zu Client Components gemacht.
28. Trennung von Inhalt / UI
Inhalte und UI werden getrennt.
Empfohlene Struktur:
content/
├─ profile.ts
├─ projects.ts
├─ skills.ts
└─ types.ts
Projektinformationen werden nicht direkt in UI-Komponenten geschrieben.
Beim Hinzufügen oder Ändern von Projekten sollte nach Möglichkeit nur die Datei:
content/projects.ts
geändert werden müssen, damit die Änderungen im UI erscheinen.
29. Projektdatenprinzip
Projektdaten werden in einer strukturierten Form verwaltet.
Beispiel:
{
slug,
title,
summary,
problem,
solution,
tech,
status,
featured,
period,
image,
links,
highlights
}
Es werden nur die benötigten Werte verwendet.
Nicht existierende Informationen werden nicht willkürlich ausgefüllt.
30. Bildregeln
Wenn keine tatsächlichen Projektbilder existieren, werden keine willkürlichen Bilder erstellt oder importiert.
Wenn ein Platzhalter benötigt wird, wird dieser klar als solcher gekennzeichnet.
Die Struktur wird so gestaltet, dass echte Projektscreenshots später als Projektbilder eingefügt werden können.
31. Datenintegrität
Dies ist eines der wichtigsten Prinzipien des Portfolios.
Folgendes wird niemals willkürlich erstellt:
- Nicht existierende Projekte
- Nicht existierende Technologieerfahrungen
- Nicht existierende Erfolge
- Nicht existierende Zahlen
- Nicht existierende Kunden
- Nicht existierende Berufserfahrungen
- Nicht existierende Links
- Nicht existierende Zertifikate/Qualifikationen
- Nicht existierende Projektergebnisse
Wenn Informationen fehlen, wird priorisiert:
Leer lassen
oder
Beim Benutzer nachfragen
32. Erhaltung bestehender Projekte
Die Bedeutung bestehender Projekte wird nicht willkürlich geändert.
Es wird auf der Grundlage der vom Benutzer bereitgestellten Projektbeschreibungen oder Anforderungen gearbeitet.
Wenn eine Löschung oder Reduzierung bestehender Funktionen erforderlich ist, wird zuerst der Grund erläutert und eine Bestätigung eingeholt.
33. Portfolio-Informationsarchitektur
Die grundlegende Startseitenstruktur priorisiert Folgendes:
Header
↓
Hero
↓
Featured Projects
↓
More Projects
↓
Approach
↓
Skills
↓
Contact
↓
Footer
Diese kann jedoch je nach tatsächlichem Inhalt und Benutzerfreundlichkeit angepasst werden.
34. Priorität von Designentscheidungen
Bei Designkonflikten wird die folgende Prioritätsreihenfolge angewendet:
1. Content readability (Lesbarkeit des Inhalts)
2. Information hierarchy (Informationshierarchie)
3. Accessibility (Barrierefreiheit)
4. Responsive usability (reaktionsfähige Benutzerfreundlichkeit)
5. Consistency (Konsistenz)
6. Visual aesthetics (Visuelle Ästhetik)
7. Decorative effects (Dekorative Effekte)
Ein Design, das leicht zu lesen und zu verstehen ist, wird einem hübschen Design vorgezogen.
35. Implementierungsworkflow
Beim Erstellen einer neuen Seite oder UI wird die folgende Reihenfolge eingehalten:
SCHRITT 1. Analysieren
Zunächst werden die aktuelle Projektstruktur und die vorhandene UI überprüft.
SCHRITT 2. Planen
Die erforderliche Informationsstruktur und Bildschirmkomposition werden vorgeschlagen.
SCHRITT 3. Designen
Basierend auf den Designprinzipien dieser SKILL.md wird eine visuelle Richtung vorgeschlagen.
SCHRITT 4. Komponente
Die erforderliche Komponentenstruktur wird vorgeschlagen.
SCHRITT 5. Bestätigen
Bei größeren Strukturänderungen oder neuen Funktionen wird vor der Implementierung die Bestätigung des Benutzers eingeholt.
SCHRITT 6. Implementieren
Es wird nur der bestätigte Umfang implementiert.
SCHRITT 7. Überprüfen
Folgendes wird überprüft:
TypeScript
Build
Responsive
Accessibility
Visual consistency
Existing functionality
36. Änderungsmanagement
Bei kleinen Änderungen wird die bestehende Struktur so weit wie möglich beibehalten.
Vor einer größeren Änderung:
- Aktuelle Struktur prüfen
- Grund für die Änderung erläutern
- Auswirkungsbereich prüfen
- Alternativen vorschlagen
- Benutzerzustimmung einholen
- Implementieren
Diese Reihenfolge wird eingehalten.
37. Abhängigkeiten
Neue Bibliotheken werden nur hinzugefügt, wenn die Notwendigkeit eindeutig ist.
Wenn das Problem mit vorhandenen Funktionen von Next.js / React / TypeScript / Tailwind gelöst werden kann, wird keine neue Bibliothek hinzugefügt.
Wenn eine Bibliothek hinzugefügt werden muss, wird zuerst geprüft:
Warum wird sie benötigt?
Was löst sie?
Gibt es Alternativen?
38. Supabase / Backend-Prinzip
Die erste Version des Portfolios basiert auf statischen Inhalten.
content/*.ts
wird vorrangig verwendet.
Backend-Lösungen wie Supabase werden nur hinzugefügt, wenn die folgenden Anforderungen tatsächlich bestehen:
- Admin-Panel
- Projekt-CRUD
- Blog
- Entwicklungsnotizen
- Kontaktformular-Speicherung
- Authentifizierung
- Dynamische Datenverwaltung
Eine Datenbank wird nicht in einem Stadium eingeführt, in dem kein Backend benötigt wird.
39. Git-Workflow
Nach Abschluss einer sinnvollen Arbeitseinheit wird ein Commit durchgeführt.
Grundlegender Ablauf:
git add .
git commit -m "Arbeitsinhalt"
git push
Das Format Conventional Commit wird für Commit-Nachrichten empfohlen.
Beispiel:
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
Arbeitseinheiten werden nicht übermäßig groß gebündelt.
40. Abschließender Qualitätsstandard
Der fertige Bildschirm sollte die folgenden Fragen mit „Ja“ beantworten können:
- Ist die Identität des Entwicklers auf dem ersten Bildschirm erkennbar?
- Werden Projekte als Kerninhalte dargestellt?
- Ist verständlich, was jedes Projekt gelöst hat?
- Werden tatsächliche Ergebnisse und Prozesse stärker betont als eine Liste von Technologien?
- Ist das Portfolio auch auf Mobilgeräten gut lesbar?
- Sind Inhalte und UI getrennt?
- Können neue Projekte einfach hinzugefügt werden?
- Sind keine nicht existierenden Informationen enthalten?
- Vermittelt das Portfolio ohne übermäßige Designeffekte einen professionellen Eindruck?
- Wurden keine bestehenden Funktionen unnötig gelöscht?
41. Nicht verhandelbare Regeln
Die folgenden Prinzipien werden stets eingehalten:
- Dekoration geht nicht vor Inhalt.
- Projekte sind der Kern des Portfolios.
- Keine Inhalte erfinden, die nicht auf tatsächlicher Erfahrung basieren.
- Keine Erfolge oder Zahlen hinzufügen, die nicht vom Benutzer bereitgestellt wurden.
- Inhalte und UI trennen.
- Responsive Design als Standard betrachten.
- Barrierefreiheit (Accessibility) berücksichtigen.
- Keine unnötigen Bibliotheken hinzufügen.
- Bestehende Funktionen nicht willkürlich löschen.
- Große strukturelle Änderungen vor der Implementierung mit dem Benutzer abstimmen.
- Das Design bleibt in der Richtung Professional / Modern / Minimal / Technical.
- Light Mode als primären Standard in der ersten Version beibehalten.
- Das System so gestalten, dass beim Hinzufügen von Projekten kein UI-Code geändert werden muss.
- Alle Designentscheidungen priorisieren Lesbarkeit und Informationsvermittlung.