TFD-0022: Rendering Layer Ownership for Framework Deliverables

TFD-0022: Rendering Layer Ownership for Framework Deliverables

Status: Accepted Date: 2026-05-26 Decision makers: CEO (Oscar / Bruno board) Consulted: Francois (Framework Specialist), Marcel (Methodology Specialist), Remy (Technical Documentation Engineer), Pablo (Production Line Architect), Elena (Enterprise Architect), Nora (Nomenclature Specialist) Supersedes: nothing Refines: TFD-0010 (Framework Library Ownership)

Context

Le développement DAE-0007 Transgesco a révélé que la structure HTML des livrables Macroscope (A100, A230, etc.) était réinventée à chaque itération. Leçon apprise : il faut des gabarits canoniques avant de produire du contenu client.

REQ-CS-001 a été créé initialement chez Remy (Technical Documentation Engineer, client-services) pour livrer ces gabarits. Pendant le scope refinement, deux faits structurels sont apparus :

  1. Francois (Framework Specialist) existe déjà comme single owner de la framework library (TFD-0010) et son output explicite inclut templates/ sous chaque framework.
  2. Macroscope a déjà 4 templates content (markdown scaffolds) chez Francois dans production-lines/digital-talent/frameworks/enterprise-architecture/macroscope/templates/, mais aucune couche rendering (HTML interactif + data binding + export).

Le gap est dimensionnel : TFD-0010 nommait Francois owner de la library mais n'avait pas distingué content templates (quoi écrire) de rendering templates (comment afficher). Décision requise.

Decision

La couche rendering d'un framework appartient au Framework Specialist (Francois), au même titre que la couche content. TFD-0010 est précisée — un framework package contient les deux couches sous un owner unique.

Conséquences immédiates :

  1. REQ-CS-001 réassigné : Remy → Francois. Renommé MET-0008, déplacé sous departments/methodology/requests/.
  2. Output canonique : production-lines/digital-talent/frameworks/<capability>/<framework>/templates/rendering/ (parallèle à templates/ existant pour content).
  3. Exporteurs mutualisés : production-lines/digital-talent/frameworks/_shared/exporters/ — un exporteur PDF/Word sert toute la library.
  4. Skill /toolkit:framework-publish sera créé pour industrialiser le travail de publication framework (nouveau framework + ajout template + republication). Owner Francois. Extrait du pattern une fois MET-0008 validé (anti-dérive).
  5. Rôles downstream préservés : Remy reste opérateur de publication côté client (publie les DAE-XXXX sur JCT/intranet en consommant les gabarits). Elena reste consumer pour ses mandats EA. Pablo reste consumer pour l'assemblage de digital talents.

Options Considered

Option Verdict
A — Reassign REQ-CS-001 → Francois, output dans framework folder, créer skill /toolkit:framework-publish Accepted — aligne TFD-0010, single source of truth, sépare clairement les couches
B — Garder Remy, output dans framework folder Rejeté — casse le principe TFD-0010 (Francois = single owner), ambiguïté maintenance
C — Garder Remy, gabarits sous client-services, skill plus tard Rejeté — reproduit le problème original (gabarits dispersés sans owner), échoue à capturer la leçon apprise déclencheuse

Rationale

  • Alignement TFD-0010 — Francois est déjà mandaté single owner. Forker l'ownership sur la couche rendering aurait créé de la dette structurelle.
  • ROI du skill /toolkit:framework-publish est plurifactoriel — TOGAF, LeanIX, Privacy (MET-0005) en bénéficieront, pas juste Macroscope.
  • Sépare clairement 3 couches :
    • Francois owne qu'est-ce qui est un gabarit valide (standard, content + rendering, skill).
    • Remy owne comment on publie le livrable final chez le client (JCT, intranet, SharePoint).
    • Elena owne quel contenu remplir pour un mandat donné.
  • Ordonnancement — spec MET-0008 écrite avant code (feedback document-before-shipping-standards), gabarits validés avant extraction du skill (anti-dérive simplicity first, règle d'exécution agent #2).

Actions

  1. ✅ Déplacer REQ-CS-001 → departments/methodology/requests/MET-0008-macroscope-rendering-templates-a100-a230-a280/
  2. ✅ Mettre à jour frontmatter request : ID, titre, assigné Francois, consumer Remy
  3. Reprendre le draft de spec à production-lines/digital-talent/frameworks/enterprise-architecture/macroscope/templates/rendering/SPEC.md
  4. Produire les 2 gabarits validants (A100+A280 jumeau, A230)
  5. Régénérer DAE-0007 A100 + A230 depuis les gabarits (regression check)
  6. Extraire le skill /toolkit:framework-publish du pattern stable
  7. Notif N-023a à Pablo + N-050 à Ada à la publication des gabarits

Consequences

  • Francois prend un nouveau request en parallèle de MET-0004/005/007 — charge à monitorer. Fallback : Remy reste acting owner avec Francois en review si saturation.
  • La granularité framework package se précise : content templates + rendering templates + exporteurs partagés + skill de publication. Interface contrat TFD-0010 à updater pour refléter cette structure.
  • Trigger de revisite TFD-0010 (« 15+ frameworks ou multi-line demand ») reste valide — TFD-0022 n'avance pas la séparation organisationnelle.
  • Collision terminologique « Macroscope » à trancher en follow-up (intake brief vs méthodologie A###) — non bloquant pour cette décision.

References

  • TFD-0010 — Framework Library Ownership (Internal with Interface Design)
  • MET-0008 — Gabarits Macroscope rendering layer (ex-REQ-CS-001)
  • Memory document-before-shipping-standards, delivery-model-foundry-not-hosted