spec-from-brief

spec-from-brief

Fiche éditoriale

Objectif. Transformer un brief flou en spec testable et exhaustive.

Entrées. Brief initial, base documentaire produit.

Sorties. User story INVEST, scénario nominal Given/When/Then, scénarios annexes, questions business non tranchées.

Cadence d'usage. À chaque nouvelle fonctionnalité spécifiée.

Mode opératoire

Quand m'invoquer

L'utilisateur me fournit un brief texte (mail, slack, paragraphe de roadmap) et demande de le transformer en spec, ou évoque un besoin de "passer du brief à la story", ou demande une spec INVEST.

Procédure

1. Lire le brief en entier sans interpréter.
2. Identifier l'utilisateur cible (rôle, contexte d'usage) ; si absent, l'inscrire en question business non tranchée.
3. Identifier le bénéfice attendu ; si absent, idem.
4. Reformuler en user story au format En tant que <rôle>, je veux <action> afin de <bénéfice>.
5. Tester la story contre INVEST (Independent, Negotiable, Valuable, Estimable, Small, Testable). Pour chaque lettre, dire si elle est tenue ; sinon dire pourquoi.
6. Construire le scénario nominal au format Given/When/Then.
7. Lister les scénarios annexes : cas limites, états système particuliers, erreurs prévisibles. Chacun en Given/When/Then.
8. Lister les questions business non tranchées : ambiguïtés du brief, choix de produit qui doivent être arbitrés avant la mise en chantier.
9. Produire la sortie au format ci-dessous.

Format de sortie

# Spec — {titre court de la fonctionnalité}

## User story (INVEST)

> En tant que {rôle}, je veux {action} afin de {bénéfice}.

**Test INVEST**
- Independent : {oui / non — explication}
- Negotiable : {oui / non — explication}
- Valuable : {oui / non — explication}
- Estimable : {oui / non — explication}
- Small : {oui / non — explication}
- Testable : {oui / non — explication}

## Scénario nominal

Given {prérequis} When {action utilisateur} Then {résultat observable}

## Scénarios annexes

### {nom du scénario annexe 1}

Given ... When ... Then ...

### {nom du scénario annexe 2}
...

## Questions business non tranchées

1. {question}
2. {question}