Portfoliostrategie
Kernprinzip
Dein GitHub ist kein Friedhof halbfertiger Projekte. Es ist eine kuratierte Ausstellung. Jedes angeheftete Repo 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 Mittelmaß unterscheidet
MITTELMÄSSIGES PORTFOLIO BEEINDRUCKENDES PORTFOLIO
───────────────── ────────────────────
30 Repos, meist Forks 5 Repos, alle Eigenarbeiten
Keine READMEs Jede README erzählt eine Geschichte
Keine Live-Demos Jedes Projekt ist deployed
Zufällige Tutorials geklont Klares Thema und Fortschritt
Letzter Commit: vor 8 Monaten Durchgängige, aktuelle Aktivität
Keine Beschreibungen auf Repos Jedes Repo hat einen Einzeiler
"my-first-react-app" "KI-gestütztes Code-Review-Tool"
Der Unterschied liegt nicht im Talent. Es liegt in der Kuratierung. Die besten Portfolios sehen aus, als hätte jemand einen Plan – nicht als hätte jemand alles committet, was er anfasst.
Qualität vor Quantität
Drei bis fünf ausgefeilte Projekte schlagen dreißig aufgegebene Repos. Jedes Mal.
Die Fakten, die zählen
| Repos | READMEs | Deployed | Personalverantwortlicher denkt |
|---|---|---|---|
| 30 | 2 | 0 | "Fängt Dinge an, beendet sie nicht" |
| 15 | 5 | 1 | "Oberflächlich. Unklar, worin sie gut sind" |
| 5 | 5 | 4 | "Fokussiert. Liefert aus. Beherrscht ihr Handwerk" |
| 3 | 3 | 3 | "Alles, was sie anfassen, ist ausgefeilt" |
Die Aufräumregel
Bevor du etwas Neues hinzufügst, prüfe, was bereits da ist:
1. Archiviere oder mache alles Unfertige und nicht mehr Rettbare privat.
2. Lösche geforkte Repos, die du nie verä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
Deine angehefteten Repos sind keine willkürlichen Stichproben. Sie 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 Bewertungsframework
Repo 3: Agentischer Workflow mit Tool-Nutzung
Repo 4: Open-Source-Beitrag zu LangChain/LlamaIndex
Der Full-Stack-Entwickler-Bogen:
„Ich baue komplette 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-/Systemkenntnisse)
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 verwende KI nicht nur – ich baue mit ihr und für sie.“
Repo 1: Agentischer Workflow / Multi-Agenten-System
Repo 2: LLM-Integration in einer produktionstauglichen App
Repo 3: Entwickler-Tool, 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 anheften und warum
Du hast sechs angeheftete Repos. Nutze sie strategisch.
Das ideale Anheft-Layout
| Slot | Was anheften | 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 | Entwickler-Tool 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 |
Anheft-Regeln
TU anheften:
- Projekte mit Live-Demos oder Deployment-Links
- Repos mit gründlichen READMEs und Screenshots
- Arbeit, die zu den Rollen passt, auf die du dich bewirbst
- Deine aktuellste, ausgefeilteste Arbeit
TU NICHT anheften:
- Geforkte Repos, die du nicht sinnvoll verändert hast
- Tutorial-Nachbauten (auch wenn abgeschlossen)
- Repos ohne README
- Alles, was du in einem Vorstellungsgespräch nicht erklären kannst
README als dein Portfolio-Pitch
Jedes angeheftete Repo braucht eine README, die das Projekt in 30 Sekunden verkauft. Ein Personalverantwortlicher wird weniger Zeit damit verbringen, bevor er entscheidet, 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 zur 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.
Führe nicht HTML/CSS auf. Führe deine KI-Integrationen, Datenbanken, Deployment-Ziele auf.
## Hauptfunktionen
- Funktion 1 – warum sie technisch interessant ist
- Funktion 2 – was am Bauen schwierig war
- Funktion 3 – was du als nächstes verbessern würdest
## Erste Schritte
Klare Setup-Anleitung. Jemand sollte dies in unter 5 Minuten zum Laufen bringen können.
## Was ich gelernt habe
Kurze Reflexion über die schwierigste technische Herausforderung und wie du sie gelöst hast.
README-Anti-Patterns
| Schlechte README | Bessere README |
|---|---|
| „Eine React-App“ | „KI-gestützter Meeting-Zusammenfasser, der Aufnahmen in Aktionspunkte verwandelt“ |
| Keine Screenshots | Hero-Screenshot oder GIF above the fold |
| Setup: „klonen und ausführen“ | Setup: Schritt für Schritt mit Voraussetzungen |
| Keine Architektur-Erklärung | Systemdiagramm, das zeigt, wie Komponenten verbunden sind |
| Listet jedes npm-Paket auf | Hebt die 3-4 Technologien hervor, die wichtig sind |
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 er auch?“
Personalverantwortlicher sieht Repo mit Live-Link:
„Lass mich es ausprobieren.“ → 2 Minuten später → „Diese Person liefert aus.“
Deployments-Optionen nach Projekttyp
| Projekttyp | Kostenloses Deployment | Gut geeignet für |
|---|---|---|
| Full-Stack-Web-App | Vercel, Railway, Fly.io | Produktionsnahe Apps |
| API / Backend | Railway, Render | Zeigen von Backend-Fähigkeiten |
| Statische Seite / Docs | GitHub Pages, Netlify | Dokumentation, Landing Pages |
| KI/ML-Demo | Hugging Face Spaces, Streamlit Cloud | Modell-Demos, Daten-Apps |
| CLI-Tool | npm publish, Homebrew tap | Vertriebssignal |
Wenn du nicht deployen kannst, nimm eine Demo auf
Nicht alles kann in der Cloud laufen. Für reine Lokal-Tools, CLI-Apps oder komplexe Systeme:
1. Nimm eine 60-90 sekündige Video-Walkthrough auf.
2. Lade sie auf YouTube hoch (ungelistet ist in Ordnung).
3. Erstelle ein GIF der Schlüsselinteraktion.
4. Füge beides in die README ein.
Eine Video-Demo ist zehnmal besser als keine Demo.
Beitragsdiagramm
Was Konsistenz signalisiert
Personalverantwortliche werfen einen Blick auf dein Beitragsdiagramm. Hier ist, was sie tatsächlich daraus lesen:
| Muster | Interpretation |
|---|---|
| Stetig grün, an den meisten Tagen | „Diese Person codiert regelmäßig. Gute Angewohnheit.“ |
| Cluster um Projekte | „Arbeitet in fokussierten Sprints. Normal.“ |
| Grün nur an Werktagen | „Hat einen Job, liefert trotzdem persönliche Arbeit ab.“ |
| Mischung aus eigenen Repos und Beiträgen | „Kollaborativ. Nicht nur Soloprojekte.“ |
Wie Manipulation aussieht
Erfahrene Prüfer erkennen diese sofort:
ROTE FLAGGEN:
- Perfekt gleichmäßiges Grün (jeden Tag, gleiche Intensität)
- Commits, die nur README-Änderungen oder Leerzeichenänderungen sind
- 500 Commits an einem Tag in leeren Repos
- Dutzende Repos, die in einer Woche erstellt wurden, alle mit einzelnen Commits
- Automatisch generierte Commit-Bots
Das Manipulieren deines Diagramms 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.
Ein echtes Diagramm aufbauen
Anstatt zu faken:
1. Wähle ein Projekt aus und arbeite 30 Minuten am Tag 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 immer 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 Entwicklungsrollen
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-gestützten Commits, Claude-Code-Slash-Befehlen |
| Agentische Workflows | Mehrstufiger Agent, der Aufgaben recherchiert, plant und ausführt |
| LLM-Integrationen | App mit strukturierter Ausgabe, Prompt-Engineering, Modell-Routing |
| RAG und Abruf | Wissensdatenbank mit Embedding-Suche und Bewertungsmetriken |
| Evaluierung und Tests | LLM-Output-Evaluierungsframework, Prompt-Regressionstests |
| KI-gestützte Entwicklung | Projekt-README, das dokumentiert, wie KI-Tools die Entwicklung beschleunigt haben |
Rollenspezifische Portfolio-Ziele
| Zielrolle | Unverzichtbare Repos | Schön-zu-haben |
|---|---|---|
| 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-/Infrastruktur-Ingenieur | CI/CD-Pipeline, IaC-Repo, Monitoring-Setup | Leistungsbenchmark, OSS-Beitrag |
| Entwickler-Tools / 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.
Erste Eindrücke (30 Sekunden)
- Profilfoto ist professionell (oder bewusst unverwechselbar)
- Bio sagt, was du tust und wonach du suchst
- Angeheftete Repos haben Beschreibungen, die für einen Fremden Sinn ergeben
- Mindestens 3 angeheftete Repos haben Screenshots oder Demo-Links in der README
- Keine peinlichen Repo-Namen auf der ersten Seite sichtbar
Tiefenprüfung (2 Minuten)
- Jedes angeheftete Repo hat eine README, die das Was, Warum und Wie erklärt
- Mindestens ein Projekt hat einen Live-Demo- oder Deployment-Link
- Codequalität in angehefteten Repos entspricht deinem aktuellen Fähigkeitsniveau
- Commit-Verlauf zeigt echte Entwicklung (kein einzelner „Initial Commit“-Klumpen)
- Mindestens ein Repo zeigt Tests oder CI/CD
Story-Prüfung (5 Minuten)
- Deine angehefteten Repos erzählen eine kohärente Geschichte über deine Fähigkeiten
- Es gibt einen sichtbaren Fortschritt von älteren zu neueren Projekten
- Dein Portfolio ist auf die Rollen ausgerichtet, die du anstrebst
- Du kannst jedes angeheftete Repo in einem 60-Sekunden-Elevator-Pitch erklären
- Du würdest dich selbst auf der Grundlage dieses GitHub einstellen
Der ultimative Test
Öffne dein GitHub in einem Inkognito-Fenster. Tu so, als wärst du ein Personalverantwortlicher, der dich noch nie getroffen hat. Verbringe 60 Sekunden. Würdest du diesen Kandidaten in die nächste Runde schicken?
Wenn die Antwort nicht sofort Ja ist, iteriere weiter.
Anti-Patterns
| Anti-Pattern | Warum es schadet | Behebung |
|---|---|---|
| Geforkte Repos ohne Änderungen | Sieht nach Aufblähung 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 und erweitere es weit über das Tutorial hinaus |
| Leere Repos oder Repos mit nur einer README | Signalisiert aufgegebene Ideen | Archiviere oder lösche sie |
| 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 | Archiviere aggressiv, hefte strategisch an |
| Veraltete angeheftete Repos (2+ Jahre alt) | „Sie haben seit kurzem nichts mehr gebaut“ | Rotiere Anheftungen, um aktuelle Arbeit zu zeigen |
| Profil-README nur mit automatisch generierten Statistiken | Unpersönlich, geringer Aufwand | Schreibe eine echte Bio mit deinem Fokus und deinen Zielen |
| Repos namens „test“, „temp“, „asdf“ | Nachlässig | 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 Entwicklungsrolle. Bewerte jedes angeheftete Repo nach README-Qualität, technischer Tiefe, Deployment-Status und Relevanz für KI/ML-Rollen. Gib mir dann einen priorisierten Aktionsplan: was archiviert, was verbessert werden sollte, was fehlt und welches eine neue Projekt den größten Unterschied machen würde.“
Der Agent wird dein Portfoliokritiker – und gibt dir das ehrliche, spezifische Feedback, das du brauchst, um dein GitHub von einem Code-Friedhof in einen Karriere-Asset zu verwandeln.
Verwandte Skills
| Skill | Wann verwenden |
|---|---|
github-profile | Implementiere GitHub-Plattformmechaniken – Profil-README, Repo-Anheftung, Themen, Aktivitätsdiagramm |
career-resume | Vollständiger Karrierelebenszyklus – Jobsuche, Vorstellungsgespräche, Onboarding, Leistungsbeurteilungen |