Travail de connaissance assisté par l'IA
Les workflows guidés par des spécifications valent aussi au-delà du logiciel: ils aident à structurer l'écriture, la recherche, la documentation, le travail sur les politiques et d'autres activités assistées par l'IA grâce à une intention explicite, à la validation et à une revue gouvernée.
Résumé
Les workflows guidés par des spécifications ne sont pas limités à l’ingénierie logicielle. Ils aident aussi à structurer l’écriture académique assistée par l’IA, la recherche, les contenus éducatifs, la documentation technique, la rédaction juridique et réglementaire, le travail sur les politiques et d’autres activités intensives en connaissances.
Le modèle de fond reste durable même lorsque les produits d’IA individuels changent:
- définir l’objectif et les contraintes
- conserver le contexte pertinent dans des artefacts durables
- générer et affiner les brouillons de manière itérative
- valider le résultat par rapport à des standards explicites
- laisser aux humains la responsabilité du jugement et de l’approbation
- gouverner l’automatisation par la revue, le contrôle d’accès et la traçabilité
Cette page se concentre sur ces principes stables plutôt que sur un outil d’IA particulier.
Note de l’auteur / modèle mental utile: Une manière pratique de penser l’IA est de la voir comme un oracle moderne. En informatique, un oracle est un système hypothétique qui répond à une classe de questions. En cryptographie, un oracle peut être interrogé sans exposer son fonctionnement interne. Les questions entrent, les réponses sortent et l’intérieur reste caché. C’est précisément pour cela que la confiance, la validation, la gouvernance et la responsabilité comptent.
De l’IA interactive aux workflows agentiques
Beaucoup de personnes découvrent d’abord le travail assisté par l’IA via des systèmes interactifs sur le web. C’est un point de départ raisonnable.
Les workflows guidés par des spécifications n’exigent pas des agents de codage, des outils en ligne de commande ou l’automatisation d’un dépôt. L’IA interactive peut déjà aider sur des tâches utiles de début de parcours, comme rédiger des spécifications, relire des documents, affiner des exigences, générer des contenus candidats, repérer des manques, proposer des stratégies de validation et explorer des alternatives.
Cela fait de l’IA interactive un point d’entrée naturel pour les personnes qui travaillent sur des documents ponctuels, des premières versions ou de petits projets. Un chercheur peut l’utiliser pour clarifier le plan d’un article. Un enseignant peut l’utiliser pour affiner les objectifs pédagogiques et le niveau de difficulté. Une équipe de politique publique peut l’utiliser pour comparer plusieurs structures possibles avant le début de la rédaction formelle. Une équipe juridique ou réglementaire peut l’utiliser pour mettre au jour des définitions manquantes, des hypothèses non résolues ou des dépendances de revue.
L’idée clé est que la spécification n’est pas limitée aux fonctionnalités logicielles. Dans le travail de connaissance au sens large, une spécification peut définir:
- les objectifs
- les contraintes
- les attentes de qualité
- le public visé
- la terminologie
- les exigences de preuve
- les exigences d’accessibilité
- les obligations de conformité
- les standards de publication
Un article académique, par exemple, peut être guidé par des attentes concernant le style de citation, le niveau de preuve, la cohérence terminologique, les déclarations éthiques, la revue ciblée et la qualité linguistique. Un support éducatif peut devoir respecter des objectifs d’apprentissage, un niveau de lecture, l’alignement sur un programme, des contraintes d’accessibilité et des règles d’évaluation. Une documentation technique peut devoir rester alignée sur le comportement du produit, la structure de publication, les règles relatives aux captures d’écran et les politiques de versionnement. Une rédaction juridique ou de politique publique peut devoir refléter une juridiction, une terminologie approuvée, des étapes de revue et des références obligatoires.
Dans tous ces cas, la spécification aide à faire passer le travail de prompts vagues vers une intention explicite.
Markdown comme format durable pour le travail de connaissance
En pratique, de nombreuses équipes stockent les spécifications, notes, revues, constats, prompts et artefacts de workflow en Markdown. Markdown n’est pas le seul format utile, mais il est souvent pratique parce qu’il est:
- lisible sans logiciel spécialisé
- suffisamment lisible par machine pour l’automatisation
- bien adapté au contrôle de version et à la revue des diffs
- portable entre outils et plateformes
- durable sur de longues périodes
Ces qualités comptent dans le travail assisté par l’IA parce que le contexte n’a de valeur que s’il peut être conservé, revisité et réutilisé. Markdown facilite la conservation de davantage que le livrable final. Il peut préserver les objectifs, hypothèses, contraintes, constats de revue, règles de publication, résultats de validation et décisions avec leur justification.
C’est utile pour les humains parce que cela améliore la traçabilité et la revue. C’est aussi utile pour les systèmes d’IA parce que cela maintient le contexte important dans un format qui peut être cité, recherché, résumé et récupéré avec relativement peu de friction.
Markdown ne doit pas être traité comme une solution magique. Il ne garantit ni l’exactitude, ni l’actualité, ni la qualité du jugement. Mais il constitue souvent un bon support durable pour la mémoire organisationnelle.
Le raffinement itératif est le cas normal
Les workflows réels assistés par l’IA sont rarement linéaires. La spécification est souvent incomplète au départ et devient plus claire au fil des échanges.
Un cycle réaliste ressemble souvent à ceci:
- définir un objectif
- rédiger une spécification
- générer un premier résultat
- relire le résultat
- affiner la spécification
- valider la révision
- répéter jusqu’à ce que le résultat soit acceptable
C’est important, car beaucoup de personnes imaginent encore un workflow d’IA comme un prompt unique suivi d’une réponse terminée. Dans un travail sérieux, ce n’est généralement pas ainsi que la qualité apparaît. Le plus souvent, elle vient de clarifications successives.
L’humain reste central tout au long de ce cycle. L’IA peut aider pour la génération, l’organisation, la transformation, la comparaison et la revue, mais les humains restent responsables de:
- les objectifs
- les priorités
- les arbitrages
- les décisions d’approbation
- les jugements de qualité
En ce sens, l’humain n’est pas seulement un auteur de prompts. Il agit comme relecteur, éditeur, expert du domaine et décideur.
Pourquoi l’IA interactive atteint finalement des limites pratiques
L’IA interactive reste utile même dans des workflows plus matures, mais les projets plus vastes révèlent souvent deux limites récurrentes: le contexte et les outils.
Le contexte est fini. Même lorsque des systèmes modernes peuvent traiter de grandes quantités d’information, il reste peu pratique de garder en permanence chaque spécification, constat, source, commentaire de revue et document d’appui dans une seule conversation. À mesure qu’un projet grandit, le problème n’est pas seulement la quantité totale. Le problème est aussi la pertinence.
C’est pourquoi beaucoup de workflows agentiques reposent sur la récupération. Au lieu d’essayer de tout garder simultanément en vue active, le système stocke des éléments durables et récupère les éléments les plus pertinents au moment opportun. L’objectif n’est pas nécessairement de fournir plus d’informations d’un coup, mais de fournir les bonnes informations quand elles sont nécessaires.
L’accès aux outils est la deuxième limite. Les plateformes web interactives proposent généralement des outils soigneusement sélectionnés, conçus pour fonctionner de manière fiable pour un large public. Cette sélection présente de vrais avantages:
- fiabilité
- entretien
- sécurité
- cohérence
Mais le travail spécialisé nécessite souvent des logiciels spécialisés. Une interface généraliste peut ne pas suffire pour un workflow qui dépend de la vérification de citations, de l’OCR, de systèmes de publication, de l’automatisation du navigateur, de l’analyse statistique ou de la revue de conformité.
C’est l’une des raisons de l’émergence des workflows agentiques. Ils permettent aux systèmes d’IA de récupérer un contexte ciblé, d’appeler des outils pertinents, de valider le travail et de continuer à itérer sur des ensembles de matériaux plus importants.
Compétences, outils et systèmes spécialisés
Dans le travail assisté par l’IA, les outils sont souvent des interfaces vers des systèmes spécialisés plutôt que des remplaçants de ces systèmes.
Exemples:
- vérification orthographique et validation linguistique
- OCR
- automatisation du navigateur
- génération de diagrammes
- validation des citations
- logiciels statistiques
- systèmes de publication
- systèmes de traitement documentaire
Un workflow académique peut dépendre de chaînes d’outils TeX ou LaTeX, de gestionnaires de bibliographie, de modèles de revue et de paquets statistiques. Un workflow de documentation peut dépendre de vérificateurs de liens, de validateurs d’accessibilité, de workflows de captures d’écran et de pipelines de publication. Un workflow juridique ou de politique publique peut dépendre de systèmes de gestion documentaire, de bibliothèques de clauses, de systèmes de revue ou de bases de références réglementaires.
Le système d’IA apporte la coordination et le raisonnement, tandis que les outils spécialisés réalisent le travail spécifique au domaine.
À mesure que les workflows mûrissent, les instructions répétées deviennent souvent des actifs réutilisables, comme des compétences, des modèles, des procédures, des définitions de workflow et des règles de validation. C’est l’une des manières les plus importantes par lesquelles la connaissance organisationnelle devient plus durable avec le temps. Ce qui commence comme un conseil répété dans une conversation devient souvent un actif réutilisable et révisable.
Validateurs et standards institutionnels
Les validateurs sont une partie importante du travail de connaissance guidé par des spécifications parce qu’ils aident à vérifier si un artefact satisfait un aspect de sa spécification.
Selon le domaine, les validateurs peuvent inclure:
- des validateurs de qualité linguistique
- des validateurs de style
- des validateurs de citations
- des validateurs d’accessibilité
- des validateurs de conformité
- des validateurs de publication
Les validateurs ne doivent pas être traités comme plus importants que le contenu lui-même. Ils ne remplacent ni l’autorité de l’auteur, ni l’expertise, ni le jugement. Mais ils survivent souvent à des projets individuels et aident à préserver les standards dans le temps.
Un validateur de citations créé pour un workflow de publication peut ensuite servir à de nombreuses autres publications. Un validateur terminologique peut réduire les incohérences entre auteurs et équipes. Des validateurs d’accessibilité et de publication peuvent aider à maintenir des attentes institutionnelles de qualité même lorsque les contributeurs et les outils changent.
Il ne faut pas s’attendre à ce que chaque auteur construise lui-même ces validateurs. Dans de nombreux cas, ce travail exige une expertise technique, une connaissance du domaine, de l’infrastructure et de la maintenance. Il est raisonnable que des universités, des éditeurs, des groupes de recherche, des institutions publiques ou des équipes plateforme internes fournissent des validateurs partagés plutôt que d’attendre de chaque rédacteur qu’il les crée à partir de zéro.
Formats durables au-delà du texte
Même si Markdown est souvent pratique pour les artefacts textuels, d’autres formats durables comptent aussi.
SVG est souvent un format utile pour les diagrammes parce qu’il est textuel, extensible, raisonnablement adapté au contrôle de version et accessible à la fois à l’édition humaine et au traitement assisté par l’IA. Ce n’est pas toujours le bon format, mais il fonctionne bien lorsque les diagrammes doivent être maintenus comme des artefacts vivants plutôt que comme des images opaques.
Le principe général est plus large qu’un type de fichier particulier: les formats qui restent inspectables, portables et maintenables soutiennent généralement mieux les workflows assistés par l’IA que ceux qui masquent la structure ou rendent la revue inutilement difficile.
Localisation et contexte du lecteur
Les workflows guidés par des spécifications s’appliquent aussi au travail multilingue. Les spécifications, constats de revue, exemples et artefacts de workflow peuvent tous nécessiter une localisation.
Lorsque des documents sont localisés, les exemples devraient en général l’être aussi lorsque c’est pratique. Des citations anglaises inutiles augmentent la charge cognitive pour des lecteurs qui lisent par ailleurs dans une autre langue.
Les exceptions peuvent inclure:
- les noms d’entreprise
- les noms de produit
- les standards
- les commandes
- le code
- les noms de protocoles
L’objectif n’est pas une pureté linguistique absolue. L’objectif est de réduire la friction pour le lecteur et de garder les artefacts de workflow compréhensibles dans sa langue de travail.
Une brève étude de cas de workflow
La transcription d’appui pour ce sujet est un bon exemple de la manière dont les spécifications évoluent à travers la discussion. Elle n’a pas commencé avec une structure de chapitre entièrement formée. Les exigences ont émergé de façon itérative.
Une forme abrégée de cette discussion ressemblait à ceci:
- idée initiale: “extend the doc … practical insight … academic, educational and possibly legal writing”
- critique: “Je ne le formulerais pas aussi directement … les validateurs ont une utilite durable”
- élargissement du périmètre: “first I’d focus on interactive web AI”
- limites pratiques: “there’s limit how much context AI can hold at once …”
- architecture du workflow: “role of skills … interface to specialised programs”
- préoccupations de gouvernance: “serious security implications of using third party skills”
- préoccupations de localisation: “quotes should also be localized to each language”
- consolidation: “un seul grand sujet … mieux vaut quelques articles plus substantiels”
Cette séquence est plus représentative du travail réel assisté par l’IA qu’un récit de réussite parfaitement poli. La leçon importante n’est pas qu’un prompt parfait a fini par être produit. La leçon importante est que les exigences, objections, décisions éditoriales et préoccupations de gouvernance ont été progressivement transformées en une spécification plus claire.
Gouvernance, confiance et sécurité
À mesure que les systèmes d’IA passent d’une assistance passive à la rédaction vers l’usage d’outils et l’exécution de workflows, la gouvernance devient plus importante, et non moins importante.
La sécurité logicielle traditionnelle s’est souvent concentrée sur le code exécutable. Dans les systèmes assistés par l’IA, la frontière est plus large. Les instructions elles-mêmes peuvent influencer le comportement. Les spécifications, définitions de workflow, prompts et descriptions de compétences peuvent toutes affecter ce que le système fait et la manière dont il le fait.
Cela ne signifie pas que chaque fichier texte doit être considéré comme intrinsèquement dangereux. Cela signifie que les organisations doivent réfléchir attentivement aux frontières de confiance. Dans les environnements assistés par l’IA, certains textes ne sont pas seulement descriptifs. Ils peuvent devenir opérationnels.
Compétences, intégrations et frontières de confiance
Les compétences tierces, outils, paquets de workflow et intégrations peuvent être utiles, mais ils introduisent aussi des questions de gouvernance.
Les organisations peuvent raisonnablement préférer:
- des compétences développées en interne
- des workflows relus au niveau institutionnel
- des fournisseurs de confiance
- des intégrations gouvernées
Cela est particulièrement pertinent lorsqu’une compétence ou une intégration peut influencer la récupération, la transformation, la publication, l’accès externe ou l’invocation d’outils. Un workflow bien gouverné prête généralement attention non seulement à ce que l’IA peut dire, mais aussi à ce qu’elle peut atteindre, déclencher ou modifier.
De grands fournisseurs comme OpenAI, Microsoft et Oracle peuvent proposer des écosystèmes d’outils et des couches d’intégration, mais la question de gouvernance durable n’est pas de savoir quel produit actuel existe. La question est de savoir si l’organisation comprend et juge digne de confiance la frontière de workflow qu’elle adopte.
Maintenir l’autorisation en dehors du raisonnement de l’IA
Un principe de conception utile consiste à maintenir les décisions d’autorisation en dehors du système d’IA chaque fois que c’est pratique.
L’IA peut aider à décider quelle action paraît appropriée, mais la permission effective d’exécuter cette action devrait idéalement être imposée par des systèmes conçus pour l’authentification, l’autorisation, l’audit et la gestion des identifiants. En pratique, cela signifie souvent s’appuyer sur:
- des fournisseurs d’identité
- le contrôle d’accès basé sur les rôles
- des permissions de base de données
- des passerelles API
- des approbations de workflow
- une gestion sécurisée des identifiants
Les identifiants devraient être gérés par des systèmes conçus pour cela, et non intégrés dans des prompts, des spécifications ou des textes de workflow improvisés.
Cette séparation est importante, car elle réduit le risque qu’une instruction générée de manière persuasive soit prise pour une autorité légitime. L’approbation et le contrôle d’accès doivent rester ancrés dans des systèmes conçus pour les imposer.
Les passerelles d’IA comme couche de gouvernance
Certaines institutions peuvent choisir d’introduire l’IA par des passerelles contrôlées plutôt qu’en exposant directement chaque système interne.
Une passerelle d’IA peut prendre en charge:
- l’audit
- l’application des politiques
- l’authentification
- l’autorisation
- la supervision
- l’accès approuvé aux outils
Ce n’est pas une exigence universelle, et des équipes plus petites peuvent choisir des contrôles plus légers. Mais c’est un modèle de gouvernance raisonnable pour des institutions qui ont besoin de traçabilité, de supervision centrale ou d’une application cohérente des politiques à travers de nombreux utilisateurs et workflows.
Pourquoi la gouvernance devient plus utile à mesure que l’automatisation augmente
Une automatisation plus poussée ne supprime pas le besoin de revue. Elle augmente la valeur d’une revue responsable.
À mesure que le travail assisté par l’IA s’accélère, les organisations ont souvent besoin de structures plus fortes, et non plus faibles, pour:
- la responsabilité
- la traçabilité
- la validation
- l’approbation
- la confiance
- la préservation de la connaissance institutionnelle
C’est l’une des raisons pour lesquelles les workflows guidés par des spécifications restent utiles au-delà des tendances actuelles des outils. Ils offrent aux organisations un moyen de préserver l’intention, de définir des standards, de relier les résultats à la revue et de gouverner l’automatisation sans prétendre que l’automatisation rend la gouvernance inutile.
Enseignement pratique
La leçon la plus durable est simple:
Le travail de connaissance assisté par l’IA devient plus fiable lorsque les objectifs, contraintes, standards, validations et autorités sont rendus explicites.
Ce principe s’applique au logiciel, mais aussi à la recherche, à l’enseignement, à la documentation, au travail sur les politiques, à la rédaction juridique et à d’autres processus sérieux de rédaction et de revue. Les outils changeront. Le besoin de spécifications, de contexte révisable, de validation et de frontières de confiance gouvernées a de fortes chances de rester.
Comment travailler avec l’IA
- traiter l’IA comme une collaboratrice capable, pas comme une autorité
- vérifier les affirmations importantes
- préserver le contexte important
- consigner les objectifs et les hypothèses
- relire les résultats
- laisser aux humains la responsabilité des décisions
Matériel d’appui
Le matériel d’appui disponible à docs/supporting-material/spec_driven_workflow_thread.html documente une partie de la discussion et du processus d’affinement derrière cet article. C’est un artefact de workflow, et non la source unique de chaque idée présente dans l’article.
La transcription contient des idées incomplètes, des opinions changeantes, des propositions abandonnées, des formulations encore brutes, des fautes de frappe ou d’autocorrection, ainsi que d’autres traces d’un affinement itératif. Les conclusions de l’article et les réflexions de l’auteur ne se confondent donc pas avec la transcription.
Cette page inclut aussi une synthèse ultérieure, de l’édition, de l’expérience d’implémentation, des revues de localisation, du travail de validation et une réflexion personnelle. Certaines conclusions ont émergé après la fin de la discussion enregistrée.
Pages liées
spec-driven-development.mdmarkdown-in-product-development.mdvalidation-layers.mddocumentation-traceability.md