V4 — As-is synthesis¶

Commits de référence : - ba0800a — « docs: add as-is model synthesis + next-gates spec » - 52cabc0 — « docs: add facilitation graphique as-is poster (SVG hand-drawn) »

Contexte¶

Après V3, le kit est techniquement complet pour une utilisation par une équipe initiée. Mais une difficulté se pose dès qu'il faut le présenter à des sponsors : la machine d'états, les 10 portes, LIVING/COLD — tout cela est illisible pour un décideur qui découvre.

V4 répond à ce défi en produisant deux visualisations as-is : un modèle systémique interactif (model.html) et un poster de facilitation graphique (facilitation.html). Pas d'export PDF, pas de deck PowerPoint — deux pages HTML autoporteuses, ouvrables dans n'importe quel navigateur.

Décisions structurantes¶

Décision 1 — HTML autoporteur, pas d'outil de présentation¶

Les visualisations sont des fichiers .html avec CSS et éventuellement SVG inline. Aucun export depuis Figma, aucune bibliothèque externe (pas de D3, pas de Mermaid côté client). Un sponsor peut ouvrir le fichier sans installer quoi que ce soit.

Décision 2 — Deux angles : systémique et facilitation¶

model.html : rendu systémique, cases et flèches, pour une lecture analytique.
facilitation.html : poster SVG dessiné main (hand-drawn style), pour une lecture atelier.

Les deux représentent le même modèle avec deux régimes de lecture différents. La redondance est volontaire : elle donne aux animateurs d'atelier le droit de choisir l'angle selon leur audience.

Décision 3 — Hébergement dans `docs/as-is/` côté source, `docs/assets/embeds/` côté site¶

Les fichiers sources restent dans docs/as-is/ (navigable depuis GitHub). Le générateur tools/docs/copy-embeds.js les copie dans docs/assets/embeds/ pour qu'ils soient servis par MkDocs. La page Visualisations les intègre via iframe.

Pivots¶

Envisagé : intégrer Mermaid dynamique côté client. Abandonné : rend les visualisations dépendantes d'un script JS externe, casse le « ouvrable hors ligne ». Retenu : SVG inline statique.
Envisagé : Figma pour la facilitation. Abandonné : rend le livrable dépendant d'un compte Figma, perd la versionabilité git. Retenu : SVG hand-drawn éditable à la main.

Artefacts produits¶

docs/as-is/model.html — visualisation systémique
docs/as-is/facilitation.html — poster SVG hand-drawn
docs/specs/next-gates-and-safeResolve.md — spec technique de V3 consolidée

Leçons apprises¶

La friction « installer PowerPoint / Figma / telle extension » suffit à faire échouer une présentation. Un .html autoporteur se partage par email, se poste dans Slack, se rend en plein écran — sans formation, sans latence.

Le rendu hand-drawn désacralise la décision¶

Un diagramme propre en Mermaid paraît définitif. Un diagramme hand-drawn paraît discutable. Pour une présentation d'exploration, le hand-drawn invite à la contre-proposition — le Mermaid invite à la ratification. Le choix dépend du moment : phase d'exploration → hand-drawn, phase d'engagement → propre.

Versionner des HTML longs dans git n'est pas idéal, mais acceptable¶

Les diffs sur model.html sont peu lisibles. C'est un coût qu'on paie pour garder tout l'historique des évolutions de modèle. Alternatives considérées (base de données, CMS, cloud) — toutes perdent la co-traçabilité avec le code. Retenu : le coût de lisibilité diff est un mal moindre.

Les visualisations ne remplacent pas les pages markdown¶

Un sponsor qui ouvre model.html comprend la structure. Il ne comprend pas la philosophie. La page Vision complète la visualisation — les deux sont nécessaires, aucune ne suffit seule.

Voir aussi : Rebrand avril 2026 · V3 — Vague 3 · Visualisations.