Créer son propre Artéfact

La leçon 6 a posé les fondamentaux des artefacts. Cette leçon entre dans la conception d'un artefact réutilisable : pas un script jetable, mais un outil qui vous fait gagner du temps de façon récurrente. La différence tient à quatre points : la définition initiale du besoin, les trois passes d'itération, le choix d'hébergement, et la documentation minimale.

Tous les professionnels qui adoptent Claude finissent par avoir leur petite bibliothèque d'artefacts : générateur de devis, formulaire de qualification, calculateur de marge, mini-CRM personnel. Cette leçon vous donne la méthode pour construire la vôtre.

L'erreur la plus fréquente : demander à Claude « Fais-moi un artefact pour aider à gérer mes prospects » et regarder ce qui sort. Le résultat sera générique et inutile pour vous. La règle : définir le besoin avant d'ouvrir la conversation.

Quatre questions à se poser sur papier

• Que dois-je pouvoir faire avec cet artefact que je ne peux pas faire en 5 minutes aujourd'hui ?
• Combien de fois par mois vais-je l'utiliser ? (moins de 5 fois = pas rentable à concevoir)
• Combien de temps me ferait-il gagner à chaque utilisation ?
• Qui d'autre dans mon équipe ou mon réseau pourrait l'utiliser ?

Une fois le besoin défini, la première passe consiste à obtenir une version qui fonctionne sur le cas standard. Pas joli, pas robuste : fonctionnel.

Le prompt initial type

Donnez le contexte (votre métier, vos données), la fonction principale attendue, le format de sortie souhaité, et un exemple de cas d'usage standard.

Que vérifier en passe 1

• L'artefact répond bien au besoin défini sur papier
• Sur un cas standard, le résultat est utilisable
• Les champs et boutons font ce qu'ils sont censés faire

À ce stade, on ne s'occupe ni des cas limites, ni de l'esthétique. Si la cohérence fonctionnelle n'est pas là, on n'avance pas — on reformule le prompt.

Une fois la passe 1 validée, on attaque la robustesse. C'est ce qui transforme un prototype en outil utilisable : la capacité à dégrader proprement quand le cas n'est pas standard.

Trois tests obligatoires

• Le champ vide : que se passe-t-il si l'utilisateur laisse un champ vide ? Affichage d'erreur clair, pas plantage silencieux.
• Les données aberrantes : nombre négatif là où on attend un positif, date dans le passé là où on attend le futur, texte beaucoup trop long. Comportement défini.
• Le cas inconnu : un prospect qui n'est pas dans la liste, un produit non référencé. L'artefact doit signaler proprement, pas inventer.

Demandez à Claude : « Vérifie le comportement avec champ vide, valeur négative, texte trop long, et cas inconnu. Ajoute des messages d'erreur clairs. » Trois itérations courtes suffisent à couvrir l'essentiel.

La dernière passe est esthétique et ergonomique. Sur cette passe, on travaille l'espacement, la hiérarchie visuelle, la lisibilité des libellés, la cohérence des couleurs.

Demandes types

• « Espace les sections, ça paraît tassé »
• « Hiérarchie : titre principal plus gros, sous-titre plus léger »
• « Renomme le bouton ‹ Submit › en ‹ Générer le devis ›, c'est plus clair »
• « Couleur principale en [#A8472A] pour rester en charte »
• « Vérifie le rendu mobile sur 375 px de large »

À l'issue de la passe 3, l'artefact est utilisable en contexte professionnel : par vous, par un collègue, par un client. C'est le moment où on documente et on décide de l'hébergement.

Un artefact bien documenté est un artefact qui sera retrouvé, réutilisé et transmis. Sans documentation minimale, vous le redécouvrez dans six mois et passez 15 minutes à comprendre ce qu'il fait.

La fiche A4 — six lignes suffisent

• Nom : Générateur de devis express v1
• Cas d'usage : devis simple pour mission ponctuelle < 5 000 €
• Où c'est rangé : Drive / Dossier outils / lien Publish
• Qui peut s'en servir : moi, assistante, partenaires
• Quand le mettre à jour : si grille tarifaire change
• Historique : v1 mai 2026 - création initiale

Gardez cette fiche dans un fichier artefacts.md à côté de votre dossier de stagiaire. Ajoutez chaque nouvel artefact. Au bout de quelques mois, vous aurez constitué votre propre bibliothèque opérationnelle.