Agenda — Session de remise du talent numérique EA STM

Agenda — Session de remise du talent numérique EA STM

Commande: WO-001 Client: STM (Société de transport de Montréal) Gestionnaire de livraison: Dana Date de préparation: 2026-03-18 · Mise à jour v2: 2026-05-30 Mise à jour v2: invocation namespacée /ea:xxx, modèles courants (Opus 4.8), publication HTML/JCT (Confluence abandonné). Voir process/v2-revalidation-checklist.md.

Informations de session

Champ Valeur
Durée 90 minutes
Langue Français canadien
Format Présentiel (bureaux STM) ou visioconférence — à confirmer
Participants STM Responsable AE, administrateur technique, 1-2 analystes AE
Participant Talent Factory Dana (Gestionnaire de livraison)
Prérequis technique Agent EA installé sur la machine de démonstration, Claude Code fonctionnel, drawio-mcp disponible

Agenda

Bloc 1 — Présentation du talent numérique (10 min)

Objectif: Les participants comprennent ce que fait le talent numérique, ses 9 capacités, et quand invoquer chaque service.

Contenu:

  • Tour d'horizon des 9 capacités:
    1. Capture des exigences — structured intake depuis notes vocales, transcriptions, briefs
    2. Orientation architecturale — analyse multi-perspective (AE/SA/TA) avec recommandation
    3. Conception de solution — document A100/A280 avec analyse d'impacts
    4. Génération de diagrammes — diagrammes TOGAF L1-L6 au format Draw.io (ArchiMate 3.x)
    5. Registre des décisions — KDD avec analyse des options, justification, conséquences
    6. Validation qualité — vérification des Fact Sheets LeanIX, dossiers CRA
    7. Analyse coûts-bénéfices — calcul ROI, analyse seuil de rentabilité
    8. Planification feuille de route — phases, jalons, roadmap Gantt
    9. Publication — sortie HTML prête à publier (catalogue / portail client JCT Cloudflare Pages)
  • Vue d'ensemble de la structure de répertoire (demandes-ae/, content-in/, .claude/commands/)
  • Conventions de nommage: format DAE-NNNN, codes livrable A100/A230/A270/A280/A290/A620
  • Sélection de modèle: Haiku pour l'exécution, Sonnet pour l'analyse, Opus pour l'orchestration

Bloc 2 — Démarrage d'une nouvelle demande AE (15 min)

Objectif: Les participants savent créer un dossier de demande AE, y déposer une note, et invoquer le premier skill.

Procédure pas à pas (en direct sur la machine):

  1. Créer le dossier de la demande:
    mkdir -p demandes-ae/DAE-0006-modernisation-sap/{notes,intrants,decisions,out/diagrams}
  2. Déposer la transcription de note vocale dans notes/ avec la convention de nommage:
    note_modernisation-sap_20260318_0900.md
  3. Ouvrir l'espace de travail dans VS Code (agent-ea.code-workspace)
  4. Vérifier que Claude Code est actif et que le bon modèle est sélectionné:
    /model claude-haiku-4-5-20251001
  5. Invoquer le premier skill:
    /ea:exigences-note-revue modernisation-sap
  6. Examiner la sortie Q&R et dicter les réponses sous chaque question

Points clés à souligner:

  • Structure de dossier identique pour chaque demande
  • La note vocale transcrite est l'input principal — pas besoin de documenter manuellement
  • Le nom court (slug) est utilisé dans toutes les invocations de skills pour la même demande

Bloc 3 — Démonstration en direct — 3 skills (30 min)

Objectif: Les participants voient les trois skills principaux fonctionner sur des scénarios réalistes STM.

Chaque démonstration: ~10 minutes (invocation, exécution, examen de la sortie, questions).

Démo 3.1 — /ea:exigences-note-revue — Capture et revue des exigences (10 min)

Catégorie: Exigences Commande: /ea:exigences-note-revue {slug} Modèle recommandé: Haiku

Scénario:

Évaluation architecture pour projet de modernisation SAP

L'équipe AE de la STM a tenu une réunion de démarrage avec l'équipe TI pour évaluer un projet de remplacement du module SAP PM (Plant Maintenance) par une solution SaaS de gestion des actifs. La transcription de la réunion (45 minutes, ~3 500 mots) contient des éléments d'exigences, des contraintes d'intégration avec LeanIX et Confluence, des préoccupations sur la loi 25, et des questions ouvertes sur la migration des données historiques.

Input utilisé pour la démo: note_modernisation-sap_20260318_0900.md (transcription préchargée)

Sortie attendue: Document Q&R structuré identifiant les parties prenantes, les objectifs, les contraintes, les risques, et les questions ouvertes — prêt à dicter les réponses.

Points à démontrer:

  • Le skill identifie automatiquement les sections manquantes ou ambiguës
  • Format de sortie structuré selon Macroscope STM
  • Temps d'exécution rapide (Haiku)

Démo 3.2 — /ea:archi-orientation — Analyse multi-perspective (10 min)

Catégorie: Architecture — analyse Commande: /ea:archi-orientation {slug} Modèle recommandé: Sonnet

Scénario:

Orientation architecturale — Migration vers Azure pour les systèmes SCADA de la STM

Suite à l'intrant EA validé (DAE-0006), l'équipe doit produire un document d'orientation architecturale pour le comité d'architecture. Le projet implique la migration de serveurs SCADA sur site vers une infrastructure infonuagique Azure, avec des contraintes de sécurité OT/IT, des exigences de temps réel, et des interfaces avec les systèmes de billetterie OPUS.

Input utilisé pour la démo: Intrant EA préchargé intrant-modernisation-scada_20260318.md

Sortie attendue: Document d'orientation multi-perspective couvrant les vues AE (stratégique), SA (solution), et TA (technologie), avec analyse de 2-3 options architecturales et une recommandation justifiée selon TOGAF ADM.

Points à démontrer:

  • Analyse simultanée depuis 3 perspectives (AE/SA/TA)
  • Respect de la nomenclature Macroscope STM
  • Escalade automatique si 3+ options viables avec tradeoffs significatifs (pattern Human-in-the-Loop)
  • Publication HTML possible en sortie directe (portail client, plus de Confluence)

Démo 3.3 — /ea:diagramme-hautniveau — Génération Draw.io (10 min)

Catégorie: Architecture — génération Commande: /ea:diagramme-hautniveau {slug} Modèle recommandé: Haiku

Scénario:

Diagramme de contexte applicatif — Système de billetterie OPUS

L'équipe AE doit produire un diagramme de contexte applicatif (niveau L3 TOGAF) pour documenter les interfaces du système OPUS avec les applications périphériques: SAP, LeanIX, portail client STM, et les équipements embarqués dans les bus et métros. Le diagramme doit utiliser la notation ArchiMate 3.x et être prêt pour insertion dans le livrable HTML.

Input utilisé pour la démo: Fichier d'entrée structuré préchargé décrivant les composants et relations

Sortie attendue: Fichier .drawio valide, prêt à ouvrir dans Draw.io, intégré au livrable HTML publié via le pipeline v4 (/ea:publish-jct).

Points à démontrer:

  • Intégration avec drawio-mcp (serveur MCP Draw.io)
  • Sélection automatique du bon gabarit selon le niveau TOGAF demandé
  • Le fichier généré s'ouvre directement dans Draw.io / VS Code Draw.io extension
  • Chaînage vers la publication HTML/JCT via le pipeline v4 (publish → Cloudflare Pages)

Bloc 4 — Workflow HLSD complet (15 min)

Objectif: Les participants comprennent l'orchestrateur end-to-end et le mécanisme de quality gate.

Contenu:

  • Vue d'ensemble du workflow HLSD (High Level Solution Design):
    Note brute → Q&R structurées → Intrant EA → [Quality Gate] → Orientation → Solution → Diagrammes → Publication
  • Démonstration de /ea:hlsd {slug} sur une demande partiellement complétée:
    • L'orchestrateur détecte l'état actuel (quels artifacts existent déjà)
    • Planifie les étapes restantes automatiquement
    • Démonstration du quality gate: montrer un intrant incomplet — l'orchestrateur s'arrête et demande validation humaine avant de continuer
    • Reprendre après approbation
  • Explication du pattern Approval Gate: l'humain doit valider les résultats de validation avant la génération de diagrammes/solution
  • Sélection du modèle Opus pour l'orchestration: /model claude-opus-4-8

Points clés:

  • L'orchestrateur n'est pas obligatoire — on peut invoquer chaque skill individuellement
  • Le quality gate est un arrêt intentionnel, pas une erreur
  • La mémoire de session est persistante dans le dossier demandes-ae/

Bloc 5 — Configuration et personnalisation (10 min)

Objectif: L'administrateur technique sait où et comment modifier la configuration du talent numérique.

Contenu:

  1. Mise à jour des références (content-in/):

    • Ajouter un nouveau document de méthodologie: placer dans content-in/
    • Mettre à jour le métamodèle LeanIX: remplacer leanix-metamodel-reference.md
    • Le talent numérique lira automatiquement les nouvelles références au prochain démarrage

  2. Sélection du modèle (selon le budget et la complexité):

    /model claude-haiku-4-5-20251001    # Exécution rapide, faible coût
/model claude-sonnet-4-6             # Analyse approfondie
/model claude-opus-4-8               # Orchestration complexe

  3. Ajouter une nouvelle demande AE:

    • Dupliquer la structure de dossier DAE-NNNN
    • Incrémenter le numéro séquentiellement
    • Copier le template content-in/tools/CLAUDE-DEMANDE-AE-TEMPLATE.md si nécessaire

  4. Personnaliser un skill:

    • Les skills sont dans .claude/commands/*.md
    • Modifier les paramètres de qualité, seuils, ou instructions dans le fichier .md du skill
    • Ne pas renommer les fichiers (le nom du fichier = la commande)

  5. Publication du livrable (portail HTML / JCT):

    • La sortie HTML est générée localement, prête à publier sur le portail client (Cloudflare Pages via JCT)
    • Aucun credential Confluence requis — la publication Confluence est abandonnée

Bloc 6 — Questions et réponses (20 min)

Objectif: Adresser toutes les questions des participants, documenter les items de suivi.

Sujets susceptibles de venir en Q&A:

  • Gestion des erreurs et cas limites (input vide, demande ambiguë)
  • Support disponible après livraison
  • Mise à jour du talent numérique (nouvelles capacités, correctifs)
  • Intégration avec les outils existants (LeanIX, Confluence, SAP)
  • Sécurité et confidentialité des données (les notes restent locales)
  • Roadmap produit — futures améliorations planifiées

Dana documente: Toutes les questions et réponses dans le journal de session, items de suivi identifiés.

Scénarios de démonstration — Résumé

# Skill Scénario Input Sortie attendue
1 /ea:exigences-note-revue Modernisation SAP PM Transcription réunion 45 min Document Q&R structuré
2 /ea:archi-orientation Migration SCADA vers Azure Intrant EA validé Document d'orientation multi-perspective
3 /ea:diagramme-hautniveau Contexte applicatif OPUS Fichier d'entrée structuré Diagramme Draw.io L3 ArchiMate
4 /ea:hlsd (Bloc 4) Workflow complet avec quality gate Demande partiellement complétée Démonstration arrêt automatique + reprise

Liste de vérification pré-session (Dana)

Vérifier les 5 points suivants avant la session:

  • 1. Fixes de livraison appliqués — Confirmer que README.md (lignes 4-14 référence BMAD-AE supprimée) et agent-ea.code-workspace (deuxième entrée BMAD-AE retirée) ont été corrigés conformément au manifeste de déploiement de Diego (items FLAGGED).

  • 2. Environnement opérationnel — Claude Code installé et fonctionnel sur la machine de démonstration; claude --version retourne une version valide; npx drawio-mcp --version confirme la disponibilité du serveur MCP.

  • 3. Données de démonstration préchargées — Les 3 fichiers d'input pour les scénarios de démo (transcription SAP, intrant SCADA, fichier d'entrée OPUS) sont présents dans les dossiers demandes-ae/ appropriés sur la machine de démo.

  • 4. Documentation remise prête — Les 4 documents clients sont prêts à remettre: docs/guide-utilisateur.md, docs/guide-configuration.md, docs/carte-reference-skills.md, docs/demarrage-rapide.md — vérifier qu'aucune référence interne Talent Factory ne s'y trouve.

  • 5. Formulaire de confirmation de livraison imprimé ou partagé — Le fichier delivery-confirmation.md est accessible pendant la session pour documenter les résultats, les Q&A, et recueillir la signature du client en fin de session.