Clear Workflows

Qu'est-ce que c'est

Clear Workflows est une bibliothèque d'apprentissage, pas un blogue. Tout ce qui s'y trouve est conçu pour être exploré. Des explications en langage clair sont accompagnées de quiz, d'ateliers pratiques et de gabarits que vous pouvez intégrer directement dans votre propre travail.

Ce qui lie le tout, c'est le jugement. Ça commence par comprendre comment ces modèles fonctionnent réellement, ce qu'ils font bien et où ils échouent, afin que vous puissiez décider vous-même où l'IA vaut la peine d'être utilisée et où elle ne l'est pas. C'est écrit pour les développeurs, les analystes, les gestionnaires et toute personne dont le travail évolue à cause de l'IA.

Comment ça s'est concrétisé

Clear Workflows a pris des mois, et la majorité de ce temps a été consacré à la réflexion, pas au code. J'ai lu abondamment, rédigé des explications, et réécrit celles qui semblaient claires jusqu'à ce qu'elles le soient réellement.

Cela a été façonné autant par les gens que par mes lectures. J'ai discuté avec des développeurs, des analystes et des gestionnaires qui utilisent ces outils tous les jours, ainsi qu'avec des personnes qui comprennent les sujets sous-jacents bien mieux que moi. Leurs questions, leurs objections et leurs angles morts ont déterminé ce qui a été inclus et comment chaque élément est expliqué.

Le niveau d'exigence est resté le même tout au long. Chaque guide doit tenir la route devant quelqu'un qui connaît réellement le sujet.

La structure de la bibliothèque

Ça commence par trois présentations fondamentales, à lire dans l'ordre : comment l'IA fonctionne réellement, comment bien écrire un prompt, et ce qui change une fois que vous donnez des outils et un objectif à un modèle. Chacune est accompagnée d'un quiz, et les présentations principales ont une narration audio sur chaque diapositive.

À partir de là, ça s'ouvre. Il y a des ateliers pratiques pour développer avec l'IA, couvrant la planification, le débogage, le refactoring, la documentation et la mise en production du code sans prendre le résultat pour acquis. D'autres appliquent la même réflexion au travail quotidien : flux de processus, transferts, décisions et préparation d'une équipe au changement.

Il y a aussi un ensemble croissant de playbooks et de gabarits réutilisables, comme un canevas de cas d'utilisation de l'IA ou une liste de vérification de prompts, que vous pouvez intégrer directement dans votre propre travail.

Comment c'est construit

Sous le capot, c'est une application React et TypeScript, construite avec Vite et rendue côté serveur via Express pour que les pages arrivent vite et complètes. Elle fonctionne en anglais et en français.

Tout le contenu est stocké sous forme de données typées simples, un fichier par élément dans chaque langue, séparé du code qui l'affiche. Ajouter un guide, un quiz ou un atelier consiste surtout à l'écrire; le reste est branché une fois, puis réutilisé.

Les présentations, les quiz et les ateliers reposent tous sur le même ensemble de composants, alors ils se comportent de la même façon. Les mêmes raccourcis clavier et liens directs pour se déplacer, une vue instructeur pour présenter en direct, le pointage des quiz, et la progression des ateliers qui se sauvegarde au fur et à mesure.

Bilingue par conception

Tout le site est bilingue. J'écris le texte marketing à la main en anglais et en français, donc aucune version ne semble être une traduction de l'autre.

Il y a beaucoup plus de matériel de guides et d'ateliers que je ne pourrais retraduire à la main chaque fois que je change une ligne, donc le français pour ceux-ci passe par une étape de traduction que j'ai ajustée à ma propre voix et que je régénère chaque fois que l'anglais change. Faire en sorte que ça sonne naturel est plus difficile qu'il n'y paraît quand la source est de l'écriture technique.