Wordspecs

Blog

Fiches de spécifications pour les agences : un format maison pour chaque client

Bêta privée. L'accès se fait par liste d'attente, et les offres payantes ouvrent à la fin de la bêta. Rejoignez la liste d'attente.

Quand chaque chef de projet construit un document client de zéro, les clients reçoivent des fichiers qui semblent venir d'entreprises différentes. Un format maison règle ce problème. Cet article présente un modèle unique, la manière dont les variantes par client s'y intègrent, la remise des documents et la façon dont un registre des modifications tranche les litiges par la suite. L'agence et les clients des exemples sont fictifs.

Ce que remarquent les clients

Les clients remarquent si un document est facile à relire. Les mêmes sections dans le même ordre, des exigences qu'ils peuvent citer par identifiant et un statut clair sur chaque page facilitent la relecture. Lorsque la mise en page change d'un projet à l'autre, les clients consacrent leur attention à retrouver les éléments au lieu de les vérifier.

Un format maison avec des variantes

Un exemple de modèle maison

Larkspur Creative est une agence fictive qui réalise des sites web et des catalogues de produits. Chaque document de projet qu'elle produit comporte ces sections, dans cet ordre :

  1. Résumé. Un paragraphe sur ce qui est construit, pour qui et pourquoi maintenant.
  2. Périmètre. Ce que l'agence construit, rattaché à un numéro de version du périmètre, par exemple v1.2.
  3. Livrables. Une liste avec des identifiants (D1, D2 et ainsi de suite), chacun avec son jalon d'échéance.
  4. Hors périmètre. Les éléments nommés qui ne sont pas inclus, écrits en toutes lettres pour que personne n'ait à deviner.
  5. Hypothèses. Ce sur quoi l'agence s'appuie côté client, par exemple un contenu fourni à une date donnée ou un accès à un serveur de préproduction.
  6. Exigences. Une ligne par exigence, avec un identifiant (REQ-001), une priorité Doit, Devrait ou Pourrait, et une seule décision par ligne.
  7. Critères d'acceptation. Une condition testable pour chaque livrable ou exigence, avec un résultat observable plutôt qu'un jugement tel que "fonctionne bien".
  8. Calendrier et jalons. Une date pour chaque jalon (M1, M2 et ainsi de suite).
  9. Processus de modification. La manière dont une modification est demandée, qui décide et où elle est consignée.
  10. Validation. Les noms et rôles des personnes qui approuvent cette version, la date et l'étiquette de version.

Variantes par client

Trois clients fictifs ont chacun besoin d'une section supplémentaire, en plus du modèle maison :

ClientSection supplémentairePourquoi le client en a besoin
Kestrel Dental GroupConformité et traitement des donnéesLes dossiers de patients sont soumis à des règles légales de traitement. La section indique où les données sont stockées, qui peut y accéder et combien de temps elles sont conservées.
Mapleton Water BoardAnnexe APILeurs ingénieurs relient le flux des compteurs à leurs propres systèmes. L'annexe liste les points d'accès, les champs de requête et les codes d'erreur.
Orrin RetailTableau de localisationLa boutique se lance en quatre langues. Le tableau indique chaque langue, ses formats de date et de devise, et le nombre de chaînes à traduire.

Quand une variante rejoint le modèle maison : lorsqu'un deuxième client demande la même section, ou lorsqu'une ligne de service en a besoin sur chaque projet. Jusque-là, elle reste une variante. Cela garde le modèle maison assez court pour qu'un chef de projet le remplisse correctement à chaque fois.

La remise

Les clients demandent des formats différents : un PDF pour la validation, un fichier Word pour commenter, et du Markdown pour leurs ingénieurs. Exportez les trois depuis une seule source, le même jour. Les copies faites à la main se désynchronisent dès que l'une d'elles est modifiée, et c'est ainsi que deux versions finissent en circulation.

Suivez cette liste de contrôle pour chaque remise :

  1. Vérifiez que la source porte l'étiquette de la version approuvée, par exemple v1.2, et que les brouillons sont étiquetés à part, par exemple draft-3.
  2. Vérifiez que toutes les sections du modèle sont présentes, que chaque exigence et chaque livrable a un identifiant unique, et qu'il ne reste ni texte de remplissage ni anciens noms de clients.
  3. Exportez le PDF destiné à la validation sous le nom orrin-retail-catalogue-scope_v1.2.pdf. Les noms de fichiers sont en minuscules, utilisent des tirets à la place des espaces et se lisent client, document, version.
  4. Exportez le fichier Word destiné aux commentaires sous le nom orrin-retail-catalogue-scope_v1.2.docx, et le fichier Markdown destiné aux ingénieurs sous le nom orrin-retail-catalogue-scope_v1.2.md, avec le même nom de base.
  5. Ouvrez les trois fichiers et vérifiez que l'étiquette de version, la date et les identifiants REQ-004 et D5 concordent dans chacun.
  6. Rédigez une courte note d'accompagnement indiquant la version, la date et les identifiants des modifications intervenues depuis la dernière version, par exemple CR-003.
  7. Consignez l'envoi dans le registre des modifications : date, destinataires par rôle, noms des fichiers et date d'échéance de la validation.
  8. Conservez l'ensemble des exports dans le dossier du projet, et marquez les anciennes versions comme remplacées au lieu de les supprimer.

Un exemple de registre des modifications

Orrin Retail est un client fictif. Il a signé le périmètre v1.0 le 2026-09-08. Chaque demande ultérieure est consignée dans le registre des modifications avant le début de tout travail. Voici le registre pour les premières semaines suivant la validation :

ChangementDateModification demandéeDemandé parApprouvé parEffet sur les livrablesEffet sur le calendrierRésultat
CR-0012026-09-22Ajouter une page de guide des tailles au modèle produitResponsable marketing du clientResponsable produit du client et responsable de compte de l'agenceD3 gagne un type de page. Le périmètre passe en v1.1.M2 passe du 2026-10-02 au 2026-10-09Approuvé
CR-0022026-10-05Afficher les niveaux de stock en temps réel sur les pages produitResponsable technique du clientResponsable produit du client et responsable de compte de l'agenceAucun. Consigné comme hors périmètre en v1.1.AucunRefusé. Elle nécessite son propre accord d'intégration.
CR-0032026-10-14Remplacer D5, un guide PDF, par un fichier Markdown destiné aux ingénieurs du clientResponsable technique du clientResponsable produit du client et chef de projet de l'agenceLe format de D5 change. La même source s'exporte en Markdown, donc le travail lui-même ne change pas.AucunApprouvé. Périmètre v1.2.

Le registre règle les litiges parce qu'il contient les dates, les noms, les rôles et la version à laquelle s'applique chaque décision. Supposons que le responsable marketing du client écrive le 2026-10-20 que le stock en temps réel a toujours fait partie du projet. L'agence ne s'appuie pas sur sa mémoire. Elle montre CR-002 avec sa date et sa décision, et renvoie à la liste hors périmètre de v1.1, que le client a signée le 2026-10-06 et qui mentionne le stock en temps réel. Le débat porte alors sur deux documents signés, et non sur qui se souvient de l'appel. Le même registre montre que le guide des tailles a été ajouté de manière formelle, avec son effet sur le calendrier : l'agence ne s'appuie donc ni sur la mémoire ni sur la confiance.

Les erreurs courantes dans les spécifications d'agence

Comment Wordspecs aide

Wordspecs propose des modèles fixes pour les spécifications produit, les fiches techniques et les aperçus d'API, des modèles enregistrés pour votre propre format maison, l'export en Markdown, PDF et Word et, dans l'offre Team, des modèles partagés et l'historique des versions. Votre modèle maison est enregistré une fois, les nouveaux documents partent de lui, et chaque export provient de la même source. Découvrez les fiches d'exemple et rejoignez la liste d'attente.

À lire aussi : les fiches de spécifications pour les équipes.

Rejoindre la liste d'attente