Requirements Document
A precise, testable specification of functional and non-functional requirements, each a single verifiable statement with a stable ID, plus acceptance criteria, constraints and scope..
Ce qu'est un Cahier des Charges
Un Cahier des Charges est le contrat entre l'intention et la construction. Il énonce, en phrases vérifiables uniques, ce qu'un système doit faire et les qualités qu'il doit atteindre, si bien que designers, ingénieurs et parties prenantes travaillent à partir d'une même définition partagée plutôt que d'une conversation de couloir.
Chaque exigence porte un identifiant stable et est testable par elle-même. Cette structure permet aux critères d'acceptation de s'attacher à des lignes précises, permet aux relecteurs de valider une liste connue, et empêche le périmètre de dériver une fois le travail commencé.
Bien fait, il est court à lire mais précis à mettre en œuvre. Il sépare le comportement fonctionnel des qualités non fonctionnelles comme la performance et la sécurité, consigne les hypothèses et contraintes, et nomme ce qui est délibérément hors périmètre.
L'anatomie d'un Cahier des Charges
Vue d'ensemble et objectifs
Énoncez pourquoi le système existe et à quoi ressemble le succès. Cela cadre chaque exigence qui suit et donne aux relecteurs l'objectif auquel se référer.
Périmètre et contexte
Définissez la limite, les utilisateurs et les systèmes concernés. S'accorder sur le contexte ici évite des disputes ultérieures sur ce qui était réellement en jeu.
Exigences fonctionnelles
Listez ce que le système doit faire, chacune comme un énoncé vérifiable unique avec un identifiant stable. Ce sont des comportements qu'un testeur peut confirmer ou rejeter sans débat.
Exigences non fonctionnelles
Capturez des qualités comme la performance, la sécurité, la fiabilité et la disponibilité. Écrivez-les comme des seuils mesurables pour qu'elles puissent être testées plutôt que supposées.
Critères d'acceptation
Précisez exactement comment chaque exigence est vérifiée et ce qui compte comme terminé. C'est la ligne entre une fonctionnalité achevée et une dispute permanente.
Hypothèses et contraintes
Consignez ce dont dépend la spécification et les limites qu'elle doit respecter, comme les plateformes, les budgets ou les délais. Faire remonter cela tôt évite que cela devienne des surprises.
Hors périmètre
Nommez délibérément ce que ce système ne fera pas. Une liste d'exclusions explicite est la défense la moins coûteuse que vous puissiez écrire contre la dérive de périmètre.
Rédiger des exigences qui tiennent la route
Do
- Rédigez chaque exigence comme un énoncé vérifiable unique avec un identifiant stable pour qu'elle puisse être tracée et testée.
- Séparez le comportement fonctionnel des qualités non fonctionnelles comme la performance, la sécurité et la fiabilité.
- Attachez des critères d'acceptation à chaque exigence pour que tout le monde s'accorde sur ce que « terminé » signifie.
- Énoncez ouvertement les hypothèses et contraintes pour que les dépendances apparaissent avant la construction, pas pendant.
- Gardez une liste hors périmètre explicite pour couper court à la dérive de périmètre avant que le travail ne commence.
Avoid
- Ne regroupez pas plusieurs comportements dans une seule exigence, car un test partiellement réussi n'a nulle part où se rattacher.
- N'écrivez pas d'objectifs non fonctionnels vagues comme « rapide » sans seuil mesurable à vérifier.
- Ne réutilisez ni ne mélangez les identifiants, car une cible mouvante casse la traçabilité et la validation.
- Ne laissez pas les critères d'acceptation implicites, sinon « terminé » devient une question d'opinion.
- N'omettez pas la section hors périmètre en supposant que tout le monde partage la même limite.
L'ancienne méthode face à la méthode waxTable
Comment Waxe génère votre Cahier des Charges
- 1
Décrivez le système
Dites à Waxe à quoi sert le système, qui l'utilise et quel problème il résout. Waxe en fait la vue d'ensemble et les objectifs, fixant le but auquel chaque exigence sera jugée.
- 2
Fixez la limite
Waxe rédige le périmètre et le contexte, nommant les utilisateurs et systèmes concernés et où se situent les limites. Elle rédige aussi la liste hors périmètre pour que la limite soit explicite avant que quiconque ne commence à construire.
- 3
Rédigez les exigences
Waxe rédige les exigences fonctionnelles et non fonctionnelles comme des énoncés vérifiables uniques, chacun avec un identifiant stable. Le comportement fonctionnel et les qualités comme la performance et la sécurité atterrissent dans leurs propres sections, prêtes à tester.
- 4
Attachez les critères d'acceptation
Pour chaque exigence, Waxe rédige des critères d'acceptation qui définissent exactement comment elle est vérifiée et ce qui compte comme terminé. Elle consigne aussi les hypothèses et contraintes dont dépend la spécification, pour que les dépendances soient sur la page.
- 5
Relisez et partagez
Vous modifiez toute ligne directement dans l'espace de travail, ajustant exigences, critères ou périmètre selon les besoins. La numérotation et la structure restent intactes, et vous partagez un Cahier des Charges propre et à votre marque en environ cinq minutes pour quelques centimes.
Frequently asked
Qu'est-ce qu'un Cahier des Charges ?
Un Cahier des Charges est une spécification précise et testable de ce qu'un système doit faire et à quel niveau de qualité. Chaque exigence fonctionnelle et non fonctionnelle est rédigée comme un énoncé vérifiable unique portant un identifiant stable, si bien qu'elle peut être tracée, testée et validée. Il capture aussi les critères d'acceptation, les hypothèses, les contraintes et une liste explicite de ce qui est hors périmètre. L'objectif est de ne rien laisser à l'interprétation entre ceux qui écrivent la spécification et ceux qui construisent en s'appuyant dessus.
Que contient un bon Cahier des Charges ?
Il s'ouvre sur une vue d'ensemble et des objectifs, puis fixe le périmètre et le contexte pour que tout le monde s'accorde sur la limite. Le corps sépare les exigences fonctionnelles des exigences non fonctionnelles telles que la performance, la sécurité et la fiabilité. Les critères d'acceptation définissent exactement comment chaque exigence est vérifiée, et les hypothèses et contraintes consignent ce dont dépend la spécification. Une section hors périmètre claire ferme la porte à la dérive de périmètre avant même que la construction ne commence.
Pourquoi attribuer un identifiant stable à chaque exigence ?
Un identifiant stable transforme une ligne de texte en quelque chose que l'on peut désigner pendant toute la durée du projet. Il permet à un test de référencer exactement l'exigence qu'il vérifie, à une demande de changement de nommer ce qu'elle modifie, et à une validation de couvrir une liste connue. Sans identifiants, les relecteurs se disputent sur la phrase qu'ils voulaient dire et l'acceptation devient une devinette. waxTable attribue et maintient ces identifiants cohérents entre les sections fonctionnelles et non fonctionnelles, pour que la traçabilité tienne de l'objectif jusqu'au critère d'acceptation.
Comment waxTable construit-il le document pour mon projet ?
Vous indiquez à Waxe à quoi sert le système et à qui il s'adresse, et Waxe rédige un Cahier des Charges complet avec vue d'ensemble, périmètre, exigences numérotées et critères d'acceptation. Il sépare le comportement fonctionnel des qualités non fonctionnelles et rédige chaque exigence comme un énoncé vérifiable unique. Les hypothèses, contraintes et une liste hors périmètre sont renseignées pour que la limite soit explicite. Le projet complet prend environ cinq minutes et coûte quelques centimes, puis vous modifiez toute ligne directement dans l'espace de travail.
Puis-je modifier les exigences après leur génération par Waxe ?
Oui. Le Cahier des Charges généré est entièrement modifiable dans l'espace de travail waxTable, pas un export verrouillé. Vous pouvez réécrire toute exigence, ajouter ou retirer des critères d'acceptation, ajuster la limite du périmètre, ou déplacer un élément vers la section hors périmètre. Les modifications gardent la structure et le style du document intacts, si bien que la numérotation et l'ordre des sections restent nets. Une fois la spécification prête, vous la partagez comme un document soigné et à votre marque.
Skip the writing — generate the whole requirements document
Waxe drafts it on your brand in about five minutes, then you refine it. From two days of work to a few cents.
Votre prochain cahier des charges, en cinq minutes
Parlez de votre client à Waxe et obtenez un cahier des charges complet, à votre image, prêt à relire — le travail de deux jours pour quelques centimes. Pas de page blanche, rien à mettre en forme à la main : vous répondez à un court brief, Waxe rédige, et vous gardez le contrôle total du document final dans l'éditeur.