Portfolio-Strategie
Kernprinzip
Dein GitHub ist kein Friedhof halbfertiger Projekte. Es ist eine kuratierte Ausstellung. Jedes gepinnte Repository sollte eine Frage beantworten, die ein Personalverantwortlicher über dich hat – und jede Antwort sollte ihn dazu bringen, ein Vorstellungsgespräch zu vereinbaren.
Was Beeindruckendes von Mittelmäßigem unterscheidet
MITTELMÄSSIGES PORTFOLIO BEEINDRUCKENDES PORTFOLIO
───────────────── ────────────────────
30 Repos, meist Forks 5 Repos, alles Eigenarbeit
Keine READMEs Jedes README erzählt eine Geschichte
Keine Live-Demos Jedes Projekt ist deployed
Zufällig geklonte Tutorials Klares Thema und Fortschritt
Letzter Commit: vor 8 Monaten Konsistente, aktuelle Aktivität
Keine Beschreibungen auf Repos Jedes Repo hat einen Einzeiler
"my-first-react-app" "AI-gestütztes Code-Review-Tool"
Der Unterschied liegt nicht im Talent. Es ist die Kuratierung. Die besten Portfolios sehen aus, als hätte jemand einen Plan, nicht als würde jemand alles committen, was er anfasst.
Qualität vor Quantität
Drei bis fünf polierte Projekte schlagen dreißig verlassene Repos. Jedes Mal.
Die Mathematik, die zählt
| Repos | READMEs | Deployed | Personalverantwortlicher denkt |
|---|---|---|---|
| 30 | 2 | 0 | "Fängt Dinge an, beendet sie nicht" |
| 15 | 5 | 1 | "Bastelt herum. Unklar, was er kann" |
| 5 | 5 | 4 | "Fokussiert. Liefert aus. Kennt sein Handwerk" |
| 3 | 3 | 3 | "Alles, was er anfasst, ist poliert" |
Die Aufräumregel
Bevor du etwas Neues hinzufügst, prüfe, was bereits da ist:
1. Archiviere oder mache privat, was unfertig und nicht zu retten ist.
2. Lösche geforkte Repos, die du nie geändert hast.
3. Füge READMEs zu allem hinzu, was du öffentlich behältst.
4. Setze Beschreibungen auf jedes sichtbare Repo.
5. Was übrig bleibt, sollte zeigenswert sein.
Wenn du es nicht in deinen Lebenslauf aufnehmen würdest, sollte es nicht auf deinem öffentlichen GitHub sein.
Erzähle eine Geschichte über deine Repos hinweg
Deine gepinnten Repos sind keine zufälligen Stichproben. Es sind Kapitel. Ordne sie so an, dass ein Besucher eine Erzählung sieht.
Story-Strukturen, die funktionieren
Der Spezialisten-Bogen:
"Ich gehe tief in KI/ML und kann es beweisen."
Repo 1: Feinabgestimmtes LLM für domänenspezifische Aufgabe
Repo 2: RAG-Pipeline mit Evaluierungsframework
Repo 3: Agentischer Workflow mit Tool-Nutzung
Repo 4: Open-Source-Beitrag zu LangChain/LlamaIndex
Der Full-Stack-Erbauer-Bogen:
"Ich baue vollständige Produkte von der Datenbank bis zum Deployment."
Repo 1: Full-Stack-SaaS-App (Next.js + API + DB + Auth)
Repo 2: KI-gestütztes CLI-Tool (zeigt Backend/System-Kenntnisse)
Repo 3: Open-Source-Bibliothek (zeigt API-Design-Denken)
Repo 4: Persönliches Automatisierungstool (zeigt, dass du auch für dich selbst baust)
Der KI-native Entwickler-Bogen:
"Ich nutze KI nicht nur – ich baue mit ihr und für sie."
Repo 1: Agentischer Workflow / Multi-Agenten-System
Repo 2: LLM-Integration in einer produktionsreifen App
Repo 3: Entwicklertool, das KI nutzt (Linter, Reviewer, Generator)
Repo 4: Beitrag zu einem KI-Framework oder einer Toolchain
Fortschrittssignale
Personalverantwortliche bemerken, wenn deine Repos Wachstum zeigen:
| Signal | Was es zeigt |
|---|---|
| Frühes Repo: einfache CRUD-App | Du hast irgendwo angefangen |
| Mittleres Repo: API mit Tests und CI | Du hast Engineering-Praktiken gelernt |
| Aktuelles Repo: KI-Agent mit Evaluierungen | Du baust an der Grenze des Möglichen |
| Beitrag zu einem großen OSS-Projekt | Du kannst in großen Codebasen arbeiten |
Was pinnen und warum
Du kannst bis zu sechs Repos pinnen. Nutze sie strategisch.
Das ideale Pin-Layout
| Slot | Was pinnen | Warum |
|---|---|---|
| 1 | Full-Stack-Projekt | Beweist, dass du ein komplettes Produkt bauen kannst |
| 2 | KI/ML-Projekt | Zeigt, dass du an der Grenze arbeitest |
| 3 | Open-Source-Beitrag | Beweist, dass du in echten Codebasen zusammenarbeitest |
| 4 | Entwicklertool oder CLI | Zeigt, dass du deine eigenen Probleme löst |
| 5 | Domain-Projekt (deine Spezialität) | Tiefensignal für deine Zielrolle |
| 6 | Joker – persönlich oder kreativ | Zeigt Persönlichkeit und echte Neugier |
Pin-Regeln
PINNEN solltest du:
- Projekte mit Live-Demos oder Deployment-Links
- Repos mit gründlichen READMEs und Screenshots
- Arbeiten, die zu den Rollen passen, auf die du dich bewirbst
- Deine aktuellsten, am meisten polierten Arbeiten
NICHT PINNEN solltest du:
- Geforkte Repos, die du nicht wesentlich geändert hast
- Tutorial-Nachbauten (selbst wenn fertiggestellt)
- Repos ohne README
- Alles, was du in einem Vorstellungsgespräch nicht erklären kannst
README als deine Portfolio-Präsentation
Jedes gepinnte Repo braucht ein README, das das Projekt in 30 Sekunden verkauft. Ein Personalverantwortlicher wird weniger Zeit damit verbringen, zu entscheiden, ob er weiterliest.
README-Struktur für Portfolio-Repos
# Projektname
Ein-Satz-Beschreibung, was es tut und warum es wichtig ist.
## Demo
[Link zur Live-Demo] | [Link zum Video-Walkthrough]
Screenshot oder GIF, das die App in Aktion zeigt.
## Das Problem
Welches Problem löst das? Wer hat dieses Problem?
## Wie es funktioniert
Architekturüberblick. Wichtige technische Entscheidungen.
Diagramm, wenn das System mehrere Komponenten hat.
## Tech-Stack
Liste der Technologien – aber nur die bedeutungsvollen.
Nicht HTML/CSS auflisten. Schon deine KI-Integrationen, Datenbanken, Deployment-Ziele.
## Hauptfunktionen
- Funktion 1 – warum sie technisch interessant ist
- Funktion 2 – was am Bauen schwer war
- Funktion 3 – was du als Nächstes verbessern würdest
## Erste Schritte
Klare Setup-Anleitung. Jemand sollte dies in unter 5 Minuten ausführen können.
## Was ich gelernt habe
Kurze Reflexion über die schwierigste technische Herausforderung und wie du sie gelöst hast.
README-Anti-Patterns
| Schlechtes README | Besseres README |
|---|---|
| "Eine React-App" | "KI-gestützter Meeting-Zusammenfasser, der Aufnahmen in Aktionspunkte verwandelt" |
| Keine Screenshots | Hero-Screenshot oder GIF über dem Falz |
| Setup: "clone und run" | Setup: Schritt für Schritt mit aufgelisteten Voraussetzungen |
| Keine Architekturerklärung | Systemdiagramm, das zeigt, wie Komponenten verbunden sind |
| Listet jedes npm-Paket auf | Hebt die 3-4 Technologien hervor, die zählen |
Live-Demos und Deployment-Links
Code ist eine Hypothese. Eine deployed App ist der Beweis.
Warum Deployment wichtig ist
Personalverantwortlicher sieht Repo ohne Demo:
"Interessanter Code... funktioniert es wirklich?"
Personalverantwortlicher sieht Repo mit Live-Link:
"Lass es mich ausprobieren." → 2 Minuten später → "Diese Person liefert aus."
Deployment-Optionen nach Projekttyp
| Projekttyp | Kostenloses Deployment | Gut für |
|---|---|---|
| Full-Stack-Web-App | Vercel, Railway, Fly.io | Produktionsnahe Apps |
| API / Backend | Railway, Render | Backend-Kenntnisse zeigen |
| Statische Website / Docs | GitHub Pages, Netlify | Dokumentation, Landing Pages |
| KI/ML-Demo | Hugging Face Spaces, Streamlit Cloud | Modelldemos, Daten-Apps |
| CLI-Tool | npm publish, Homebrew tap | Distributionssignal |
Wenn du nicht deployen kannst, nimm eine Demo auf
Nicht alles kann in der Cloud laufen. Für reine Lokaltools, CLI-Apps oder komplexe Systeme:
1. Nimm einen 60-90 Sekunden Video-Walkthrough auf.
2. Lade es auf YouTube hoch (ungelistet ist in Ordnung).
3. Erstelle ein GIF der Schlüsselinteraktion.
4. Füge beides in das README ein.
Eine Video-Demo ist zehnmal besser als keine Demo.
Beitragsgraph
Was Konsistenz signalisiert
Personalverantwortliche werfen einen Blick auf deinen Beitragsgraphen. Hier ist, was sie tatsächlich daraus lesen:
| Muster | Interpretation |
|---|---|
| Gleichmäßiges Grün, die meisten Tage | "Diese Person codiert regelmäßig. Gute Angewohnheit." |
| Cluster um Projekte | "Arbeitet in fokussierten Sprints. Normal." |
| Grün nur an Wochentagen | "Hat einen Job, liefert trotzdem private Arbeit ab." |
| Mischung aus eigenen Repos und Beiträgen | "Kooperativ. Nicht nur Soloprojekte." |
Wie Manipulation aussieht
Erfahrene Prüfer erkennen dies sofort:
ROTE FLAGGEN:
- Perfekt gleichmäßiges Grün (jeden Tag, gleiche Intensität)
- Commits, die nur README-Bearbeitungen oder Leerzeichenänderungen sind
- 500 Commits an einem Tag in leere Repos
- Dutzende Repos, die in einer Woche erstellt wurden, alle mit einzelnen Commits
- Automatisch generierte Commit-Bots
Deinen Graphen zu manipulieren ist schlimmer als Lücken zu haben. Es signalisiert Verzweiflung und schlechtes Urteilsvermögen. Echte Konsistenz bedeutet, regelmäßig an Dingen zu arbeiten, die dir wichtig sind – mit allen Lücken.
Einen echten Graphen aufbauen
Anstatt zu faken:
1. Wähle ein Projekt aus und arbeite 30 Minuten täglich daran.
2. Trage zu Open Source bei – selbst Docs, Tests oder Bug-Reports zählen.
3. Führe ein Lern-Repo, in dem du Notizen und Experimente commitest.
4. Baue Tools, die du tatsächlich nutzt. Du wirst sie natürlich weiter verbessern.
Dein Portfolio auf die gewünschte Rolle ausrichten
Dein Portfolio sollte wie eine Vorschau der Arbeit aussehen, die du tun würdest, wenn du eingestellt wirst. Passe es an dein Ziel an.
KI-native Entwicklerrollen
Diese Rollen wollen sehen, dass du mit KI und für KI bauen kannst:
| Signal | Beispiel-Repo |
|---|---|
| KI-Tool-Nutzung in deinem Workflow | Projekt mit .claude/-Konfiguration, KI-unterstützten Commits, Claude Code Slash-Befehlen |
| Agentische Workflows | Mehrschrittiger Agent, der recherchiert, plant und Aufgaben ausführt |
| LLM-Integrationen | App mit strukturierter Ausgabe, Prompt-Engineering, Modell-Routing |
| RAG und Retrieval | Wissensdatenbank mit Embedding-Suche und Evaluierungsmetriken |
| Evaluierung und Tests | LLM-Ausgabe-Evaluierungsframework, Prompt-Regressionstests |
| KI-unterstützte Entwicklung | Projekt-README, das dokumentiert, wie KI-Tools die Entwicklung beschleunigt haben |
Rollenspezifische Portfolio-Ziele
| Zielrolle | Must-Have-Repos | Nice-to-Have |
|---|---|---|
| KI/ML-Ingenieur | Feinabgestimmtes Modell, Evaluierungsframework, Datenpipeline | Paper-Implementierung, Modellvergleich |
| Full-Stack-KI-Entwickler | LLM-integrierte App, RAG-System, deployed SaaS | Open-Source-Beitrag, CLI-Tool |
| Plattform-/Infra-Ingenieur | CI/CD-Pipeline, IaC-Repo, Monitoring-Setup | Performance-Benchmark, OSS-Beitrag |
| Entwicklertools / DX | CLI-Tool, SDK/Bibliothek, VS-Code-Erweiterung | Docs-Seite, Entwickler-Community-Tool |
Portfolio-Review-Checkliste
Führe diese Prüfung vor jeder Jobsuche durch. Sei ehrlich.
Erster Eindruck (30 Sekunden)
- Profilfoto ist professionell (oder bewusst unverwechselbar)
- Bio gibt an, was du tust und wonach du suchst
- Gepinnte Repos haben Beschreibungen, die für einen Fremden sinnvoll sind
- Mindestens 3 gepinnte Repos haben Screenshots oder Demo-Links im README
- Keine peinlichen Repo-Namen auf der ersten Seite sichtbar
Tiefencheck (2 Minuten)
- Jedes gepinnte Repo hat ein README, das das Was, Warum und Wie erklärt
- Mindestens ein Projekt hat eine Live-Demo oder einen Deployment-Link
- Codequalität in gepinnten Repos spiegelt dein aktuelles Können wider
- Commit-Verlauf zeigt echte Entwicklung (kein einzelner "initial commit"-Klumpen)
- Mindestens ein Repo demonstriert Tests oder CI/CD
Story-Check (5 Minuten)
- Deine gepinnten Repos erzählen eine kohärente Geschichte über deine Fähigkeiten
- Es gibt sichtbare Fortschritte von älteren zu neueren Projekten
- Dein Portfolio passt zu den Rollen, die du anstrebst
- Du kannst jedes gepinnte Repo in einem 60-Sekunden-Elevator-Pitch erklären
- Du würdest dich selbst basierend auf diesem GitHub einstellen
Der ultimative Test
Öffne dein GitHub in einem Inkognito-Fenster. Stell dir vor, du bist ein Personalverantwortlicher, der dich nie getroffen hat. Nimm dir 60 Sekunden. Würdest du diesen Kandidaten in die nächste Runde bringen?
Wenn die Antwort nicht ein sofortiges Ja ist, verbessere weiter.
Anti-Patterns
| Anti-Pattern | Warum es schadet | Behebung |
|---|---|---|
| Geforkte Repos ohne Änderungen | Sieht nach Füllmaterial aus | Löschen oder privat machen |
| Tutorial-Klone ("todo-app", "weather-app") | Signalisiert, dass du Anweisungen gefolgt bist, nicht dass du bauen kannst | Forke es, erweitere es dann weit über das Tutorial hinaus |
| Leere Repos oder Repos nur mit README | Signalisiert aufgegebene Ideen | Archivieren oder löschen |
| Keine READMEs auf öffentlichen Repos | "Ich kommuniziere nicht über meine Arbeit" | Füge READMEs zu allem hinzu, was du öffentlich behältst |
| 50+ sichtbare Repos ohne Kuratierung | Überwältigendes Rauschen, kein Signal | Aggressiv archivieren, strategisch pinnen |
| Veraltete gepinnte Repos (2+ Jahre alt) | "Sie haben seit kurzem nichts mehr gebaut" | Pins rotieren, um aktuelle Arbeit zu zeigen |
| Profil-README nur mit automatisch generierten Statistiken | Unpersönlich, wenig Aufwand | Schreibe eine echte Bio mit deinem Fokus und Zielen |
| Repos mit Namen wie "test", "temp", "asdf" | Sorglos | Umbenennen oder entfernen |
Power-Move
"Überprüfe mein GitHub-Portfolio unter [deine GitHub-URL]. Bewerte es, als wärst du ein Personalverantwortlicher für eine KI-native Entwicklerrolle. Bewerte jedes gepinnte Repo nach README-Qualität, technischer Tiefe, Deployment-Status und Relevanz für KI/ML-Rollen. Gib mir dann einen priorisierten Aktionsplan: was archivieren, was verbessern, was fehlt und welches eine neue Projekt den größten Unterschied machen würde."
Der Agent wird zu deinem Portfolio-Kritiker – er gibt dir das ehrliche, spezifische Feedback, das du brauchst, um dein GitHub von einem Code-Friedhof in eine Karriere-Asset zu verwandeln.
Verwandte Skills
| Skill | Wann verwenden |
|---|---|
github-profile | GitHub-Plattform-Mechaniken implementieren – Profil-README, Repo-Pinning, Themen, Aktivitätsgraph |
career-resume | Vollständiger Karrierezyklus – Jobsuche, Vorstellungsgespräche, Onboarding, Leistungsbeurteilungen |