Portfolio One-Pager
Quand ce skill s'applique
Utilisez-le lorsque Kenechukwu 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 de portfolio", "quoi mettre en lien quand ils demandent des échantillons de travail", "construis-moi une page d'accueil pour la recherche de [rôle]".
La décision que ce skill enregistre (A26/A27)
Cette décision est restée non résolue à travers plusieurs passes de revue, et c'est le seul ajout à ce package qui produit un nouveau livrable visible par l'utilisateur plutôt que d'améliorer un existant. C'est exactement pourquoi il a été constamment reporté, et il mérite une réponse énoncée plutôt qu'un nouveau report.
La réponse est : construis-le, de manière ciblée.
Les arguments en faveur : tout ce dont une page d'accueil a besoin est déjà dans le package et déjà confirmé selon la Règle 5. La banque STAR contient les histoires, la porte 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 Kenechukwu assemble à la main, à partir d'un corpus que ce pipeline maintient, le seul artefact qui est le plus réutilisable entre les candidatures.
Les arguments contre, et pourquoi ils façonnent la portée : un portfolio est autant un problème de design qu'un problème de contenu, et ce pipeline n'a pas vocation à être un constructeur de site. Un "système de portfolio" avec thèmes, galeries, analyses et 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 la mémoire confirmée, publiée en HTML statique, versionnée par rôle cible. Pas de CMS, pas de site multi-page, pas de système de thèmes, pas d'analytique des visiteurs. Si Kenechukwu veut un véritable site personnel, cela produit un bon fichier de départ et il l'emmène ailleurs — et ce skill devrait le dire clairement plutôt que de grandir vers cela.
Portfolio vs 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 travaux différents, et la différence n'est pas de présentation.
CV personnalisé (05-resume-customizer) | Page d'accueil de portfolio | |
|---|---|---|
| Comment il arrive au lecteur | Poussé. Envoyé à un employeur pour une 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 pourrait être un recruteur qui navigue, un responsable de recrutement qui a reçu un email froid, quelqu'un d'une conférence, une personne qui vient de lire une réponse de lui sur X. |
| Si un rôle existe | Toujours. | Souvent non — ce qui est la base entière de la prospection à froid. |
| Durée de vie | Figé à l'envoi. Un instantané. | Vivant. Modifiable et permanent public. |
| Preuve | Affirme. "Réduction du temps de déploiement de 40 à 6 minutes." | Montre. Voici le dépôt, la chose en fonctionnement, le notebook, l'analyse. |
| Contraintes de format | Analyse ATS, une page, mise en page conventionnelle, pas de formatage astucieux. | Pas d'analyseur. Captures d'écran, diagrammes, récit plus long, liens. |
| Mode d'échec | Mots-clés manqués ; non correspondance avec la fiche de poste. | Liens morts, contenu obsolète, ou fuite de quelque chose qui ne devrait pas être public. |
La ligne qui compte est "preuve". Tout le reste en est une conséquence. Un CV ne peut faire que des affirmations — le format n'a pas de place pour la preuve 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ù "réduction du temps de déploiement de 40 à 6 minutes" devient un dépôt avec la configuration CI avant-après dans l'historique.
C'est la raison de le construire du tout. Si une page de portfolio ne porte aucun lien vers de véritables artefacts, c'est un CV avec une moins bonne compatibilité ATS et ne devrait pas être publié — 09-risk-tactics-gate's passage de pré-publication l'impose (voir "Liens vers des artefacts" ci-dessous).
Quand chacun est nécessaire :
- CV, toujours. Chaque candidature. Non optionnel, et ce skill 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 spécification du poste". - Les deux, liés. Le CV porte l'URL du portfolio ; le portfolio ne reproduit pas le CV. La redondance entre eux est de l'espace gaspillé sur la page et une deuxième chose à maintenir synchronisée.
La considération de l'employeur actuel. Un CV va à un destinataire. Un portfolio est trouvable par n'importe qui, y compris un employeur actuel, et le publier est un acte modérément visible. Le traitement du mode de discrétion de 16-career-pulse s'applique : si Kenechukwu cherche en silence, c'est une véritable entrée pour déterminer si cela est publié du tout, et le skill le soulève une fois lors de la première publication plutôt que de supposer d'un côté ou de l'autre.
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 sert, donc ils bénéficient d'un traitement de première classe plutôt qu'une liste "travail sélectionné" en bas.
Chaque élément de travail peut porter un ou plusieurs artefacts :
| Type | Notes |
|---|---|
deployed | La chose en fonctionnement. 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 dépôt sauf si un fichier spécifique est le point ; un lien profond vers un fichier est perçu comme du cherry-picking. |
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 où la chose ne peut pas être déployée publiquement. Deux minutes, aucune 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'un contrôle de lisibilité que les dépôts n'ont pas. Un .ipynb avec les sorties effacées est un mur de code qui ne prouve rien à quelqu'un qui parcourt. Liez la forme rendue — un lien Colab qui s'exécute, ou le rendu de nbviewer / GitHub avec les sorties engagées — et assurez-vous que la cellule du haut dit à 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 dépôt a besoin d'un README qui survit trente secondes. Si le README du dépôt ne dit pas ce qu'est la chose et pourquoi elle existe, la lier est pire que de ne pas la lier. Ce skill le signale ; il ne le corrige pas, car le corriger est un vrai travail que Kenechukwu 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 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 du rafraîchissement trimestriel (shared/applications_db_schema_addendum_18.sql, portfolio_artifacts). Une 404, un dépôt passé en privé, ou un Colab qui nécessite maintenant une permission sont tous signalés par URL — jamais silencieusement retirés de la page, car un artefact retiré silencieusement signifie que la page devient discrètement plus faible et personne ne le remarque.
Ce qui est sûr à lier — la limite dure. Seuls les artefacts que Kenechukwu 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 le seul contrôle dans ce skill qui n'a pas de chemin "Kenechukwu peut annuler" — 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.
Là où 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 divulgue rien, est légitime et souvent plus lisible que le code l'aurait été.
Six blocs, dans l'ordre. Chacun est tiré de la mémoire confirmée existante ; ce skill n'établit aucun fait (Règle 5).
- Ligne de positionnement — une phrase, ce qu'il fait et pour qui. Dérivée du titre cible actuel de
target-profile.yamlet du cadrage decontent-model-overlap.md, confirmé par Kenechukwu avant sa mise en ligne. 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 quelque chose, une affirmation résidant en permanence sur une page publique mérite plus de soin qu'une dans un document envoyé une fois. - Résumé des capacités — compétences regroupées avec la preuve attachée, de
domain-knowledge.md. Regroupé, pas un mur de tags. - Liens d'artefacts par élément de travail — attachés à l'élément 2, pas listés séparément en bas. Un lien placé à côté de l'affirmation qu'il prouve fait du travail ; le même lien dans une annexe "travail sélectionné" est une liste que le lecteur ignore. Voir "Liens vers des artefacts" ci-dessus.
- Contact — tout ce que Kenechukwu a déjà choisi de rendre public. Par défaut rien jusqu'à ce qu'il dise autrement.
- Dernière mise à jour — une date réelle. Un portfolio avec une date obsolète se lit moins bien qu'un sans date, ce qui est un argument pour l'invite de rafraîchissement ci-dessous plutôt que contre l'affichage de la date.
Variantes — deux axes, pas un
La première version de ce skill disait "une variante par grappe de titre cible." C'est correct pour les candidatures et faux pour la prospection à froid, qui est une situation différente avec un lecteur différent.
Axe 1 — grappe de titre cible (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é. Le saut actuel de 19-career-path-planner 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 étapes de là.
Axe 2 — mode de pitch (face à la prospection). 17-cold-prospecting a trois modes et ils nécessitent des pages vraiment différentes, car la question du lecteur diffère :
| Mode de pitch | Question du lecteur | Par quoi la page démarre |
|---|---|---|
| Adéquation au rôle | "Pourrait-il faire le travail que nous avons déjà ?" | Même forme que la variante de candidature. Souvent la même variante. |
| Création de rôle | "Cette fonction vaut-elle la peine 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 consultant — et celle qu'un portfolio en forme de rôle interprète mal activement. |
La prospection adéquation au rôle n'a généralement pas besoin de variante séparée — elle réutilise celle correspondant au titre cible. Seuls les pitches de création de rôle et de service justifient généralement leur propre variante, et seulement si Kenechukwu pitch de cette façon assez souvent pour que cela vaille la peine d'être maintenu.
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 (#credit-scoring-pipeline), et 17-cold-prospecting crée un lien profond vers celui pertinent. Une variante sert plusieurs prospections, chacune atterrissant le lecteur sur l'élément qui a motivé l'email. C'est la véritable raison de ne pas multiplier les variantes : l'adaptation qui compte est quel élément ils voient en premier, et une ancre fait cela gratuitement.
Limitez. Quatre ou cinq variantes sur les deux axes est beaucoup. Chacune est une page qui peut devenir obsolète indépendamment, et le pire échec d'un portfolio est d'être dépassé. Si une sixième est demandée, la meilleure question est généralement de savoir si deux existantes ont convergé.
Les variantes vivent dans shared/portfolio/{variant_slug}/, chacune enregistrant pourquoi elle a été construite, ce qu'elle a sélectionné et quand.
Choisir ce qui va sur la page — Kenechukwu choisit
Ce skill propose et il ajuste. Même forme proposer-confirmer-enregistrer 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, capacité et artefact déjà confirmé en mémoire, chacun avec un résumé d'une ligne et un identifiant. Construit par analyse ; Kenechukwu 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 phares qui appartiennent à chaque variante quel que soit la cible, etnever_includepour tout ce qu'il ne veut pas du tout 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 que donné, car sur une page d'accueil, le premier élément constitue la plus grande partie de l'impression.
Comment se déroule la conversation. Sur une nouvelle variante, ce skill propose une sélection du pool avec une raison par élément, classée pour cette cible. Kenechukwu ajoute, supprime et réordonne en langage naturel — "supprime le deuxième, mets le travail de paiement en haut, ajoute la chose que j'ai faite pour la coopérative." Confirmé une fois, écrit dans le manifeste.
Une reconstruction ne sélectionne jamais silencieusement de nouveau. La sélection existante est le point de départ à chaque fois. Une page que Kenechukwu a organisée ne devrait pas se réorganiser 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, le rafraîchissement trimestriel le soulève une fois — "cela serait un bon ajustement pour la variante fintech, l'ajouter ?" Une question, pas un diff appliqué en son nom.
Publication
HTML statique, un fichier plus des actifs, aucune étape de construction et aucun framework. La sortie est lisible et éditable à la main, car Kenechukwu voudra l'éditer à la main et un fichier généré qu'il ne peut pas toucher est pire que pas de fichier.
Où
… [tronqué pour la traduction]