CV Frontend
Créez des pages de CV HTML riches en animations, sans dépendances, qui s'exécutent entièrement dans le navigateur. Aidez les utilisateurs à découvrir leur esthétique préférée par l'exploration visuelle, puis générez des CV interactifs de qualité production.
Philosophie Fondamentale
- Zéro dépendance — Fichiers HTML uniques avec CSS/JS intégrés. Pas de npm, pas d'outils de build.
- Montrer, Ne Pas Dire — Générez des aperçus visuels, laissez les utilisateurs choisir ce qu'ils aiment.
- Design Distinctif — Évitez les esthétiques génériques « d'IA ». Chaque CV doit sembler sur mesure.
- Prêt pour l'Impression — Chaque CV DOIT inclure des styles
@media printpour un rendu PDF propre. - Accessible — HTML sémantique, navigation clavier, prise en charge des mouvements réduits, contraste WCAG AA.
Phase 0 : Détection du Mode
Déterminez ce que l'utilisateur souhaite :
Mode A : Depuis un fichier — L'utilisateur fournit un fichier CV (.pdf, .docx, .md, .txt, .json) → Phase 1 Mode B : Depuis le texte — L'utilisateur fournit le contenu du CV sous forme de texte → Phase 1 Mode C : Amélioration — L'utilisateur a un CV HTML existant à améliorer → Lire le fichier, puis Phase 2
Phase 1 : Extraction & Structuration du Contenu
Étape 1.1 : Extraction du Fichier (Mode A uniquement)
Exécutez scripts/extract_resume.py sur le fichier CV de l'utilisateur :
python [chemin-compétence]/scripts/extract_resume.py <fichier_cv>
Formats pris en charge et dépendances :
| Format | Extensions | Dépendance Python | Remarques |
|---|---|---|---|
pdfplumber (recommandé) ou PyPDF2 | pip install pdfplumber | ||
| Word | .docx | python-docx | pip install python-docx |
| Markdown | .md | Aucune | Analyse les en-têtes, listes, gras/italique |
| Texte brut | .txt | Aucune | Les lignes en MAJUSCULES sont interprétées comme des en-têtes |
| JSON Resume | .json | Aucune (json intégré) | Schéma jsonresume.org ; déjà structuré — peut sauter l'étape 1.2 |
Si une dépendance requise est manquante, le script imprime les instructions d'installation.
Présentez le contenu extrait à l'utilisateur pour confirmation. Pour les fichiers JSON Resume, les données sont déjà structurées — présentez directement les sections mappées et passez à l'étape 1.3 sauf si l'utilisateur souhaite ajuster.
Étape 1.2 : Structuration du Contenu
Analysez le texte brut en sections structurées :
- header : nom, titre/accroche, localisation, contact (email, téléphone, LinkedIn, GitHub, portfolio)
- about : résumé professionnel
- experience[] : entreprise, rôle, dates, localisation, points
- education[] : école, diplôme, dates, distinctions/Moyenne
- skills{} : regroupées par catégorie avec niveaux de compétence optionnels (0-100)
- projects[] : nom, description, stack technique, lien
- certifications[] : nom, émetteur, date (optionnelle)
- languages[] : langue, compétence (optionnelle)
Présentez le contenu structuré à l'utilisateur pour révision. Demandez : « Est-ce que cela semble correct ? Souhaitez-vous ajouter, supprimer ou modifier des sections ? »
Étape 1.3 : Priorité des Sections
Demandez via AskUserQuestion :
- En-tête : « Mise en page »
- Question : « Quelles sections devraient être les plus mises en avant ? »
- Options :
- « Expérience prioritaire » — L'historique professionnel est la vedette (professionnels seniors)
- « Compétences en avant » — Les compétences techniques au premier plan (développeurs/ingénieurs)
- « Projets en vedette » — Portfolio/projets en lumière (designers/freelances)
- « Équilibré » — Poids égal pour toutes les sections
Phase 2 : Découverte du Style
Étape 2.0 : Choix du Chemin
Demandez : « Comment souhaitez-vous choisir le style de votre CV ? »
- « Montre-moi des options » — Générez 3 aperçus visuels (recommandé) → Étape 2.1
- « Je sais ce que je veux » — Choisissez directement dans une liste prédéfinie → Afficher le sélecteur de préréglages ci-dessous
Préréglages Disponibles :
| Préréglage | Ambiance | Idéal pour |
|---|---|---|
| Midnight Architect | Sophistiqué, premium | Cadres, consultants |
| Neon Terminal | Hacker-chic, développeur | Ingénieurs logiciels, DevOps |
| Dark Luxe | Élégant, éditorial | Directeurs créatifs, marketing |
| Cosmic Depth | Audacieux, futuriste | Fondateurs tech, ingénieurs IA/ML |
| Clean Slate | Minimaliste, inspiration suisse | Designers, chefs de produit |
| Paper Craft | Chaleureux, tactile | Écrivains, éducateurs, universitaires |
| Soft Blueprint | Technique, accessible | Ingénieurs, data scientists |
| Brutalist Mono | Brut, anti-design | Stratèges de marque, chercheurs d'originalité |
| Sage Garden | Inspiré de la nature, apaisant | RH, bien-être, éducateurs |
| Retro Ink | Éditorial rétro | Journalistes, marques personnelles |
Si l'utilisateur choisit directement, passez à la Phase 3.
Étape 2.1 : Découverte Guidée
Question 1 — Ambiance (sélection multiple jusqu'à 2) :
- « Professionnelle/Autoritaire » — Établie, digne de confiance
- « Créative/Distinctive » — Unique, axée sur le design
- « Moderne/Technique » — Propre, orientée développeur
- « Chaleureuse/Approchable » — Amicale, agréable
Question 2 — Ton :
- « Clair » — Propre, imprimable
- « Sombre » — Audacieux, optimisé écran
- « Peu importe » — Laissez le style décider
Étape 2.2 : Générer 3 Aperçus
En fonction de l'ambiance + du ton, sélectionnez 3 préréglages. Lisez references/STYLE_PRESETS.md pour les définitions complètes.
Correspondance ambiance-préréglage :
| Ambiance | Sombre | Clair | Spécialité |
|---|---|---|---|
| Professionnelle | Midnight Architect, Dark Luxe | Clean Slate, Soft Blueprint | — |
| Créative | Dark Luxe, Cosmic Depth | Paper Craft | Brutalist Mono, Retro Ink |
| Moderne/Technique | Neon Terminal, Cosmic Depth | Soft Blueprint | Brutalist Mono |
| Chaleureuse | Dark Luxe | Paper Craft, Sage Garden | Retro Ink |
Générez 3 mini aperçus HTML dans .claude-design/resume-previews/ :
.claude-design/resume-previews/
├── style-a.html
├── style-b.html
└── style-c.html
Chaque aperçu : autonome (~80-120 lignes), montre la section héros + une entrée d'expérience + barres de compétences. Assez pour transmettre l'esthétique.
N'utilisez JAMAIS ces motifs génériques :
- Inter, Roboto, Arial comme polices d'affichage
- Dégradés violets sur fond blanc, indigo générique
#6366f1 - Tout centré sans variation
- Vitromorphisme gratuit
Étape 2.3 : Choix
Présentez les aperçus, demandez à l'utilisateur d'en choisir un ou de mixer des éléments.
Phase 3 : Générer le CV
Lisez ces fichiers de référence pour le préréglage choisi :
references/STYLE_PRESETS.md— Variables CSS complètes, URLs de polices, palette de couleurs, style d'animationreferences/RESUME_COMPONENTS.md— Modèles CSS/JS de composants interactifsreferences/HTML_ARCHITECTURE.md— Modèle HTML de base, CSS obligatoire, architecture JS, styles d'impression, checklist d'accessibilité
Sortie
Générez un seul fichier HTML autonome :
- Tout CSS en ligne dans
<style> - Tout JS en ligne dans
<script> - Google Fonts / Fontshare via
<link>(dégradation gracieuse) - Structure HTML5 sémantique
Fonctionnalités Requises
- Révélations au défilement — Les éléments s'animent via IntersectionObserver
- Navigation flottante — Barre fixe avec suivi de la section active
- Barres de compétences animées — Se remplissent lors du défilement
- Barre de progression de défilement — Barre fine en haut
- Bouton retour en haut — Apparaît après défilement
- Feuille de style d'impression —
@media printavec fond blanc, pas d'animations, URLs visibles - Mouvements réduits —
@media (prefers-reduced-motion: reduce)désactive les animations - Responsive — Toutes les tailles utilisent
clamp(), fonctionne du mobile au desktop
Checklist de Vérification
Avant la livraison, vérifiez :
- Toute la typographie utilise
clamp(min, préféré, max) - Tous les espacements utilisent
clamp()ou des unités de viewport - HTML sémantique (
<header>,<main>,<section>,<nav>) - Styles d'impression inclus et fonctionnels
- Mouvements réduits respectés
- Libellés ARIA sur navigation, boutons, barre de progression
- Contraste des couleurs conforme WCAG AA
- Liens externes avec
target="_blank" rel="noopener"
Phase 4 : Livraison
- Nettoyage — Supprimez
.claude-design/resume-previews/s'il existe - Ouverture — Lancez dans le navigateur :
open [nomfichier].html - Résumé :
Votre CV interactif est prêt !
Fichier : [nomfichier].html
Style : [Nom du Style]
Sections : [liste]
Fonctionnalités :
- Animations au défilement
- Barres de compétences animées
- Chronologie interactive
- Navigation flottante
- Prêt pour l'impression (Ctrl+P)
- Responsive sur toutes les tailles d'écran
Personnalisation :
- Couleurs : Modifiez les variables CSS :root en haut
- Polices : Changez le lien d'importation de police
- Animations : Modifiez les temporisations de la classe .reveal
- Contenu : Modifiez le texte directement dans le HTML
Souhaitez-vous que j'apporte des ajustements ?
Dépannage
L'extraction PDF renvoie peu de texte : Le PDF peut être basé sur une image (scanné). Demandez à l'utilisateur de fournir le contenu textuel directement.
L'extraction DOCX manque de structure : Certains fichiers DOCX n'utilisent pas les styles de titre standard (Titre 1/2/3). L'extracteur se rabat sur la taille de police des exécutions individuelles. Si la structure reste floue, demandez à l'utilisateur de confirmer quelles lignes sont des en-têtes de section.
Champs JSON Resume manquants : Le JSON peut omettre les sections optionnelles (projets, certificats, etc.). Présentez ce qui est disponible et demandez à l'utilisateur s'il souhaite ajouter manuellement les sections manquantes.
Interférence du frontmatter Markdown : Les délimiteurs de frontmatter YAML (---) sont ignorés automatiquement. Si le contenu du CV utilise lui-même --- comme lignes de séparation, elles seront également ignorées — cela est généralement sans danger.
Polices qui ne chargent pas : Vérifiez l'URL de la police. Assurez-vous que la déclaration font-family inclut un repli de police système.
Animations qui ne se déclenchent pas : Vérifiez que IntersectionObserver est initialisé. Vérifiez que la classe .visible est ajoutée.
Rendu d'impression incorrect : Assurez-vous que le bloc @media print existe. Vérifiez que les animations sont désactivées et que les fonds sont blancs.