Aller au contenu

Conventions de communication — Squad Analyse

Décision de référence : ADR-009 — Cadence et formats par audience.

Objectif

Rendre les avancées compréhensibles sans multiplier les documents ni imposer le même niveau de détail à toutes les audiences.

Chaque communication répond à deux questions :

  1. Quel niveau d’abstraction est utile à cette audience ?
  2. Quelle action attend-on après la lecture ?

Mapping audience × format

Audience Niveau de détail Format utile Action attendue
Account Managers et opérations Métier, sans jargon technique Visuel, démonstration ou message court Comprendre le changement et signaler les lacunes
Analyse et comité Métier détaillé Démonstration et données sourcées Challenger les résultats et les règles
Équipe technique Architecture, risques et code Markdown, plan, PR ou schéma Reviewer et préparer la maintenance
Leadership Synthèse décisionnelle One-pager, métriques et jalons Arbitrer ou valider
Équipe élargie Vue d’ensemble Résumé court avec liens Comprendre l’avancée et identifier le bon contact

Formats

Format Usage
Message court Avancée macro sans débat nécessaire
One-pager Initiative, décision ou état des lieux
Démonstration Parcours, comportement ou résultat à observer
Markdown dans le repo Décision, architecture ou méthode durable
Page opérationnelle Information accessible à l’équipe dans son outil courant
Message formel Décision contractuelle ou compte-rendu officiel

Principe directeur

Réutiliser le même socle plutôt que recréer plusieurs récits.

Le socle contient les métriques, décisions et chantiers structurants. Chaque déclinaison retire le détail inutile et rend l’action attendue explicite.

Règles

  • Utiliser « système d’analyse interne » quand le terme pipeline n’aide pas l’audience.
  • Garder les documents sources neutres et descriptifs.
  • Porter l’avis et la recommandation dans un résumé humain identifiable.
  • Lier les sources plutôt que recopier Linear, les ADR ou les résultats d’audit.
  • Relire tout contenu généré avant diffusion.
  • Supprimer une cadence qui ne produit plus de décision, de feedback ou de compréhension.

Criticité technique

La communication technique dépend du risque :

Niveau Process de communication
Faible Documentation normale du changement
Significatif Review du plan avec un pair technique
Critique Review du plan et review finale obligatoires

Le cadre actuel vit dans criticité des features.

Anti-patterns

  • envoyer un document technique détaillé à une audience métier ;
  • envoyer un résumé vulgarisé lorsqu’une décision d’architecture est attendue ;
  • communiquer uniquement en cas de crise ou de succès ;
  • maintenir plusieurs versions contradictoires entre Linear, Slack et le Brain ;
  • publier un brouillon généré sans relecture ;
  • créer un rituel récurrent lorsqu’une review ciblée suffit.

Sources