Créer son propre Artéfact
Du besoin à l'export, en passant par l'itération.
Un artefact réutilisable, conçu de bout en bout.
Une question simple en premier
La bonne question
« Que dois-je pouvoir faire que je ne peux pas faire en 5 minutes aujourd'hui ? » Si la réponse est floue, l'artefact sera flou.
Décrire en termes d'usager
« Un commercial doit pouvoir générer un mail de relance personnalisé en 30 secondes à partir du nom et du contexte du prospect. »
Borner d'emblée
Ce que l'artefact fait. Ce qu'il ne fait pas. Sans cette clarification, vous itérez sans fin.
Mesurer le gain
Combien de temps gagne-t-on à l'usage ? Si la réponse est moins de 5 minutes par utilisation, l'artefact n'en vaut pas la peine.
Contexte d'usage
Qui utilise, pour faire quoi, dans quel contexte.
Consigne précise
« Crée un générateur de mails de relance avec champs personnalisables. »
Données et exemples
Fournir 2-3 exemples de mails que vous écrivez actuellement à la main.
Format de sortie
Page HTML autonome, champs + bouton Générer, résultat copiable.
Trois passes typiques
Cohérence fonctionnelle
L'artefact répond-il bien au besoin de départ ? Testez 3 cas réels, repérez les manques. Ajustez la logique.
Robustesse aux cas limites
Champ vide, données aberrantes, prospect inconnu. L'artefact doit dégrader proprement, pas planter.
Soin de l'interface
Espacement, hiérarchie typographique, libellés clairs. C'est la différence entre prototype et outil utilisable.
Tester un cas réel
Saisir un vrai prospect. Vérifier le mail généré.
Repérer un manque
« Le mail ne mentionne pas la date du dernier échange. Ajoute ce champ. »
Affiner l'UI
« Sépare les champs en deux colonnes, ajoute une preview en bas. »
Un artefact bien conçu est une famille
Mail de prospection à froid
Adaptez l'artefact existant. « Refais le même mais pour des prospects sans historique. » Cinq minutes.
Mail de remerciement post-RDV
Même formulaire, autre objet, autre ton. Demandez à Claude de dériver depuis l'existant.
Mail de relance impayé
Ton plus ferme, mention du retard, échéance précise. Toujours partir de la base, ne pas repartir de zéro.
Pour garder, partager, transmettre
Documenter en 2 lignes
Cas d'usage. Où c'est rangé. Qui peut s'en servir. Une fiche A4 maximum. C'est ce qui rend l'outil transmissible.
Versionner les évolutions
Quand vous modifiez l'artefact, gardez l'ancien. Vous aurez besoin de revenir en arrière au moins une fois.
Publish vs Download
Publish pour partager sans installation. Download pour héberger soi-même. Choisir selon la confidentialité des données traitées.
À tout de suite en section 2
Vous savez concevoir un artefact de bout en bout : du besoin à la documentation. La section 1 est terminée. Place à Claude Code et l'écosystème développeur.
Exercice — appropriation
Identifiez une tâche que vous répétez au moins 5 fois par semaine. Concevez l'artefact qui vous ferait gagner 10 minutes à chaque fois. Du CCDF à la version 3 itérée.
Quiz · Créer son propre Artéfact
8 questions · une seule bonne réponse par question · vous pouvez recommencer autant de fois que nécessaire.
Quelle est la première étape pour concevoir un artefact utile ?
Un artefact utile commence par une question simple. Si la réponse est floue, l'artefact sera flou. Bornez d'emblée ce qu'il fait et ce qu'il ne fait pas.
Un artefact qui économise moins de 5 minutes par utilisation est rarement rentable à concevoir.
Vrai. Mesurez le gain en temps. Si la réponse est moins de 5 minutes par utilisation, l'effort de conception et de maintenance ne vaut généralement pas la peine.
Combien de passes d'itération sont recommandées sur un artefact ?
Trois passes typiques : (1) cohérence fonctionnelle, (2) robustesse aux cas limites (champ vide, données aberrantes), (3) soin de l'interface (espacement, hiérarchie, libellés).
Que tester en passe 2 d'itération (robustesse aux cas limites) ?
Passe 2 = robustesse. Champ vide, données aberrantes, cas inconnu. L'artefact doit dégrader proprement, pas planter. C'est ce qui différencie un prototype d'un outil utilisable.
Une fois conçu, un artefact ne sert qu'à un seul cas d'usage et n'est pas réutilisable.
Faux. Un artefact bien conçu est une famille : générateur de mails de prospection → mail de remerciement post-RDV → mail de relance impayé. Demandez à Claude de dériver depuis l'existant.
Que faut-il documenter avec un artefact réutilisable ?
Documentez en 2 lignes : cas d'usage, où c'est rangé, qui peut s'en servir. Fiche A4 maximum. C'est ce qui rend l'outil transmissible à un collègue ou récupérable dans six mois.
Faut-il choisir Publish ou Download pour partager un artefact ?
Publish = lien public partageable sans installation. Download = vous hébergez et contrôlez. Choisir selon la confidentialité des données traitées.
Versionner les évolutions d'un artefact est inutile, il suffit de garder la dernière version.
Faux. Gardez les versions intermédiaires. Vous aurez besoin de revenir en arrière au moins une fois — une itération qui se révèle moins bonne, un cas que la nouvelle version ne couvre plus.