03D'abord un walking skeleton
Quand une fonctionnalité coûte quelques heures, le danger est d'en construire beaucoup qui n'ont jamais fonctionné ensemble. La réponse de Scrum est antérieure à l'IA : un produit fin qui fonctionne d'un bout à l'autre, construit en premier. L'IA le rend moins coûteux à construire, et plus nécessaire à exiger.
Scrum demande des incréments qui fonctionnent, et une bonne planification les ordonne selon le risque autant que selon la valeur. Pour un nouveau produit, cela veut dire commencer par un walking skeleton, un squelette qui marche : la version la plus fine du système qui fonctionne d'un bout à l'autre, construite avant qu'aucune de ses parties ne soit complète. La planification agile en défend le principe, et Implémentation du RAG le montre comme la première étape d'une feuille de route. Rien de cela ne change avec l'IA. Ce qui change, c'est le coût de la construction, et avec lui la tentation de se passer de la discipline.
C'est l'équipe qui choisit la tranche, la garde étroite, décide sur des faits, et change d'avis quand les faits le disent ; sur ce projet, c'était moi.
Quelle question d'abord ?
Le produit repose sur une promesse : un hôpital peut le configurer, en toute sécurité. La configuration est rédigée dans un outil, approuvée, publiée, puis utilisée par l'application des cliniciens. Chaque partie pouvait fonctionner isolément et échouer quand même une fois reliée au reste, et tant qu'une véritable application n'avait pas tourné sur une véritable configuration, la promesse n'avait jamais été testée. C'était la question la plus risquée ; elle est donc passée en premier.
En termes de Domain-Driven Design, la promesse se trouve sur la frontière entre deux contextes délimités : l'outil de configuration, qui écrit la configuration, et l'application, qui la lit. Le contrat entre les deux est la version de référence, un ensemble approuvé qui ne peut plus être modifié une fois constitué, et, comme le soutient Tracer les frontières pour les produits critiques, c'est sur la frontière que se trouve le risque. Le squelette a été choisi pour l'éprouver avant que quoi que ce soit ne soit construit d'un côté ou de l'autre. Le vocabulaire des deux côtés était venu plus tôt encore, d'un glossaire rédigé le 6 août, devenu le langage omniprésent du projet (chapitre 08).
J'ai choisi une tranche volontairement étroite : la gestion des patients. Un agent administratif recherche un patient, modifie son dossier et l'enregistre, ou enregistre un nouveau patient. Ces parcours simples touchent la configuration, la publication, l'application, la base de données, le contrôle d'accès et la piste d'audit, et ils laissent de côté, à dessein, ce qui aurait brouillé l'épreuve : les processus cliniques, les passages de relais entre rôles, et les contrôles de sécurité qui bloquent un acte clinique à risque.
Qu'a prouvé le squelette ?
Le 14 septembre, un configurateur a disposé une page, l'a approuvée et publiée, et un agent administratif a utilisé cette page dans l'application pour rechercher, enregistrer et modifier des patients, chaque modification étant conservée dans un historique chaîné par empreintes et protégée contre deux personnes modifiant le même dossier en même temps. Dix-sept jours s'étaient écoulés depuis la décision de construire exactement cela, avant toute autre chose. Le squelette avait répondu à sa question, ce qui en a fait le premier jalon à l'intérieur du projet : une question posée à l'avance, le produit le plus fin capable d'y répondre, et une décision à la fin (chapitre 10).
Le squelette a peu de fonctionnalités et des fondations complètes. Aucun enregistrement n'est jamais supprimé : la base le refuse, quoi que demande l'application. Chaque modification copie la version précédente de l'enregistrement dans une table d'historique, dans la même opération, et la relie à la version d'avant par une empreinte cryptographique, de sorte qu'une modification de l'historique apparaît quand la chaîne est recalculée ; une vérification régulière qui la recalcule, et une copie de la chaîne conservée hors de la base, restent à faire (annexe C). Ce mécanisme doit être identique sur chaque table, et c'est le genre de travail que les gens font de façon inégale à la main. Il a été spécifié une seule fois, dans l'architecture, et Claude l'a appliqué à chaque table exactement de la même manière.
L'ordre comptait. Juste assez de l'outil de configuration a été construit pour alimenter une véritable application, puis une fine tranche de l'application pour la consommer, puis l'outil a été repris avec ce que la tranche avait appris. La règle était : pas de bouchons, et rien d'à moitié construit qui reviendrait nous mordre plus tard ; ce qui a été délibérément laissé de côté est consigné comme un manque connu, avec la raison de son report. Garder le squelette étroit a demandé de savoir dire non : fin septembre, j'ai reporté une proposition solide d'ajouter des contrôles de sécurité clinique, parce que les fondations n'étaient pas terminées.
L'architecture par l'expérience
Scrum en apparence seulement demande une architecture guidée par le risque et continue : juste assez, et juste avant le besoin. Tester une option voulait dire la construire, et construire était la partie coûteuse : la plupart des décisions se prenaient donc sur le papier. Quand un prototype coûte quelques heures, les options peuvent être construites et testées sur l'exigence réelle avant que quiconque ne décide.
La première version de l'outil de configuration utilisait JSF, le framework d'interface fourni avec le serveur d'applications Java, et il a vite produit un vrai bogue. L'interaction la plus difficile de l'outil, faire glisser un champ d'une palette vers une mise en page, a été construite deux fois : avec Apache Wicket, et avec Thymeleaf et htmx. Wicket donnait à chaque utilisateur une copie privée de la page : deux techniciens travaillant sur la même mise en page n'auraient pas vu les modifications de l'autre. Une situation de concurrence provoquée délibérément a montré que deux modifications arrivant au même moment pouvaient en perdre une en silence, quel que soit le framework ; c'est devenu un risque consigné et une règle. Le choix s'est porté sur Thymeleaf et htmx, sur la foi de l'expérience.
Inspecter et adapter
L'inspection et l'adaptation de Scrum n'ont de sens que si les faits ont le droit de changer le plan. Ils l'ont fait, plusieurs fois, et chaque changement est consigné. La plupart sont venus de l'usage de ce qui venait d'être construit ; quatre étaient assez importants pour exiger une proposition de changement BMAD en bonne et due forme. Quand une story coûte quelques heures, en défaire une est le prix normal de l'apprentissage.
Quatre fois où les faits ont changé le plan
- Des blocs aux champs. Les groupes de champs, comme une adresse, étaient placés sur une page comme un tout, ainsi que convenu. En le voyant fonctionner, j'ai compris que les gens avaient besoin de placer des champs individuels, et j'ai annulé une décision prise trois semaines plus tôt.
- Une page à côté du sujet. La page de gestion des libellés et des traductions fonctionnait comme spécifié, et elle était fausse : c'était un tableur là où les gens avaient besoin de contexte. Elle a été repensée.
- Construit et retiré le même jour. Une capacité ajoutée pour la recherche s'est révélée sans usage une fois la page de recherche simplifiée. Deux stories de vrai code et une migration de base de données ont été retirées dans la même séance ; rien n'a été gardé « au cas où ».
- Les restrictions comme configuration. Quels rôles peuvent effectuer quelles actions sur une page : cela a commencé comme un réglage du module de contrôle d'accès. Les tests en conditions réelles ont montré que cela relevait de la configuration de la page, approuvée et publiée avec elle. Cela a été déplacé.
L'adaptation n'est pas terminée. La façon dont une nouvelle configuration est publiée se révèle lourde, et elle fait moins pour la sécurité qu'elle ne le devrait. C'est le sujet du chapitre 09.
Pour votre propre projet
- Construisez le walking skeleton en premier, et exigez-le davantage quand l'IA écrit le code : plus les fonctionnalités sont bon marché, plus elles peuvent être nombreuses à reposer sur une hypothèse que personne n'a testée.
- Laissez le choix de la tranche à l'équipe : celle qui répond à la question la plus risquée, gardée étroite même quand de bonnes propositions arrivent pour l'élargir.
- Faites construire les options d'architecture contestées et testez-les sur le cas réel le plus difficile, et laissez les faits changer le plan.