Constructeur de Portfolio
Construisez un site de présentation d'une page, destiné aux recruteurs, pour un projet de hackathon. Le site est le livrable, même lorsque le projet n'est pas une application web : une réalisation matérielle, un modèle de ML, un CLI ou un projet de recherche bénéficient tous d'un site qui présente le travail à l'aide de vidéos, diagrammes, photos et répliques interactives. Visez la barre fixée par ces sites d'étude de cas : dispatchai.art3m1s.me, talktuah.art3m1s.me, slugloop.com, et adapted.art3m1s.me. Chacun ne ressemble à aucun autre, car chaque design est tiré de l'univers propre du projet. Cette unicité est l'objectif principal, et c'est pourquoi cette compétence s'appuie sur la compétence frontend-design plutôt que sur un modèle fixe.
Étape 1 : Rendre le moteur de conception disponible
Le design provient de la compétence frontend-design d'Anthropic, et c'est ce qui évite au résultat de ressembler à une page d'IA générique. Elle doit être disponible avant de concevoir quoi que ce soit.
Il s'agit d'une condition préalable pour l'utilisateur, et non de quelque chose que l'agent peut faire lui-même, car l'agent ne peut pas exécuter de commandes slash. Si frontend-design apparaît déjà dans vos compétences disponibles, vous êtes prêt. Si ce n'est pas le cas, demandez à l'utilisateur d'installer le plugin dans Claude Code en exécutant ces deux commandes :
/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official
La première ligne n'est nécessaire que si la place de marché n'est pas déjà ajoutée. Claude applique également frontend-design automatiquement pour les travaux frontend, donc ses principes peuvent déjà être en jeu, mais demandez à l'utilisateur de confirmer plutôt que de supposer que le plugin est présent. Chaque décision de conception à l'étape 3 passe par lui.
Étape 2 : Rassembler les faits
Détectez d'abord, demandez ensuite. Lisez AGENTS.md, PRD.md, le README, package.json, et toutes les photos, captures d'écran ou diagrammes déjà présents dans le dépôt. Ensuite, demandez uniquement ce qui manque :
- Nom du projet et un slogan qui exprime les enjeux, pas la technologie.
- Type de projet : application web, matériel ou IoT, modèle de ML, CLI ou outil de développement, application mobile, ou recherche et données. Cela décide comment vous le présenterez à l'étape 4.
- Le problème, avec une statistique réelle et sa source.
- Ce qu'il fait : trois à cinq fonctionnalités principales.
- Comment cela fonctionne : suffisamment du système pour dessiner un diagramme d'architecture.
- Preuves : vidéo de démonstration (YouTube), URL en live, Devpost, GitHub, couverture presse, et tous les artefacts open source (modèle, dataset, Figma).
- Médias de l'événement : les photos et clips candidats du hackathon lui-même, que le dépôt ne contient presque jamais. Demandez explicitement des photos de l'équipe et de la construction en cours, des photos de démo-day ou de scène et de remise de prix, des croquis sur tableau blanc ou sur serviette, et le lieu, ainsi que l'endroit où ils se trouvent (un téléphone, un drive partagé, la galerie Devpost). Ce sont ces éléments qui rendent le site réel, demandez-les plutôt que de supposer que le dépôt les contient. Si aucun n'existe, utilisez des captures d'écran, des diagrammes et la vidéo de démonstration.
- Résultats : récompenses et classement, nom de l'événement, dates, échelle et rang, temps de construction, taille de l'équipe, et toutes les métriques (commits, latence, utilisateurs).
- Équipe : noms, rôles, identifiants GitHub, URL LinkedIn et photos de profil.
N'inventez jamais de récompense, statistique, prix, rang ou citation. Si un fait est inconnu après avoir demandé, omettez cette section plutôt que de deviner.
Étape 3 : Concevoir via frontend-design
Transmettez à frontend-design un briefing construit à partir de l'étape 2 et exécutez sa boucle complète : brainstormer, explorer, planifier, critiquer, construire, et critiquer à nouveau. Sa règle fondamentale s'applique ici : tirez l'apparence du sujet, pas d'une valeur par défaut. Produisez un système de tokens compact, spécifique à ce projet :
- Palette : quatre à six valeurs hexadécimales nommées, tirées de l'univers du projet. Un répartiteur 911 se lit comme des rouges de sévérité et des ambrés sur un fond quasi noir ; une banque vocale se lit comme des bleus de confiance ; une construction de maillage vélo UCSC se lit comme une palette d'archives « carnet de terrain » usée.
- Typographie : une police d'affichage à caractère utilisée avec retenue, une police de corps complémentaire, et une police utilitaire ou monopolisée pour les données, associées délibérément plutôt que les mêmes familles pour chaque projet.
- Disposition : une page unique avec narration défilante (scrollytelling) suivant le squelette de l'étape 5.
- Mouvement : un moment de mouvement orchestré qui sert le sujet, tel qu'une révélation d'architecture déclenchée par le défilement ou une relecture de télémétrie. Des effets dispersés donnent l'impression d'être générés par l'IA, donc concentrez le mouvement en un seul endroit. Ceci est distinct du socle d'accessibilité de mouvement réduit de l'étape 6.
- Signature : l'élément unique dont ce site se souvient, incarnant ce projet. Dispatch a une console d'opérateur interactive intégrée fonctionnant sur des données amorcées ; Slugloop a son cadrage d'archives « les récepteurs ne pingent plus » ; AdaptEd a ses boucles d'apprentissage numérotées.
Deux garde-fous hérités de frontend-design :
- Évitez les looks d'IA par défaut sauf si l'univers du projet en appelle réellement un : (1) un fond crème avec un serif à fort contraste et un accent terre cuite, (2) un fond quasi noir avec un seul accent vert acide ou vermillon, (3) des règles capillaires de journal avec un rayon de bordure nul et des colonnes denses. Si votre plan de palette et de typographie tombe par réflexe sur l'un d'eux, révisez-le et expliquez pourquoi.
- La structure est information. Utilisez des marqueurs numérotés, des eyebrows et des séparateurs uniquement lorsqu'ils encodent quelque chose de vrai, comme une séquence réelle (les boucles d'AdaptEd), jamais comme décoration. Les numéros du squelette de l'étape 5 sont une liste de vérification pour l'auteur, pas un traitement visuel obligatoire.
Les libellés des sections font aussi partie de la surface de conception. Le squelette est la structure sous-jacente ; renommez ses titres dans la voix du projet (« Journal de terrain » au lieu de « Vitrine », une phrase tirée de l'univers au lieu de « Limites honnêtes », numérotés 01 à 0N lorsque cela convient au sujet). Exécutez la porte de contrôle planifier-puis-critiquer avant de construire : si un choix ressemble à la page que vous produiriez pour n'importe quel projet similaire, révisez-le. Ne construisez que lorsque le plan est réellement spécifique à ce briefing.
Étape 4 : Choisir comment présenter le travail
Le site présente le projet quel que soit son type. Le socle universel est la vidéo de démonstration plus l'artefact principal du projet, quel qu'il soit : séquences, photos, une relecture de télémétrie, un chiffre d'évaluation, ou une relecture de terminal. Ensuite, choisissez le dispositif de présentation principal selon le type de projet :
- Application web : un widget ou une console interactif(ve) intégré(e) fonctionnant sur des données amorcées (la console d'opérateur de Dispatch), avec une vue en lecture seule comme solution de repli uniquement lorsque l'interactivité n'est pas réalisable.
- Matériel ou IoT : photos de construction, un diagramme de câblage ou de système, des séquences de terrain, et une carte ou une relecture de télémétrie (Slugloop).
- Modèle de ML : un widget d'inférence interactif ou un avant-après, plus les chiffres d'évaluation et un lien Hugging Face.
- CLI ou outil de développement : une relecture de terminal (style asciinema) ou une séquence de commandes animée.
- Mobile : une vidéo encadrée dans un appareil ou un flux d'écrans cliquable.
- Recherche ou données : la figure clé, les graphiques et le diagramme de méthodologie.
Les démos peuvent être multiples. Proposez deux modes de démonstration lorsque cela aide (une visite guidée passive plus un mode interactif, comme TalkTuah), ou associez un clip de prototype précoce à un clip de terrain final pour montrer l'itération (Slugloop). Ne simulez une réplique que lorsqu'un véritable backend ne peut pas fonctionner sur un site statique ; lorsque vous le faites, amorcez-la avec des données réalistes et étiquetez-la clairement comme une réplique. Un site matériel construit sur de véritables séquences de terrain n'a besoin ni de simulation ni d'une telle étiquette.
Si le projet a reçu une couverture presse réelle, traitez-la comme un dispositif de crédibilité : rendez les coupures sous forme de cartes ou de logos de médias avec une citation et une source (Slugloop), pas comme des liens nus.
Étape 5 : Le squelette de l'étude de cas
Un défilement sur une seule page, destiné aux recruteurs en premier. Traitez-le comme un menu : n'incluez une section que lorsque les faits existent, et renommez son titre dans la voix du projet (voir l'étape 3). La numérotation ici est une liste de vérification pour l'auteur, pas un style visuel imposé.
- Hero (thèse) : ouvrez avec ce qu'il y a de plus caractéristique dans le projet, plus le slogan et les principaux appels à l'action (démo, Devpost, GitHub). Gardez la récompense ou le crédit principal visible.
- Bande de crédibilité : placement, prix, rang, taille du champ.
- Problème : les enjeux et une statistique sourcée.
- Ce qu'il fait : les fonctionnalités principales. Les cartes de fonctionnalités peuvent créer des liens profonds ou des ancres de défilement vers la partie correspondante de la section architecture, liant le quoi au comment (TalkTuah).
- Comment ça marche : le diagramme d'architecture ou de système, où la profondeur d'ingénierie se voit.
- Présentation : le dispositif choisi à l'étape 4 (widget interactif, vidéo ou vidéos, photos, relecture de télémétrie). Permettez un bloc vidéo double ou d'itération lorsque cela s'applique.
- En chiffres : une grille de statistiques audacieuses avec des chiffres grands et des étiquettes courtes. Elle peut fusionner la taille de l'équipe, le temps de construction, les commits et le rang en un seul bloc de signature (Slugloop : 4 étudiants, 36 heures, 500+ commits, Top 10). Le rang peut également apparaître dans la bande de crédibilité.
- Presse (optionnel) : une couverture réelle sous forme de cartes de coupures ou de logos de médias avec une citation et une source.
- Équipe ou équipage : biographies avec rôles, GitHub et LinkedIn.
- Limites honnêtes : ce qu'une construction de week-end est et n'est pas. Nommer les compromis est perçu comme de la maturité, pas de la faiblesse.
- Liens et sources : GitHub, Devpost, YouTube, modèle ou dataset, presse.
- Pied de page : construit en N heures lors de l'événement, avec les liens vers le dépôt et le site en live.
Étape 6 : Construire
- Construisez un site statique d'une page, exportable et prêt pour Vercel, avec Next.js par défaut (App Router). Utilisez la stack existante du projet si elle en a une. Placez-le dans son propre dossier (
site/ouportfolio/) ou un dépôt séparé pour qu'il ne s'emmêle pas avec le code du produit. - Utilisez du contenu réel partout ; pas de lorem. Suivez les conseils d'écriture de frontend-design : clair, spécifique, rédigé depuis le côté de l'écran du lecteur.
- Maintenez un socle de qualité sans l'annoncer : responsive jusqu'au mobile, focus clavier visible, et mouvement réduit respecté.
- Couvrez les bases du référencement : un titre et une description adaptés aux mots-clés, une URL canonique, une image Open Graph, exactement un
h1, et des sections sémantiques. - Utilisez de vraies captures d'écran, photos et diagrammes, y compris les médias de l'événement rassemblés à l'étape 2, placés dans les sections présentation, équipe et en chiffres ; si vous livrez une réplique simulée, étiquetez-la ; utilisez la vignette YouTube pour la démo.
- Critiquez à nouveau après le rendu, comme le demande frontend-design : capturez une image d'écran de la page, reposez-vous la question « aurais-je produit ce même look pour un projet sans rapport ? », et supprimez un accessoire en coupant une décoration qui ne sert pas le briefing.
Vérifier
frontend-designa-t-il réellement été utilisé, et le résultat ne ressemble-t-il pas à un défaut d'IA générique et ne tombe-t-il pas sur l'un des trois looks par défaut ? Appliquez son auto-critique après la construction : auriez-vous produit ce même look pour un projet sans rapport ?- Un seul
h1, titres sémantiques, responsive mobile, états de focus visibles, mouvement réduit respecté. - Chaque récompense et statistique est réelle, toute réplique simulée est étiquetée, chaque lien fonctionne, et la ou les vidéos de démonstration sont intégrées.
- Construisez et prévisualisez en local ; vérifiez les Core Web Vitals ou un passage Lighthouse si cela est pratique.
Résultat final
- Le site : chemin ou route, et comment l'exécuter.
- Système de conception : la palette, l'association typographique, le moment de mouvement et l'élément de signature, avec une ligne sur pourquoi chacun convient à ce projet.
- Dispositif de présentation : celui que vous avez utilisé et pourquoi il correspond au type de projet.
- Faits utilisés vs. omis : ce qui a été inclus et quelles sections ont été ignorées par manque de faits réels.
- Déploiement : les étapes pour le livrer sur Vercel.
- Prochaines étapes : par exemple, un domaine personnalisé, et le fait de lier le site depuis le README et un post LinkedIn.
Limites
- Rendez
frontend-designdisponible en premier, et ne livrez jamais un modèle par défaut. Le design doit être spécifique à ce projet. - N'inventez jamais de récompenses, statistiques ou presse, et étiquetez toujours les répliques simulées.
- Gardez une seule page ciblée. Ne reconstruisez pas l'intégralité du produit.
- Décrivez ce qui existe réellement. Le site reflète le projet réel, pas une version idéalisée.