Méthode

Une recommandation se construit avant de s'écrire

Notre méthode transforme une question d'architecture en décision explicite, argumentée et traçable.

Les sept étapes

Les questions d'abord

Avant d'écrire une ligne : les faits, les preuves, l'historique, les personnes concernées et les options déjà écartées. Une recommandation qui ignore pourquoi une option a été écartée sera écartée à son tour.
Un constat en deux temps

Ce qui ne va pas (les faits techniques), puis ce que ça produit (les conséquences pour l'équipe et le métier). Séparer les deux évite de débattre des symptômes.
Les options envisagées

Y compris le statu quo et les options déjà rejetées, chacune avec ce qu'elle règle et ce qu'elle coûte.
Une recommandation en une phrase

Puis sa justification. Si elle ne tient pas en une phrase, elle n'est pas encore prête.
Les compromis assumés

Ce que l'on accepte de perdre, et le signal qui doit faire réexaminer le choix.
Un plan de mise en œuvre

Des lots, leurs prérequis et leurs critères de fin.
Une décision attendue explicite

Changer, étudier ou confirmer. Chaque recommandation se termine par une question à laquelle on peut répondre.

Un e-mail court : rappel du contexte, constat, recommandation en une phrase, décision attendue, lien vers le document.
Un document détaillé, rangé dans votre outil de documentation, avec ses sources externes citables.
Un index des recommandations et de leur statut : on sait ce qui a été décidé, quand et pourquoi.

Les décisions sont traçables : utile pour un audit, une certification ou l'arrivée d'une nouvelle personne.
Les désaccords sont écrits et argumentés, plutôt que rejoués à chaque réunion.
Les compromis sont visibles avant qu'ils ne surprennent.
Une décision documentée se réexamine facilement quand le contexte change.

Nous pouvons commencer par la phase de questions.