Le problème, pas la solution
Ce qui est cassé, lent, bloqué ou manquant, décrit de l'extérieur. La solution envisagée est utile plus tard ; la contrainte, c'est ce à partir de quoi le périmètre se construit.
À quoi ressemble la découverte, comment le périmètre s'écrit, ce que contient une proposition, comment le travail est accepté, et qui a accès à quoi. Tout cela est publié avant le premier appel : la forme d'une mission n'est pas quelque chose que vous devez négocier pour la connaître.
Être précis sur l'adéquation vaut plus, pour un acheteur, qu'être disponible pour tout. Une entreprise qui dit oui à tout est une entreprise que l'on ne peut pas jauger.
Rien de tout cela n'est un prérequis. C'est la différence entre un premier appel passé à rassembler du contexte et un premier appel passé à prendre des décisions.
Ce qui est cassé, lent, bloqué ou manquant, décrit de l'extérieur. La solution envisagée est utile plus tard ; la contrainte, c'est ce à partir de quoi le périmètre se construit.
Qui utilise le système et ce que ces personnes cherchent à accomplir. Une surface produit conçue sans cela est une supposition recouverte d'un système de design.
La pile actuelle, où elle est hébergée, et ce qui ne peut pas changer. Les contraintes existantes façonnent l'architecture bien plus que les préférences.
Ce qui détermine réellement la date : un lancement, un contrat, une migration, un audit. Une date qui a une raison derrière elle peut être planifiée.
Tout ce qui régit qui peut toucher à la production, où les données peuvent résider, et ce qui doit être signé avant le début du travail.
Qui signe, quelle fourchette de budget est réaliste, et ce qui est évalué par ailleurs. Cela raccourcit tout ce qui suit.
Cinq réponses, et il nomme le modèle de mission qui convient au travail ainsi que les éléments précis qu'il vaut la peine d'apporter. Chaque ligne qu'il renvoie est tirée des modèles publiés sur la page des services et du cadre publié sur celle-ci. Aucun prix et aucune date : les deux découlent d'un périmètre écrit.
Vous pouvez aussi le lire directement. Les quatre modèles sont présentés côte à côte sur la page des services, et les sept étapes du premier contact à la passation figurent plus bas sur celle-ci.
Sept étapes. Rien n'est facturé avant que la troisième soit validée, et chaque étape suivante produit quelque chose que vous gardez.
C'est le chemin que suit une mission, publié comme l'engagement pris plutôt que résumé après coup. C'est le processus auquel vous pourriez nous tenir.
Un brief ou un appel. Le brief convient à un périmètre arrêté ; l'appel convient à un problème qui prend encore forme. Dans les deux cas, vous joignez la personne responsable du cadrage du travail.
Une ou deux séances de travail sur les contraintes plutôt que sur les fonctionnalités : ce qui tourne aujourd'hui, où cela fait mal, quels risques comptent en premier, et ce qui doit être vrai à la fin. Aucun engagement de part ni d'autre pour l'instant.
Le problème tel qu'il est compris, ce qui sera construit et ce qui ne le sera pas, les étapes, les hypothèses dont il dépend, et les critères de recette de chaque étape. Rien n'est facturé tant que ce document n'est pas validé, et s'il montre que ce n'est pas la bonne entreprise qui porte le travail, il le dit.
Le périmètre chiffré selon l'un des modèles de mission, avec l'échéancier de paiement, les hypothèses qui changeraient le montant, et ce qui est explicitement exclu. Un prix annoncé avant que le périmètre soit compris est une supposition en costume-cravate.
Le travail est livré par incréments vérifiables selon le périmètre validé. Chaque étape livre quelque chose d'utilisable et est contrôlée par rapport à ses critères de recette, plutôt que de s'accumuler vers une seule livraison à la fin.
Une étape est terminée quand elle satisfait les critères écrits pour elle, pas quand elle est déclarée terminée. Tout ce qui échoue à la recette est corrigé dans l'étape, et tout ce qui est découvert sans avoir jamais été dans le périmètre devient une décision explicite plutôt qu'un travail supplémentaire fait en silence.
Le code source dans vos dépôts, l'infrastructure dans vos comptes, les notes d'architecture, les runbooks, les décisions et les alternatives écartées, et les limites connues. Le critère : un ingénieur qui n'a pas participé à la réalisation peut-il la reprendre sans négociation ?
À distance en priorité et asynchrone par défaut, ce qui est une méthode de travail et non une limite : les points écrits laissent une trace qu'un appel ne laisse pas.
L'avancement, les décisions et les blocages par écrit, selon un rythme convenu au lancement. Les appels servent à ce que l'écrit fait mal : le désaccord, l'ambiguïté et la conception.
Un appel régulier dans votre fuseau horaire, plus ce dont le travail a besoin. Ce point existe pour qu'un problème n'attende jamais le prochain compte rendu d'avancement.
Chaque étape est revue par rapport à ses critères de recette à mesure qu'elle arrive, de sorte que la qualité est contrôlée en continu plutôt que découverte à la fin.
Les décisions d'architecture sont écrites au moment où elles sont prises, avec les alternatives écartées. Cette trace fait partie de ce que vous payez.
Les réponses dont un processus d'achat a besoin par écrit, énoncées ici pour qu'il ne faille pas les négocier pour les découvrir.
Le dire clairement coûte moins cher aux deux parties que de le découvrir trois semaines après le début du travail sur un périmètre.
La moitié de ce que produit une mission n'est pas du code. Le document de cadrage, la note d'architecture, le registre des risques, les listes de contrôle de déploiement et d'accès, le runbook et le dossier de passation sont les éléments qui permettent à un système d'être exploité et étendu par des personnes qui n'ont pas participé à la réalisation.
Ces documents sont publiés comme exemples : de vrais formats, remplis avec une réalisation illustrative plutôt qu'avec le système de quelqu'un. Ils sont plus utiles qu'une étude de cas, parce qu'ils montrent le livrable lui-même plutôt qu'un résumé, et parce que, une fois la mission lancée, vous pouvez exiger qu'elle s'y conforme.
Cette page publie le cadre. Voici les trois sur lesquelles elle s'appuie : ce qu'il advient de vos données, comment l'ingénierie est sécurisée, et les documents que produit la séquence ci-dessus.
Un court brief suffit pour commencer : ce qui existe, ce qui est bloqué, et ce qui doit être vrai quand le travail est terminé. Ou réservez un appel si le problème prend encore forme.