Que fait Portfolio Espoir · Jalon 3 — La Signature d'Espoir ?
Vous exécutez la génération de portfolio d'Espoir. Cette compétence est ce qui définit Espoir. L'utilisateur soumet cet artefact et il reçoit des appels d'entretien. Faites en sorte que cela compte.
Localisez d'abord les fichiers du plugin (faites ceci avant toute autre chose)
Les documents de référence d'Espoir et le dossier de modèle de portfolio sont livrés à l'intérieur du plugin, pas dans le projet de l'utilisateur. Les chemins ci-dessous (references/…, assets/templates/…) sont relatifs à la racine du plugin — ils ne sont PAS relatifs à votre répertoire de travail (qui est le dossier du projet de l'utilisateur). ${CLAUDE_PLUGIN_ROOT} n'est pas substitué à l'intérieur de ce Markdown, vous devez donc résoudre vous-même la racine du plugin avec Bash, une fois, avant de lire quoi que ce soit :
# Résoudre la racine du plugin Espoir (references/, assets/, scripts/ s'y trouvent).
# $CLAUDE_PLUGIN_ROOT n'est PAS développé dans ce Markdown — résoudre dans Bash. Fonctionne
# qu'Espoir soit installé, mis en cache sur la marketplace, ou exécuté via --plugin-dir.
PLUGIN_ROOT=""
for c in "$CLAUDE_PLUGIN_ROOT" "$HOME"/.claude/plugins/cache/hope/hope/*/ "$HOME/.claude/plugins/marketplaces/hope"; do
[ -n "$c" ] && [ -f "${c%/}/plugin.json" ] && { PLUGIN_ROOT="${c%/}"; break; }
done
[ -z "$PLUGIN_ROOT" ] && PLUGIN_ROOT="$(dirname "$(find "$HOME/.claude/plugins" -path '*hope*/plugin.json' -print -quit 2>/dev/null)")"
echo "PLUGIN_ROOT=$PLUGIN_ROOT" # vérification de santé avant de lire les fichiers groupés
Si PLUGIN_ROOT revient vide, demandez à l'utilisateur où le plugin Espoir est extrait (par exemple un chemin --plugin-dir) plutôt que de deviner des chemins relatifs — une lecture relative references/… se résout par rapport au dossier du projet de l'utilisateur et échouera.
Lisez ces éléments avant de générer — ils sont essentiels. Les jetons de conception sont verrouillés ; les règles vocales s'appliquent à chaque mot du portfolio :
cat "$PLUGIN_ROOT/references/design-tokens.md"
cat "$PLUGIN_ROOT/references/voice-guide.md"
cat "$PLUGIN_ROOT/references/career-graph-schema.md"
cat "$PLUGIN_ROOT/references/milestones.md"
Ce que cette compétence produit
Un dossier de portfolio dans career-graph/documents/portfolios/portfolio-<slug>-<date>/ contenant exactement quatre fichiers nommés —
index.html— une coquille statique avec balisage SEO : le<head>(titre/description/OG/Twitter/JSON-LD enrichi/canonique/hope:share-url), l'initialisation de thème en ligne, un bloc.seo-fallbackstatique (nom/titre/résumé, supprimé à l'hydratation), la barre supérieure statique + la fenêtre modale d'exportation, et des points de montage vides. Il n'y a pas de balisage de contenu ici — le corps visible est rendu à l'exécution parportfolio.jsà partir dewindow.HOPE_DATA. C'est le fichier dans lequel les valeurs SEO de l'en-tête et les métadonnéeshope:share-urlsont estampillées.portfolio.css— la feuille de style complète ; les jetons de conception (:root) vivent ici et nulle part ailleurs (y compris les 15 jetons de niveau de segment / catégorie / intégrité — voir le canon des jetons de conception).portfolio.js— le script de comportement complet et le moteur de rendu d'exécution complet — il construit l'intégralité du<body>visible à partir dewindow.HOPE_DATA.data.js— un script classique définissant une variable globale,window.HOPE_DATA = {…}: l'ensemble de données complet pour toute la page (métadonnées + carte de confiance, identité, aperçu, expérience, projets, compétences, éducation, certifications, CV, chronologie, voyageur, social), dans des valeurs sémantiques uniquement — PAS de hex, avec la photo intégrée sous forme d'URLdata:. Ledata.jsdu modèle porte le contrat de rédaction champ par champ complet (le schémawindow.HOPE_DATA) — lisez-le avant d'émettre, et traitez-le comme la source de vérité pour les types de champs et l'optionalité.
— plus deux pages de carte de partage (share-card.html et share-card-square.html) dans le même dossier — voir "Cartes de partage et métadonnées d'aperçu de lien" ci-dessous.
La promesse d'autonomie est au niveau du dossier : le dossier n'a besoin que d'un navigateur — entièrement capable hors ligne. (Ouverture : voir l'étape "montrez-le" — sur macOS, un serveur local en une ligne est le chemin fiable ; le double-clic fonctionne généralement mais peut être bloqué par les permissions du dossier.) C'est la loi — uniquement <script src> et <link rel="stylesheet"> classiques ; pas de type="module", pas de fetch(), pas de import. Aucun <style>/<script> en ligne dans index.html sauf l'extrait d'initialisation de thème (en ligne dans <head> par conception — il empêche le flash de thème) et le JSON-LD. Ce qui appartient à quel fichier est un canon — design-tokens.md § "Structure modulaire" (chargé ci-dessus) ; citez-le, ne le reformulez pas. La page utilise les jetons de conception d'Espoir — clair par défaut (crème chaude + orange), avec un thème sombre via le bouton de bascule et la même disposition pour les deux — génère des SVG en ligne pour tous les graphiques, et s'ouvre dans n'importe quel navigateur sans connexion réseau requise.
Ce qui se trouve à l'intérieur :
- Carte d'identité — photo, nom, titre, ligne de statistiques, ligne de contact et résumé, sur une texture de grille 32×32, avec la pastille LIVE en haut à droite.
- Le Fil conducteur (The Throughline) — la bande de chronologie de carrière animée en bas de la carte d'identité (
id="throughline") : un nœud hexagonal par expérience / éducation / projet / certification inclus, un curseur de lecture glissant sur le rail, des mini-cartes au survol, cliquer pour naviguer vers la carte de chaque entrée. L'aspect et le mouvement de la bande appartiennent au modèle ; votre travail est l'ensemble de données et les ancres de carte — voir "Le Fil conducteur — contrat de données de la chronologie" ci-dessous. - Application Aperçu (opt-in) — un onglet de grille de sections, pas une bande autonome : une tuile de grille (
data-section="overview", étiquetée "Aperçu", icôneinsights, méta-compte "{n} points forts") plus un volet (id="pane-overview") qui se place en premier parmi les volets et s'ouvre par défaut lorsqu'il est présent. À l'intérieur : jusqu'à 4 statistiques vedettes choisies sous forme de grands badges hexagonaux plus une ligne d'intérêts discrets. S'affiche uniquement lorsqueoverview.showest vrai etoverview.headline_statsn'est pas vide — voir "Application Aperçu — mappage des champs" ci-dessous. - Résumé — 2 à 4 phrases dans la voix d'Espoir. Spécifique, pas générique. Fait allusion à une tension avant la résolution.
- Expérience sélectionnée — 3 à 5 expériences les plus pertinentes sous forme de cartes, chacune avec : titre, entreprise, dates, une phrase de cadrage, la contribution la plus forte (STAR avec une métrique) et les compétences démontrées.
- Projets sélectionnés — même forme que l'expérience, pour les projets dignes d'un portfolio en dehors de l'emploi formel.
- Section Compétences — meilleures compétences (organisées par catégorie, en commençant par les plus demandées sur le marché qui ont les preuves les plus solides). Chaque puce de compétence cliquable pour développer les expériences/projets qui l'ont démontrée.
- Formation / Certifications — court, factuel. Lorsqu'une entrée comporte des distinctions ou une réalisation digne d'être montrée qui vit dans le fichier de carrière (une bourse, un prix, une mention, une thèse notable), rendez-la sous forme de carte riche — voir "Cartes de formation et de certification riches" ci-dessous. Sinon, une carte
.edu-cardbasique. N'inventez jamais de distinctions ; ne rendez que ce qui est là. - Contact — e-mail et LinkedIn, rien de plus. Facultatif.
- Bascule de thème — bouton soleil/lune en haut à droite ; bascule clair/sombre, disposition inchangée.
- Vue CV cachée —
#resume-view, invisible à l'écran, rendue à l'exécution à partir deresumepour le chemin d'impression du CV (voir "Vue CV — mappage des champs" ci-dessous). - Contrôles d'exportation et de partage — le bouton Enregistrer au format PDF du modèle exporte le CV : un sélecteur (
#export-modal) pour le style + la police + l'ajustement, avec un seuil de lisibilité strict — le texte du corps ne descend jamais en dessous de 10pt. Le sélecteur PDF du portfolio est réservé pour la prochaine version — la page en direct EST le portfolio, et Cmd+P l'imprime toujours de manière native. Partager ouvre un menu Copier le lien / LinkedIn / X / WhatsApp / Email (#share-menu). Ceux-ci sont livrés dans le modèle ; votre travail est le contenu dont ils dépendent (vue CV, métadonnées OG, cartes de partage).
Comment choisir ce qui va dedans
Lisez le graphe de carrière de l'utilisateur. Si un emploi cible est nommé (hope make portfolio for Anthropic), trouvez le nœud JobPosting et :
- Calculez quelles compétences l'emploi
REQUIRES_SKILLet lesquelles la personneHAS_SKILL. - Choisissez les expériences/projets dont les arêtes
USED_SKILLetAPPLIED_SKILLintersectent le plus fortement avec les compétences requises par l'emploi. - Ordre : le plus pertinent d'abord, le plus récent ensuite, le plus riche en métriques en troisième.
- Visez la densité, pas l'exhaustivité. Trois cartes superbes battent sept cartes correctes.
Si aucun emploi cible n'est nommé, générez un portfolio général représentant le travail le plus fort de l'utilisateur dans l'ensemble.
Dans les deux cas, créez un nœud CuratedPortfolio dans le graphe liant aux expériences/compétences/projets inclus, et enregistrez sur celui-ci les décisions du catalogue d'applications de l'utilisateur sous forme de "show_summary": true|false et "show_social": true|false, et leur choix de voyageur sous forme de "timeline_traveler" (voir le catalogue d'applications et le sélecteur de voyageur ci-dessous — choix de présentation par portfolio, pas des faits sur la personne). Cela signifie que le graphe de l'utilisateur se souvient quelle curation a été envoyée pour quel rôle.
Voix dans la copie du portfolio
Espoir n'invente jamais un fait sur l'utilisateur. Chaque ligne que vous écrivez — une puce, une note, un plan, une affirmation — doit remonter au fichier de carrière ou aux propres mots de l'utilisateur dans ce chat ; une affirmation que vous ne pouvez pas sourcer est une affirmation que vous ne faites pas. C'est une promesse énoncée sur le site d'Espoir, et chaque compétence la tient.
Vous n'écrivez pas un CV. Vous écrivez une déclaration de travail design dans la voix d'Espoir.
Chaque carte d'expérience devrait :
- S'ouvrir sur un moment ou un problème spécifique, pas un résumé de poste
- Montrer ce qui a changé grâce à l'action de l'utilisateur (avec une métrique)
- Éviter le langage "responsable de" — montrer, ne pas dire
- Faire 60 à 120 mots par carte, pas plus
Exemple de transformation :
❌ "Senior Product Designer chez Figma. Responsable du système de design, mentorat des designers juniors, direction d'initiatives transversales."
✅ "Quand le système de design de Figma a commencé à se fragmenter entre les équipes produit en 2023, j'ai mené la consolidation. Huit mois plus tard, 37% de la surface de l'entreprise était unifiée sur le nouveau système, et le temps d'intégration des nouveaux designers est passé de trois semaines à une semaine. La partie difficile n'était pas les composants — c'était d'amener douze équipes produit à se mettre d'accord sur un seul bouton."
L'utilisateur peut éditer, mais la première ébauche doit donner l'impression qu'Espoir l'a écrite.
Barre de qualité visuelle
C'est le différenciateur visible. Le portfolio a un aspect indéniablement artefact Espoir — la disposition et la texture sont la marque, la couleur est le thème :
- Thème clair par défaut (crème chaude + orange). Sombre via la bascule, même disposition.
- Grille de sections interactive — cliquez sur une section pour filtrer le contenu en dessous ; l'onglet actif est orange uni avec une lueur et une barre d'intégrité.
- Badges KPI hexagonaux (personne / groupes / supervision) sur chaque rôle.
- Cartes de contribution regroupées IC vs Leadership ; compétences regroupées par catégorie avec un visuel de niveau à 4 barres ; les projets s'affichent comme les mêmes
.item-cards de type Expérience extensibles (voir le contrat de boucle de projets ci-dessous) afin que l'histoire complète de chaque projet soit visible. - Pastille LIVE à l'intérieur de la ligne d'identité, en haut à droite.
- Superposition de lignes de balayage sur les cartes + texture de grille 32×32 sur l'en-tête d'identité + lueurs subtiles. Ces textures sont des signatures — sans elles, le design semble générique.
- Inter pour le texte, JetBrains Mono pour toutes les métadonnées. Material Symbols Rounded avec un repli SVG en ligne.
- Vrais logos d'organisation via Google Favicon avec un repli de lettre.
- Autonome au niveau du dossier (voir "Ce que cette compétence produit"). Aucun appel réseau requis sauf Google Fonts optionnel (qui se dégrade en polices système lorsqu'il est bloqué).
Utilisez le modèle fourni comme structure de départ — c'est un dossier miroir du dossier de sortie (les mêmes quatre fichiers nommés). Chargez-le à partir de la racine du plugin que vous avez résolue ci-dessus :
ls "$PLUGIN_ROOT/assets/templates/portfolio/" # index.html · portfolio.css · portfolio.js · data.js
cat "$PLUGIN_ROOT/assets/templates/portfolio/index.html" # la coquille statique : en-tête SEO, .seo-fallback, montures vides
cat "$PLUGIN_ROOT/assets/templates/portfolio/data.js" # porte le contrat de rédaction window.HOPE_DATA
Contrat de construction (piloté par les données d'exécution)
Le portfolio n'est pas construit en substituant des jetons dans un balisage statique. L'agent émet un ensemble de données structuré et le portfolio.js fourni rend l'intégralité du <body> visible à partir de celui-ci à l'exécution. Il n'y a pas de jetons de contenu {{…}} ni de marqueurs <!-- HOPE:*_loop --> dans le nouveau modèle — ils ont été remplacés par window.HOPE_DATA. Suivez ces étapes dans l'ordre :
- Choisissez à partir du graphe (selon "Comment choisir ce qui va dedans" ci-dessous) : identité, aperçu, expérience (groupée IC/Leadership, forme de progression de rôle), projets, compétences (par catégorie, niveau 1–4 + années), formation, certifications, CV (puces avec une
tagannexée ; Formation = diplômes uniquement), chronologie, social et une carteconfidencepar section. - Émettez
data.js=window.HOPE_DATA = {…}— UNE globale, l'ensemble de données complet pour toute la page (le contrat de rédactiondata.jsdu modèle est le schémawindow.HOPE_DATA). Valeurs sémantiques uniquement — PAS de hex (category:"programming",level:4,confidence.band:"high"—portfolio.jsles résout envar(--token)au rendu). La photo est intégrée sous forme d'URLdata:dansidentity.photo. - Copiez
portfolio.cssetportfolio.jsdans le dossier de sortie textuellement.portfolio.cssporte déjà les 15 jetons de niveau de segment / catégorie / intégrité que le moteur de rendu résout ;portfolio.jsest le moteur de rendu d'exécution. Aucun des deux n'est jamais édité par portfolio. Ne déviez pas des jetons de conception dans$PLUGIN_ROOT/references/design-tokens.md(chargé ci-dessus). - Estampillez la coquille
index.htmlà partir de la mêmemetaque vous mettez dansdata.js, en un seul passage —data.jsest la source de vérité unique et l'en-tête/le corps sont estampillés À PARTIR DE celui-ci :- En-tête :
name/headline/og_description→<title>+description+og:*/twitter:*;share_url→hope:share-url+<link rel="canonical">;generation_date+ le JSON-LD ProfilePage enrichi (description/url/image/sameAs) ;target_company→ suffixe du titre. - Corps : le bloc statique
.seo-fallback—name/headline/summary_short. - Laissez
og:url/og:image/twitter:imagevides (content="") pour que la compétence de publication les estampille. Aucun{{…}}laissé nulle part.
- En-tête :
- Générez les deux pages de carte de partage (`shar
…
[tronqué pour la traduction]