ADR-018 — Capture déclarative comme mesure du cap¶
Contexte¶
Le cap « 100 % du travail d’analyse dans l’outil » exige une mesure exploitable. Une capture technique des fenêtres ou applications ouvertes aurait produit un signal pauvre, coûteux et intrusif.
Décision¶
Le cap est mesuré par trois mécanismes complémentaires :
- Feedback inline dans les surfaces de travail : signal simple et contextualisé.
- Flag de sortie d’outil : l’utilisateur indique pourquoi une information manque ou paraît peu fiable.
- Shadowing périodique : observation directe des parcours pour détecter les besoins non déclarés.
La mesure porte sur les trois personas : Account Manager, analyste et comité. Les observations sont agrégées par persona ; elles ne servent pas à évaluer individuellement les personnes.
Rationale¶
- Le déclaratif explique le pourquoi, contrairement à un simple compteur de sorties.
- Le shadowing compense les oublis et les biais du déclaratif.
- Le dispositif évite un chantier de surveillance technique disproportionné.
- Le feedback reste intégré au travail courant, sans formulaire séparé.
Conséquences¶
- Aucun tracker de navigation n’est construit pour cette mesure.
- Chaque sortie observée alimente un backlog produit par motif : information absente, explication insuffisante ou confiance faible.
- Les résultats sont restitués au niveau du parcours et du persona, jamais comme mesure de performance individuelle.
- Une vague de shadowing doit couvrir les trois personas avant toute conclusion sur l’atteinte du cap.
Alternatives écartées¶
- Capture passive par navigateur : coûteuse, intrusive et peu explicative.
- Reporting hebdomadaire séparé : trop tardif et trop lourd.
- Déclaratif seul : incomplet sans observation directe.
Sources¶
- Source migrée :
bricks-os/wiki/architecture/ADR-018-capture-declarative-comme-mesure-du-cap.md - Catalogue des sources legacy