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
- Définissez un modèle maison : les sections que contient tout document, dans un ordre fixe.
- Gardez des variantes par client lorsqu'ils ont besoin de sections supplémentaires ou d'une autre rédaction. Un client soumis à des obligations de conformité peut avoir besoin d'une section que les autres n'ont pas.
- Partez toujours du modèle enregistré pour chaque nouveau document, et jamais du dernier projet terminé, afin que les anciens noms de clients et chiffres ne se reportent pas.
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 :
- Résumé. Un paragraphe sur ce qui est construit, pour qui et pourquoi maintenant.
- Périmètre. Ce que l'agence construit, rattaché à un numéro de version du périmètre, par exemple v1.2.
- Livrables. Une liste avec des identifiants (D1, D2 et ainsi de suite), chacun avec son jalon d'échéance.
- Hors périmètre. Les éléments nommés qui ne sont pas inclus, écrits en toutes lettres pour que personne n'ait à deviner.
- 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.
- Exigences. Une ligne par exigence, avec un identifiant (REQ-001), une priorité Doit, Devrait ou Pourrait, et une seule décision par ligne.
- 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".
- Calendrier et jalons. Une date pour chaque jalon (M1, M2 et ainsi de suite).
- Processus de modification. La manière dont une modification est demandée, qui décide et où elle est consignée.
- 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 :
| Client | Section supplémentaire | Pourquoi le client en a besoin |
|---|---|---|
| Kestrel Dental Group | Conformité et traitement des données | Les 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 Board | Annexe API | Leurs 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 Retail | Tableau de localisation | La 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 :
- 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.
- 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.
- 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. - 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 nomorrin-retail-catalogue-scope_v1.2.md, avec le même nom de base. - Ouvrez les trois fichiers et vérifiez que l'étiquette de version, la date et les identifiants REQ-004 et D5 concordent dans chacun.
- 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.
- Consignez l'envoi dans le registre des modifications : date, destinataires par rôle, noms des fichiers et date d'échéance de la validation.
- 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 :
| Changement | Date | Modification demandée | Demandé par | Approuvé par | Effet sur les livrables | Effet sur le calendrier | Résultat |
|---|---|---|---|---|---|---|---|
| CR-001 | 2026-09-22 | Ajouter une page de guide des tailles au modèle produit | Responsable marketing du client | Responsable produit du client et responsable de compte de l'agence | D3 gagne un type de page. Le périmètre passe en v1.1. | M2 passe du 2026-10-02 au 2026-10-09 | Approuvé |
| CR-002 | 2026-10-05 | Afficher les niveaux de stock en temps réel sur les pages produit | Responsable technique du client | Responsable produit du client et responsable de compte de l'agence | Aucun. Consigné comme hors périmètre en v1.1. | Aucun | Refusé. Elle nécessite son propre accord d'intégration. |
| CR-003 | 2026-10-14 | Remplacer D5, un guide PDF, par un fichier Markdown destiné aux ingénieurs du client | Responsable technique du client | Responsable produit du client et chef de projet de l'agence | Le format de D5 change. La même source s'exporte en Markdown, donc le travail lui-même ne change pas. | Aucun | Approuvé. 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
- Le fichier d'un projet terminé est réutilisé. Les anciens noms de clients et chiffres atteignent le client suivant. Solution : partez toujours du modèle enregistré.
- Les demandes sont convenues dans une discussion et jamais consignées. Solution : ajoutez une entrée au registre des modifications avant tout travail.
- Les exigences n'ont pas d'identifiants. Les commentaires de relecture visent "le deuxième point". Solution : donnez à chaque exigence un identifiant unique et citez-le dans les commentaires.
- Le hors périmètre est absent. Le client suppose ce qui a été laissé de côté. Solution : listez les trois éléments que le client est le plus susceptible de supposer inclus.
- Les critères d'acceptation sont des jugements. "Fonctionne bien" ne peut pas être testé. Solution : rédigez un résultat observable, comme un formulaire qui affiche les champs obligatoires.
- Les exports sont faits à la main. Le PDF et le fichier Word se désynchronisent. Solution : exportez chaque format depuis une seule source, le même jour.
- Le libellé de version est réutilisé ou absent. Personne ne sait quelle copie a été signée. Solution : augmentez la version à chaque modification approuvée et étiquetez les brouillons à part.
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.