Stratégie de Portfolio
Principe Fondamental
Votre GitHub n'est pas un cimetière de projets à moitié finis. C'est une exposition organisée. Chaque dépôt épinglé doit répondre à une question qu'un responsable de recrutement se pose à votre sujet — et chaque réponse doit leur donner envie de planifier un entretien.
Ce qui Sépare l'Impressionnant du Médiocre
PORTFOLIO MÉDIOCRE PORTFOLIO IMPRESSIONNANT
───────────────── ────────────────────────
30 dépôts, surtout des forks 5 dépôts, tous originaux
Pas de README Chaque README raconte une histoire
Pas de démos en direct Chaque projet est déployé
Tutoriels aléatoires clonés Thème et progression clairs
Dernier commit : il y a 8 mois Activité récente et régulière
Pas de description sur les dépôts Chaque dépôt a une phrase d'accroche
"my-first-react-app" "Outil de revue de code propulsé par l'IA"
La différence n'est pas le talent. C'est l'organisation. Les meilleurs portfolios ressemblent à ceux de quelqu'un qui a un plan, pas de quelqu'un qui commit tout ce qu'il touche.
La Qualité plutôt que la Quantité
Trois à cinq projets soignés battent trente dépôts abandonnés. À tous les coups.
Les Chiffres qui Comptent
| Dépôts | README | Déployés | Le Responsable de Recrutement Pense |
|---|---|---|---|
| 30 | 2 | 0 | "Commence des choses, ne les finit pas" |
| 15 | 5 | 1 | "Touche à tout. On ne sait pas ce dans quoi il est bon" |
| 5 | 5 | 4 | "Concentré. Livre. Connaît son métier" |
| 3 | 3 | 3 | "Tout ce qu'il touche est soigné" |
La Règle du Nettoyage
Avant d'ajouter quoi que ce soit de nouveau, auditez ce qui est déjà là :
1. Archivez ou rendez privé tout ce qui est inachevé et irrécupérable.
2. Supprimez les forks que vous n'avez jamais modifiés.
3. Ajoutez des README à tout ce que vous gardez public.
4. Définissez des descriptions sur chaque dépôt visible.
5. Ce qui reste doit mériter d'être montré.
Si vous ne le mettriez pas sur votre CV, il ne devrait pas être sur votre GitHub public.
Racontez une Histoire à Travers vos Dépôts
Vos dépôts épinglés ne sont pas des échantillons aléatoires. Ce sont des chapitres. Organisez-les pour qu'un visiteur voie un récit.
Structures d'Histoire qui Fonctionnent
L'Arc du Spécialiste :
"Je vais en profondeur dans l'IA/ML et je peux le prouver."
Dépôt 1 : LLM affiné pour une tâche spécifique à un domaine
Dépôt 2 : Pipeline RAG avec framework d'évaluation
Dépôt 3 : Workflow agentique avec utilisation d'outils
Dépôt 4 : Contribution open-source à LangChain/LlamaIndex
L'Arc du Développeur Full-Stack :
"Je construis des produits complets de la base de données au déploiement."
Dépôt 1 : App SaaS full-stack (Next.js + API + DB + Auth)
Dépôt 2 : Outil CLI propulsé par l'IA (montre les compétences backend/systèmes)
Dépôt 3 : Bibliothèque open-source (montre la réflexion sur la conception d'API)
Dépôt 4 : Outil d'automatisation personnel (montre que vous construisez aussi pour vous-même)
L'Arc du Développeur Natif de l'IA :
"Je n'utilise pas seulement l'IA — je construis avec et pour elle."
Dépôt 1 : Workflow agentique / système multi-agents
Dépôt 2 : Intégration LLM dans une application de qualité production
Dépôt 3 : Outil de développement qui exploite l'IA (linter, reviewer, générateur)
Dépôt 4 : Contribution à un framework ou une chaîne d'outils IA
Signaux de Progression
Les responsables de recrutement remarquent quand vos dépôts montrent une croissance :
| Signal | Ce que cela Montre |
|---|---|
| Dépôt ancien : app CRUD simple | Vous avez commencé quelque part |
| Dépôt intermédiaire : API avec tests et CI | Vous avez appris les pratiques d'ingénierie |
| Dépôt récent : agent IA avec évaluations | Vous construisez à la frontière |
| Contribution à un projet OSS majeur | Vous pouvez travailler dans de grandes bases de code |
Que Épingler et Pourquoi
Vous avez droit à six dépôts épinglés. Utilisez-les stratégiquement.
La Disposition Idéale des Épingles
| Emplacement | Quoi Épingler | Pourquoi |
|---|---|---|
| 1 | Projet full-stack | Prouve que vous pouvez construire un produit complet |
| 2 | Projet IA/ML | Montre que vous travaillez à la frontière |
| 3 | Contribution open-source | Prouve que vous collaborez dans de vraies bases de code |
| 4 | Outil de développement ou CLI | Montre que vous résolvez vos propres problèmes |
| 5 | Projet de domaine (votre spécialité) | Signal de profondeur pour votre rôle cible |
| 6 | Joker — projet personnel ou créatif | Montre votre personnalité et votre curiosité authentique |
Règles d'Épinglage
À ÉPINGLER :
- Projets avec démos en direct ou liens de déploiement
- Dépôts avec des README complets et des captures d'écran
- Travail qui correspond aux postes auxquels vous postulez
- Votre travail le plus récent et le plus soigné
À NE PAS ÉPINGLER :
- Fork que vous n'avez pas modifiés de manière significative
- Suivis de tutoriels (même terminés)
- Dépôts sans README
- Tout ce que vous ne pouvez pas expliquer lors d'un entretien
README comme Pitch de votre Portfolio
Chaque dépôt épinglé a besoin d'un README qui vende le projet en 30 secondes. Un responsable de recrutement passera moins de temps que cela avant de décider s'il continue à lire.
Structure du README pour les Dépôts du Portfolio
# Nom du Projet
Description en une phrase de ce qu'il fait et pourquoi c'est important.
## Démo
[Lien vers la démo en direct] | [Lien vers la vidéo de démonstration]
Capture d'écran ou GIF montrant l'application en action.
## Le Problème
Quel problème cela résout-il ? Qui a ce problème ?
## Comment ça Marche
Aperçu de l'architecture. Décisions techniques clés.
Diagramme si le système a plusieurs composants.
## Stack Technique
Liste des technologies — mais seulement les plus significatives.
Ne listez pas HTML/CSS. Listez vos intégrations IA, bases de données, cibles de déploiement.
## Fonctionnalités Clés
- Fonctionnalité 1 — pourquoi elle est intéressante techniquement
- Fonctionnalité 2 — ce qui a été difficile à construire
- Fonctionnalité 3 — ce que vous amélioreriez ensuite
## Pour Commencer
Instructions de configuration claires. Quelqu'un devrait pouvoir l'exécuter en moins de 5 minutes.
## Ce que j'ai Appris
Brève réflexion sur le défi technique le plus difficile et comment vous l'avez résolu.
Anti-Patterns du README
| Mauvais README | Meilleur README |
|---|---|
| "Une app React" | "Résumeur de réunions propulsé par l'IA qui transforme les enregistrements en éléments d'action" |
| Pas de captures d'écran | Capture d'écran ou GIF héroïque au-dessus de la ligne de flottaison |
| Configuration : "clonez et exécutez" | Configuration : étape par étape avec les prérequis listés |
| Pas d'explication de l'architecture | Diagramme système montrant comment les composants se connectent |
| Liste tous les packages npm | Met en évidence les 3-4 technologies qui comptent |
Démos en Direct et Liens de Déploiement
Le code est une hypothèse. Une application déployée est une preuve.
Pourquoi le Déploiement est Important
Le responsable de recrutement voit un dépôt sans démo :
"Code intéressant... est-ce que ça marche vraiment ?"
Le responsable de recrutement voit un dépôt avec un lien en direct :
"Laissez-moi essayer." → 2 minutes plus tard → "Cette personne livre."
Options de Déploiement par Type de Projet
| Type de Projet | Déploiement Gratuit | Bon Pour |
|---|---|---|
| App web full-stack | Vercel, Railway, Fly.io | Applications avec aspect professionnel |
| API / backend | Railway, Render | Montrer les compétences backend |
| Site statique / docs | GitHub Pages, Netlify | Documentation, pages d'atterrissage |
| Démo IA/ML | Hugging Face Spaces, Streamlit Cloud | Démonstrations de modèles, applications de données |
| Outil CLI | npm publish, Homebrew tap | Signal de distribution |
Si Vous ne Pouvez pas Déployer, Enregistrez une Démo
Tout ne peut pas tourner dans le cloud. Pour les outils locaux uniquement, les applications CLI ou les systèmes complexes :
1. Enregistrez une vidéo de démonstration de 60 à 90 secondes.
2. Téléchargez-la sur YouTube (non répertoriée, c'est très bien).
3. Créez un GIF de l'interaction clé.
4. Mettez les deux dans le README.
Une démo vidéo est dix fois mieux que pas de démo du tout.
Graphique de Contribution
Ce que la Régularité Signale
Les responsables de recrutement jettent un œil à votre graphique de contribution. Voici ce qu'ils en lisent réellement :
| Motif | Interprétation |
|---|---|
| Vert régulier, la plupart des jours | "Cette personne code régulièrement. Bonne habitude." |
| Groupes autour des projets | "Travaille par sprints ciblés. Normal." |
| Vert uniquement en semaine | "A un emploi, livre quand même du travail personnel." |
| Mélange de ses propres dépôts et contributions | "Collaboratif. Pas seulement des projets solo." |
À quoi Ressemble la Tricherie
Les réviseurs expérimentés peuvent repérer ces signes instantanément :
DRAPEAUX ROUGES :
- Vert parfaitement uniforme (chaque jour, même intensité)
- Commits qui ne sont que des modifications de README ou des changements d'espaces blancs
- 500 commits en un jour dans des dépôts vides
- Des dizaines de dépôts créés en une semaine, tous avec un seul commit
- Bots de commit automatisés
Tricher sur votre graphique est pire que d'avoir des lacunes. Cela signale le désespoir et un mauvais jugement. La vraie régularité signifie travailler sur des choses qui vous tiennent à cœur à un rythme régulier — lacunes comprises.
Construire un Vrai Graphique
Au lieu de simuler :
1. Choisissez un projet et travaillez dessus 30 minutes par jour.
2. Contribuez à l'open source — même la documentation, les tests ou les rapports de bogues comptent.
3. Gardez un dépôt d'apprentissage où vous commitez des notes et des expériences.
4. Construisez des outils que vous utilisez réellement. Vous les améliorerez naturellement.
Aligner Votre Portfolio sur le Poste que Vous Voulez
Votre portfolio doit ressembler à un aperçu du travail que vous feriez si vous étiez embauché. Adaptez-le à votre cible.
Rôles de Développement Natifs de l'IA
Ces rôles veulent voir que vous pouvez construire avec l'IA et construire pour l'IA :
| Signal | Exemple de Dépôt |
|---|---|
| Utilisation d'outils IA dans votre workflow | Projet avec config .claude/, commits assistés par IA, commandes slash Claude Code |
| Workflows agentiques | Agent multi-étapes qui recherche, planifie et exécute des tâches |
| Intégrations LLM | App avec sortie structurée, ingénierie de prompt, routage de modèles |
| RAG et recherche | Base de connaissances avec recherche par embeddings et métriques d'évaluation |
| Évaluation et test | Framework d'évaluation de sortie LLM, tests de régression de prompt |
| Développement assisté par IA | README du projet documentant comment les outils IA ont accéléré le développement |
Cibles de Portfolio Spécifiques au Rôle
| Rôle Cible | Dépôts Indispensables | Agréables à Avoir |
|---|---|---|
| Ingénieur IA/ML | Modèle affiné, framework d'évaluation, pipeline de données | Implémentation d'article, comparaison de modèles |
| Développeur IA Full-Stack | App intégrant LLM, système RAG, SaaS déployé | Contribution open-source, outil CLI |
| Ingénieur Plateforme / Infra | Pipeline CI/CD, dépôt IaC, configuration de monitoring | Benchmark de performance, contribution OSS |
| Outils de Développement / DX | Outil CLI, SDK/bibliothèque, extension VS Code | Site de documentation, outil de communauté de développeurs |
Checklist de Révision du Portfolio
Effectuez cet audit avant chaque recherche d'emploi. Soyez honnête.
Premières Impressions (30 secondes)
- Photo de profil professionnelle (ou délibérément distinctive)
- La bio indique ce que vous faites et ce que vous cherchez
- Les dépôts épinglés ont des descriptions qui ont du sens pour un étranger
- Au moins 3 dépôts épinglés ont des captures d'écran ou des liens de démo dans le README
- Aucun nom de dépôt embarrassant visible sur la première page
Vérification en Profondeur (2 minutes)
- Chaque dépôt épinglé a un README qui explique le quoi, le pourquoi et le comment
- Au moins un projet a une démo en direct ou un lien de déploiement
- La qualité du code dans les dépôts épinglés reflète votre niveau de compétence actuel
- L'historique des commits montre un vrai développement (pas un seul blob "initial commit")
- Au moins un dépôt démontre des tests ou CI/CD
Vérification de l'Histoire (5 minutes)
- Vos dépôts épinglés racontent une histoire cohérente sur vos compétences
- Il y a une progression visible de l'ancien au plus récent
- Votre portfolio correspond aux postes que vous ciblez
- Vous pouvez expliquer chaque dépôt épinglé en 60 secondes (discours d'ascenseur)
- Vous vous embaucheriez vous-même sur la base de ce GitHub
Le Test Ultime
Ouvrez votre GitHub dans une fenêtre de navigation privée. Imaginez que vous êtes un responsable de recrutement qui ne vous a jamais rencontré. Passez 60 secondes. Est-ce que vous feriez passer ce candidat à l'étape suivante ?
Si la réponse n'est pas un oui immédiat, continuez d'itérer.
Anti-Patterns
| Anti-Pattern | Pourquoi ça Nuit | Correctif |
|---|---|---|
| Forks sans modifications | Donne l'impression de faire du remplissage | Supprimez ou rendez privé |
| Clones de tutoriels ("todo-app", "weather-app") | Signale que vous avez suivi des instructions, pas que vous savez construire | Forkez-le, puis étendez-le bien au-delà du tutoriel |
| Dépôts vides ou avec uniquement un README | Signale des idées abandonnées | Archivez ou supprimez-les |
| Pas de README sur les dépôts publics | "Je ne communique pas sur mon travail" | Ajoutez des README à tout ce que vous gardez public |
| 50+ dépôts visibles sans sélection | Bruit écrasant, aucun signal | Archivez agressivement, épinglez stratégiquement |
| Dépôts épinglés obsolètes (2+ ans) | "Ils n'ont rien construit récemment" | Alternez les épingles pour montrer le travail récent |
| README de profil avec uniquement des statistiques générées automatiquement | Impersonnel, peu d'effort | Écrivez une vraie bio avec votre focus et vos objectifs |
| Dépôts nommés "test", "temp", "asdf" | Négligent | Renommez ou supprimez |
Action Puissante
"Examinez mon portfolio GitHub à [votre URL GitHub]. Évaluez-le comme si vous étiez un responsable de recrutement pour un poste de développement natif de l'IA. Notez chaque dépôt épinglé sur la qualité du README, la profondeur technique, le statut de déploiement et la pertinence pour les rôles IA/ML. Ensuite, donnez-moi un plan d'action priorisé : quoi archiver, quoi améliorer, ce qui manque, et quel nouveau projet ferait la plus grande différence."
L'agent devient votre critique de portfolio — vous donnant le retour honnête et spécifique dont vous avez besoin pour transformer votre GitHub de cimetière de code en atout de carrière.
Compétences Connexes
| Compétence | Quand l'utiliser |
|---|---|
github-profile | Implémenter les mécanismes de la plateforme GitHub — README de profil, épinglage de dépôts, sujets, graphique d'activité |
career-resume | Cycle de vie complet de la carrière — recherche d'emploi, entretiens, intégration, évaluations de performance |