Batcave Docs
Le parcours

/feature — créer une fonctionnalité

Donne un numéro et une ligne au portefeuille. Rien de plus, et c'est voulu.

/feature Permettre au client de télécharger sa facture en PDF

Quand l'utiliser

Dès qu'une idée mérite d'exister quelque part. Tu n'as pas besoin de savoir ce qu'elle contient : c'est justement le principe.

Noter une idée et la spécifier sont deux moments différents. La personne qui a l'idée n'est pas toujours celle qui a le temps de la préciser. /feature prend trente secondes et s'arrête là.

Ce qu'on te demande

Deux choses, et rien d'autre.

Le titre. C'est sous ce nom que tu la chercheras dans le portefeuille — mais aussi sous lequel elle apparaîtra ailleurs, sur d'autres fiches, sous la forme « Dépend de <ton titre> ».

Le test avant de valider : est-ce que « Dépend de <ton titre> » se comprend sans ouvrir la fiche ? Si non, réécris — ne rallonge pas. Un titre qui a besoin de son écran pour se comprendre en aura besoin partout ailleurs, et c'est ailleurs qu'il sera lu.

L'intention, en une phrase : ce que ça doit permettre, et pour qui. Elle est reprise mot pour mot, sans reformulation — c'est la matière première du cadrage à venir.

On peut aussi te demander à quel ensemble la rattacher. Si tu ne sais pas, la bonne réponse est « on verra ». Une fonctionnalité sans rattachement n'est pas perdue : elle attend dans le bac « à classer » du backlog, et c'est un état normal.

Ce que ça produit

Un numéro (F-014), une ligne au portefeuille en étape Idée, et une amorce de document dans le dépôt.

Cette amorce n'existe que sur ton poste tant que /dev n'a pas tourné. C'est lui qui la publiera avec le code.

Ce que ça ne fait pas

  • Aucun cadrage. Pas de critère, pas de cas limite, pas de hors-scope. La fonctionnalité naît nue, et c'est exactement ce qu'on veut : ne pas avoir pu cadrer n'est pas un échec, le maquiller en cadrage en est un.
  • Aucun changement d'étape. Elle reste en Idée.
  • Aucune publication.

Ensuite

/cadrage F-XXX quand tu veux la spécifier. La commande ne t'y emmène pas toute seule — c'est délibéré.