DESIGN-NOTES — /ea-archi-cible v1.0

DESIGN-NOTES — /ea-archi-cible v1.0

Décisions clés

1. Trois tiers (T1/T2/T3) via flag --tier

  • Pourquoi : DAE-0007 a démontré que la cible T3 (20-40 p.) est très différente d'une page Confluence A280 standard (T2). Un seul skill monolithique forçait soit du sous-livré (sur des évaluations de systèmes) soit du sur-livré (sur des projets simples). 3 niveaux = 3 archétypes clairs.
  • Tradeoff : 3 templates à maintenir vs un seul. Vaut la peine car les sections divergent fortement entre T1 et T3.

2. Compatibilité ascendante — /ea-changement-solution reste fonctionnel comme alias

  • Choix retenu : alias (le skill existant continue d'exister, redirige vers /ea-archi-cible --tier 2), PAS refactor qui supprime le fichier.
  • Pourquoi : (a) zéro breakage pour les utilisateurs et orchestrateurs externes ; (b) /ea-hlsd détecte toujours le fichier confluence-{slug}.md qui reste le nom de sortie de T2 ; (c) l'évolution est invisible jusqu'à ce que quelqu'un veuille passer à T1 ou T3 explicitement.
  • Action déploiement : modifier ea-changement-solution.md pour ajouter un encart "legacy — redirige vers /ea-archi-cible --tier 2" en tête, et garder la logique existante en fallback. Pour cette livraison, on ne touche pas au contenu de ea-changement-solution.md (lazy migration) — la marque "legacy" est dans CLAUDE.md et carte-reference-skills.md uniquement. Si le skill est appelé directement, il fonctionne comme avant. Quand /ea-hlsd v1.1 le remplace au Stage 7 par /ea-archi-cible --tier 2, la sortie reste identique en nom et en structure.

3. Templates lus au runtime

  • Pourquoi : on suit le pattern existant de /ea-hlsd (lecture du skill enfant fresh à chaque exécution). Les templates sont éditables sans toucher au skill principal. Cohérent avec les autres skills EA.

4. --phase aware

  • Pourquoi : DAE-0007 a structuré ses livrables par clause contractuelle (01-demarrage, 02-ateliers, 03-synthese-besoins, 04-portrait-ti-cible, correspondance). Sans support, le skill écrirait directement dans out/ et masquerait la traçabilité contractuelle.
  • Comportement : si --phase fourni, écriture sous out/{phase}/. Le skill lit aussi les artefacts existants du même dossier de phase pour cohérence (4.1.1, 4.1.2 déjà produits → ne pas dupliquer).

5. Modèle par tier

  • T1/T2 → Sonnet 4.6 (analyse standard, tableaux, peu de raisonnement architectural multi-options)
  • T3 → Opus 4.7 (raisonnement architectural profond, options A/B/C, traçabilité multi-section)
  • Le skill signale à l'utilisateur avant T3 (sauf si orchestré par /ea-hlsd déjà sur Opus)

6. Subagent-friendly T2/T3

  • Pas de questions interactives une fois les sources valides → lacunes marquées À compléter, non bloquantes.
  • T1 seul autorise 2-3 questions de clarification pour le tonal exécutif.

7. Structure T3 reverse-engineerée de DAE-0007

22 sections regroupées en 10 blocs (A→J), couvrant les 7 sous-livrables Bruno Bock. Le template prévoit deux modes :

  • Monolithique : un seul fichier architecture-cible-{slug}.md
  • Série (avec --phase) : 7 fichiers 4-1-1.md..4-1-6.md + master

Tradeoffs documentés

  • Pas d'auto-détection du tier : volontaire. Le choix du tier est un signal stratégique de l'AE, pas une déduction automatique. Évite les surprises ("pourquoi mon T2 fait 40 pages?").
  • Pas de mode --tier 4 (livrable complet avec coûts + roadmap intégrés) : déjà couvert par T3 + appels optionnels /ea-changement-couts et /ea-changement-feuilleroute. Pas besoin de 4e tier.
  • Templates en français seulement : aligné avec le client STM. Si futurs clients anglophones, dupliquer les templates en templates/hlsa-tier-N-en.md.

Instructions de déploiement

Depuis output/v2-skills/, copier vers C:\Users\bockb\OneDrive - STM\agent-ea\ :

Source Destination
ea-archi-cible.md .claude/commands/ea-archi-cible.md
templates/hlsa-tier-1.md .claude/commands/templates/hlsa-tier-1.md
templates/hlsa-tier-2.md .claude/commands/templates/hlsa-tier-2.md
templates/hlsa-tier-3.md .claude/commands/templates/hlsa-tier-3.md
ea-hlsd.md .claude/commands/ea-hlsd.md (overwrite — vérifier d'abord !)

Puis appliquer manuellement les deux patches :

  • CLAUDE.md.patch.mdCLAUDE.md
  • carte-reference-skills.md.patch.mddocs/carte-reference-skills.md

Test de validation suggéré

Re-générer DAE-0007 portrait TI cible avec :

/ea-archi-cible trangesco-evaluation-systemes --tier 3 --phase 04-portrait-ti-cible

Comparer les fichiers produits aux gold-standards de Bruno Bock pour évaluer la fidélité structurelle.