Portfolio d'une page
Quand cette compétence s'applique
À utiliser quand Kene souhaite une page publique unique représentant son travail — pour un lien dans une candidature, une signature de prospection à froid, un profil social, ou parce qu'un rôle demande explicitement un portfolio. Déclencheurs : « J'ai besoin d'une page portfolio », « que dois-je lier quand on me demande des échantillons de travail », « construis-moi une page d'une page pour la recherche de [rôle] ».
La décision que cette compétence enregistre (A26/A27)
Cette question est restée non résolue à travers plusieurs passages en revue, et c'est la seule ajout à ce package qui produit un nouveau livrable destiné à l'utilisateur plutôt que d'améliorer un existant. C'est exactement pourquoi elle a été constamment reportée, et elle mérite une réponse formulée plutôt qu'un nouveau report.
La réponse est : construis-le, de manière étroite.
L'argument pour : tout ce dont une page d'une page a besoin est déjà dans le package et déjà confirmé sous la Règle 5. La banque STAR contient les histoires, le portail de quantification a les chiffres, 09-risk-tactics-gate a le passage de vérification des affirmations, 21-output-templates a le système de structure, et 17-cold-prospecting veut déjà quelque chose à lier. Ne pas le construire signifie que Kene assemble à la main, à partir d'un corpus que ce pipeline maintient, le seul artefact qui est le plus réutilisable entre les candidatures.
L'argument contre, et pourquoi il façonne la portée : un portfolio est un problème de conception autant qu'un problème de contenu, et ce pipeline n'a pas vocation à être un constructeur de sites. Un « système de portfolio » avec des thèmes, des galeries, des analytics et un CMS serait un deuxième produit vivant à l'intérieur d'un pipeline de recherche d'emploi.
La portée est donc délibérément étroite : une page, générée à partir de mémoire confirmée, publiée en HTML statique, versionnée par rôle cible. Pas de CMS, pas de site multi-pages, pas de système de thème, pas d'analytics des visiteurs. Si Kene veut un vrai site personnel, cela produit un bon fichier de départ et il le prend ailleurs — et cette compétence doit le dire clairement plutôt que de se développer dans cette direction.
Portfolio contre CV personnalisé — à quoi sert chacun
La façon la plus courante de se tromper est de construire un portfolio qui est un CV plus joli. Ils font des tâches différentes, et la différence n'est pas la présentation.
CV personnalisé (05-resume-customizer) | Portfolio d'une page | |
|---|---|---|
| Comment il atteint le lecteur | Poussé. Envoyé à un employeur pour une seule ouverture. | Tiré. Le lecteur clique sur un lien et arrive. |
| Ce que le lecteur sait déjà | Ils ont la fiche de poste devant eux. Ils savent à quoi ils se comparent. | Souvent rien. Cela peut être un recruteur qui navigue, un responsable du recrutement qui a reçu un email à froid, quelqu'un d'une conférence, une personne qui vient de lire une de ses réponses sur X. |
| Si un rôle existe | Toujours. | Fréquemment non — ce qui est la base même de la prospection à froid. |
| Durée de vie | Figé à l'envoi. Un instantané. | En direct. Mutable et en permanence public. |
| Preuves | Affirme. "Temps de déploiement réduit de 40 minutes à 6." | Montre. Voici le repo, le site en cours, le notebook, l'article. |
| Contraintes de format | Analyse ATS, une page, mise en page conventionnelle, pas de formatage astucieux. | Pas d'analyseur. Captures d'écran, diagrammes, récits plus longs, liens. |
| Mode d'échec | Mots-clés manquants ; ne correspond pas à la fiche de poste. | Liens morts, contenu obsolète, ou fuite de quelque chose qui ne devrait pas être public. |
La ligne qui compte, c'est « preuves ». Tout le reste en est une conséquence. Un CV ne peut que faire des affirmations — le format n'a pas de place pour les preuves et le lecteur n'a aucun moyen de vérifier dans les quatre-vingt-dix secondes qu'il y consacre. Un portfolio est la couche des artefacts : l'endroit où « temps de déploiement réduit de 40 minutes à 6 » devient un repo avec la configuration CI avant-après dans l'historique.
C'est la raison de le construire. Si une page de portfolio ne contient aucun lien vers des artefacts réels, c'est un CV avec une moins bonne compatibilité ATS et elle ne doit pas être publiée — le passage de pré-publication de 09-risk-tactics-gate applique cela (voir « Liens vers des artefacts » ci-dessous).
Quand chacun est nécessaire :
- CV, toujours. Chaque candidature. Non optionnel, et cette compétence ne réduit pas cela.
- Portfolio, quand le lecteur arrive sans contexte. Prospection à froid (
17-cold-prospecting), un lien dans une bio sociale, un rôle qui demande explicitement des échantillons de travail, une recommandation où quelqu'un transmet son nom, ou toute conversation où « qu'as-tu construit » vient avant « voici la fiche de poste ». - Les deux, liés. Le CV porte l'URL du portfolio ; le portfolio ne reproduit pas le CV. La redondance entre eux est un espace perdu sur la page et une deuxième chose à maintenir synchronisée.
La considération de l'employeur actuel. Un CV va à un seul destinataire. Un portfolio est trouvable par tout le monde, y compris un employeur actuel, et publier un portfolio est un acte modérément visible. Le traitement du mode de discrétion de 16-career-pulse s'applique : si Kene cherche discrètement, c'est une entrée réelle quant à la question de le publier, et la compétence le soulève une fois lors de la première publication plutôt que de présumer quoi que ce soit.
Liens vers des artefacts — le contenu principal, pas un pied de page
Un portfolio sans liens est un CV. Les liens sont ce pour quoi il existe, ils reçoivent donc un traitement de première classe plutôt qu'une liste « travaux sélectionnés » en bas.
Chaque élément de travail peut porter un ou plusieurs artefacts :
| Type | Notes |
|---|---|
deployed | Le site en cours. Le lien de la plus haute valeur qui soit — un lecteur peut l'utiliser en dix secondes. |
repo | GitHub/GitLab. Lien vers la racine du repo sauf si un fichier spécifique est le sujet ; un lien profond vers un seul fichier ressemble à une sélection arbitraire. |
notebook | Colab, Jupyter, Kaggle. Voir la note de lisibilité ci-dessous. |
writeup | Un article de blog, un document de conception, un post-mortem. Souvent l'artefact le plus fort pour un travail dont le code n'est pas partageable. |
demo | Un enregistrement d'écran lorsque la chose ne peut pas être déployée publiquement. Deux minutes, pas de narration requise. |
package | npm, PyPI, crates.io — une chose publiée et installable. |
paper | arXiv ou un lieu de publication. |
Les notebooks ont besoin d'une vérification de lisibilité que les repos n'ont pas. Un .ipynb avec des sorties effacées est un mur de code qui ne prouve rien à quelqu'un qui survole. Liez la forme rendue — un lien Colab qui s'exécute, ou nbviewer / le rendu GitHub avec les sorties commitées — et assurez-vous que la cellule du haut indique à quoi sert le notebook. Un notebook dont la première chose visible est import pandas as pd est un lien que le lecteur ferme.
Un repo a besoin d'un README qui survit trente secondes. Si le README du repo ne dit pas ce qu'est la chose et pourquoi elle existe, la lier est pire que de ne pas le faire. Cette compétence le signale ; elle ne le corrige pas, car le corriger est un vrai travail que Kene doit faire.
La pourriture des liens est vérifiée, car l'échec est silencieux et total. Un portfolio avec des liens morts est pire qu'un portfolio sans liens : il semble négligent exactement dans la dimension que la page existe pour démontrer. Chaque URL d'artefact est vérifiée lors de la publication et revérifiée lors de l'actualisation trimestrielle (shared/applications_db_schema_addendum_18.sql, portfolio_artifacts). Une 404, un repo passé en privé, ou un Colab qui nécessite désormais une autorisation sont tous signalés par URL — jamais supprimés silencieusement de la page, car un artefact supprimé silencieusement signifie que la page s'affaiblit subtilement et personne ne le remarque.
Ce qui peut être lié en toute sécurité — la limite stricte. Seuls les artefacts que Kene possède ou qui sont déjà publics avec permission. Le code appartenant à l'employeur, les documents internes, tout ce qui est sous NDA, et tout ce qui contient des données d'un tiers ne vont pas sur une page publique. Cela est vérifié au moment de l'ajout et à nouveau lors de la publication, et c'est la seule vérification de cette compétence qui ne comporte pas de chemin de « Kene peut passer outre » — le mode d'échec est de publier quelque chose qu'il ne possédait pas, et cela met fin à des carrières plutôt qu'à des emplois.
Lorsque le travail sous-jacent ne peut pas être montré, les types writeup et demo existent précisément pour cela : décrire un système qu'il a construit, à un niveau d'abstraction qui ne révèle rien, est légitime et souvent plus lisible que le code ne l'aurait été.
Six blocs, dans l'ordre. Chacun est tiré de la mémoire confirmée existante ; cette compétence n'innocente aucun fait (Règle 5).
- Ligne de positionnement — une phrase, ce qu'il fait et pour qui. Dérivée du
target-profile.yaml's titre cible actuel et du cadragecontent-model-overlap.md, confirmée par Kene avant expédition. C'est la ligne la plus difficile de la page et celle qui mérite le plus d'itérations. - Trois à cinq éléments de travail — de la banque STAR, sélectionnés pour le rôle cible de la même manière que
05-resume-customizersélectionne. Chacun est situation → ce qu'il a fait → le chiffre. Chaque chiffre porte la même barre de quantification qu'une puce de CV. Un portfolio n'est pas une surface de preuve inférieure parce qu'il est auto-publié ; si quoi que ce soit, une affirmation résidant en permanence sur une page publique mérite plus de soin qu'une affirmation dans un document envoyé une fois. - Résumé des compétences — compétences regroupées avec les preuves attachées, de
domain-knowledge.md. Regroupées, pas un mur d'étiquettes. - Liens vers des artefacts par élément de travail — attachés à l'élément 2, non listés séparément en bas. Un lien situé à côté de l'affirmation qu'il prouve fait du travail ; le même lien dans une annexe « travaux sélectionnés » est une liste que le lecteur ignore. Voir « Liens vers des artefacts » ci-dessus.
- Contact — tout ce que Kene a déjà choisi de rendre public. Par défaut rien jusqu'à ce qu'il dise le contraire.
- Dernière mise à jour — une date réelle. Un portfolio avec une date obsolète lit moins bien qu'un portfolio sans date, ce qui est un argument pour l'invite d'actualisation ci-dessous plutôt que contre son affichage.
Variantes — deux axes, pas un
La première version de cette compétence disait « une variante par groupe de titres cibles ». Cela est correct pour les candidatures mais faux pour la prospection à froid, qui est une situation différente avec un lecteur différent.
Axe 1 — groupe de titres cibles (face aux candidatures). Même matériel sous-jacent, sélection et ordre différents par famille de rôles. Le même principe qu'un CV adapté. 19-career-path-planner's saut actuel est la valeur par défaut sur un plan multi-sauts : la page doit le présenter pour le rôle auquel il postule maintenant, pas celui à deux pas de là.
Axe 2 — mode de pitch (face à la prospection). 17-cold-prospecting a trois modes et ils ont besoin de pages vraiment différentes, car la question du lecteur diffère :
| Mode de pitch | Question du lecteur | Par quoi la page commence |
|---|---|---|
| Adéquation-rôle | "Pourrait-il faire le travail que nous avons déjà ?" | Même forme que la variante candidature. Souvent la même variante. |
| Création-rôle | "Cette fonction mérite-t-elle d'être créée ici ?" | Le problème que la fonction résout, prouvé par un travail où il l'a résolu. Le rôle est l'argument, pas le CV. |
| Service | "Engagerais-je cette personne pour un travail défini ?" | Périmètre, livrable et travail passé comparable. Le plus proche d'une page de conseil — et celle qu'un portfolio en forme de rôle interprète mal. |
La prospection par adéquation-rôle n'a généralement pas besoin de variante séparée — elle réutilise celle du titre cible correspondant. Seuls les pitchs de création-rôle et de service justifient généralement leur propre page, et seulement si Kene pitch ainsi assez souvent pour valoir la peine d'être maintenue.
Pertinence par prospection sans variantes par prospection. Plutôt qu'une page par prospect, la page publiée porte une ancre stable par élément de travail (#pipeline-de-scoring-credit), et 17-cold-prospecting crée un lien profond vers la pertinente. Une variante sert plusieurs prospections, chacune faisant atterrir le lecteur sur l'élément qui a motivé l'email. C'est la vraie raison de ne pas multiplier les variantes : l'ajustement qui compte est quel élément ils voient en premier, et une ancre le fait gratuitement.
Plafonnez-la. Quatre ou cinq variantes sur les deux axes, c'est beaucoup. Chacune est une page qui peut devenir obsolète indépendamment, et le pire échec d'un portfolio est d'être obsolète. Si une sixième est demandée, la meilleure question est généralement de savoir si deux existantes ont convergé.
Les variantes résident dans shared/portfolio/{slug_de_la_variante}/, chacune enregistrant pour quoi elle a été construite, ce qu'elle a sélectionné et quand.
Choisir ce qui va sur la page — Kene choisit
Cette compétence propose et il ajuste. Même forme proposer-confirmer-sauvegarder que tout le reste ici, pas une page qu'il découvre après coup.
shared/portfolio-manifest.yaml contient trois choses :
- Le pool éligible — chaque entrée STAR, compétence et artefact déjà confirmés en mémoire, chacun avec un résumé d'une ligne et un identifiant. Construit par analyse ; Kene ne le tape jamais. C'est le menu, et c'est la réponse à « qu'est-ce qui pourrait aller sur une page ».
- Règles globales —
always_includepour les un ou deux éléments phare qui appartiennent à chaque variante quel que soit le rôle cible, etnever_includepour tout ce qu'il ne veut pas du tout rendre public.neverl'emporte sur tout, y compris une sélection par variante, et c'est le bon endroit pour un travail qui est techniquement partageable mais qu'il préfère ne pas mettre en avant. - Sélection par variante — une liste ordonnée d'identifiants. L'ordre est significatif et la page le rend tel quel, car sur une page d'une page, le premier élément est la majeure partie de l'impression.
Comment se déroule la conversation. Sur une nouvelle variante, cette compétence propose une sélection du pool avec une raison par élément, classée pour cette cible. Kene ajoute, supprime et réorganise en langage simple — « supprime le deuxième, mets le travail sur les paiements en haut, ajoute ce que j'ai fait pour la coopérative ». Confirmé une fois, écrit dans le manifeste.
Une reconstruction ne sélectionne jamais silencieusement à nouveau. La sélection existante est le point de départ à chaque fois. Une page que Kene a organisée ne doit pas se réarranger silencieusement parce qu'une nouvelle entrée STAR est arrivée.
Le nouveau matériel est proposé, jamais inséré. Quand quelque chose entre dans la banque qui serait bien classé pour une variante existante, l'actualisation trimestrielle le soulève une fois — « cela serait un excellent ajout pour la variante fintech, l'ajouter ? » Une question, pas un diff appliqué en son nom.
Publication
HTML statique, un fichier plus les ressources, sans étape de build et aucun framework. La sortie est lisible et éditable à la main, car Kene voudra l'éditer à la main et un fichier généré qu'il ne peut pas toucher est pire qu'aucun fichier.
Où l'hébergement est demandé, et ce qui se passe s'il s'en fiche
Lors de la première publication, une fois. Pas lors de la génération...
[très long — contenu tronqué pour la traduction]