Comment rendre un portfolio citable par un agent IA ?

Réponse courte

En clair.

• Un agent IA cherche des faits, des liens et des preuves.
• La page HTML est faite pour les humains.
• Les fichiers Markdown et JSON donnent les mêmes informations sous une forme simple à lire par machine.
• Le but est de rendre les faits vérifiables, pas d'imposer une citation.
• Ce site publie un guide llms.txt, des profils JSON, des questions-réponses, des preuves et des fiches projet en Markdown.

Problème

Ce qui bloque.

Un portfolio peut être clair pour un humain et difficile à lire pour un agent. Le titre, les projets et leurs limites sont souvent dispersés dans la page.

Méthode

Comment je le traite.

• Créer un llms.txt court pour orienter l'agent.
• Garder un profile.json pour les faits stables : titre, disponibilité, outils, projets et limites.
• Ajouter un claims.json en questions-réponses pour éviter les réponses inventées.
• Publier un registre qui sépare les preuves publiques, privées, déclarées et retirées.
• Publier les pages clés aussi en Markdown, sans la mise en page.
• Relier la personne, les compétences et les projets dans du JSON-LD, un format de données structuré.

Exemple

Sur ce portfolio.

Sur ce portfolio, Preuvia sert de cas d'audit de visibilité dans les assistants IA. Un recruteur lit les pages HTML ; un agent peut suivre llms.txt et vérifier les mêmes faits dans les fichiers JSON et Markdown.

Limites

Ce que ça ne prouve pas.

• Un fichier llms.txt n'oblige aucun modèle à citer une source.
• Les assistants changent leurs réponses selon le modèle, le prompt et le moment.
• La couche machine doit rester cohérente avec les pages humaines ; sinon elle devient une seconde version du site.