Production Lines
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-hlsddétecte toujours le fichierconfluence-{slug}.mdqui 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.mdpour 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 deea-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-hlsdv1.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 dansout/et masquerait la traçabilité contractuelle. - Comportement : si
--phasefourni, écriture sousout/{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-hlsddé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-coutset/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.md→CLAUDE.mdcarte-reference-skills.md.patch.md→docs/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.