---
title: "Assistant IA de clarification de backlog — Documentation Fonctionnelle"
module: ai
type: functional
status: active
updated: 2026-08-07
---

# Assistant IA de clarification de backlog — Documentation Fonctionnelle

> Reformule un élément de backlog existant en contexte détaillé et pose les questions nécessaires (accès, droits, forme visuelle, champs...) jusqu'à ce qu'il ne reste plus de zone d'ombre.

---

## À quoi ça sert

De nombreux éléments de backlog CRM v2 ont été générés en masse depuis un cahier des charges via
la moulinette IA (voir [Génération de backlog par IA](backlog-ai-generation.md)). Le résultat est
cohérent mais reste souvent trop court pour être développé sans échanges complémentaires : il
manque les précisions opérationnelles (par où y accéder, qui a le droit de le voir, à quoi ça doit
ressembler, quels champs afficher...).

L'assistant de clarification permet, directement depuis un backlog existant, de faire dialoguer
l'IA avec l'utilisateur pour obtenir ces précisions, sans jamais modifier la description initiale.

## Comment ça marche (côté utilisateur)

Dans la modal d'édition d'un backlog, un nouvel onglet **Assistant IA** est disponible à côté de
Formulaire / Sous-tâches / Tickets.

1. **Génération initiale** : le bouton *Générer le contexte IA* lance une première analyse. L'IA
   produit un contexte enrichi (reformulation du besoin) et, si nécessaire, une liste de questions
   précises (accès, droits, forme visuelle, champs, comportements limites...).
2. **Réponse aux questions** : chaque question ouverte a son propre champ de réponse. **Aucune
   réponse n'est obligatoire** : laisser un champ vide revient à *ignorer* la question — elle est
   alors marquée comme telle et **ne sera plus jamais reposée**, même dans un round ultérieur.
   Répondre à certaines questions et en ignorer d'autres dans le même envoi est possible.
3. **Régénération** : le bouton *Envoyer mes réponses et régénérer* transmet les réponses (et les
   questions ignorées) à l'IA, qui produit une nouvelle version du contexte en tenant compte de tout
   l'historique, et pose de nouvelles questions si besoin. L'IA sait qu'une question ignorée ne doit
   pas être reformulée pour être reposée : elle raisonne avec l'information manquante.
4. **Application dans la description** : deux boutons, disponibles **à tout moment** dès qu'un
   contexte existe (y compris avec des questions encore ouvertes), évitent tout copier-coller :
   - *Ajouter à la description* — ajoute le contexte à la suite du texte existant ;
   - *Remplacer la description* — écrase la description par le contexte (confirmation demandée).

   Dans les deux cas la description est **enregistrée immédiatement** — aucun clic sur *Enregistrer*
   n'est nécessaire — et le champ Description de l'onglet *Formulaire* est mis à jour en même temps.
5. **Fin de clarification** : quand l'IA n'a plus de question à poser, un message confirme que le
   backlog est clarifié. Un bouton *Relancer une clarification* reste disponible dès qu'aucune
   question n'est en attente — que le backlog soit marqué clarifié (la description a pu être
   modifiée entre-temps) ou qu'un appel IA ait échoué en cours de route.

Le badge sur l'onglet indique le nombre de questions actuellement en attente de traitement (ni
répondues, ni ignorées).

## Règles d'accès

L'onglet est visible pour tout utilisateur ayant accès à la modal d'édition du backlog, à
condition que le tenant dispose du module IA (`canUseIa()` — même règle que les autres assistants
IA du projet, ex. l'éditeur enrichi). L'accès est en outre limité aux backlogs de votre propre
entité : un backlog appartenant à une autre entité est refusé (403), même en forçant son
identifiant.

## Points d'attention

- Le contexte généré est stocké à part (`txai_context`). L'IA ne modifie jamais la description
  d'elle-même : seule une action explicite (*Ajouter* / *Remplacer*) la change. Le contexte reste
  consultable dans l'onglet après application.
- *Remplacer la description* est **irréversible** (écriture immédiate, pas d'annulation dans
  l'écran) — d'où la confirmation. *Ajouter à la description* est non destructif et n'en demande pas.
- L'historique complet des questions/réponses de chaque round est conservé (traçabilité), même
  après que le round soit résolu — y compris les questions ignorées, distinguées des questions
  répondues.
- Une question ignorée l'est définitivement : il n'existe pas d'action pour « rouvrir » une question
  ignorée. Si l'information devient nécessaire, relancer une clarification (bouton *Relancer une
  clarification*) produit un nouveau round, mais l'IA a pour consigne de ne pas reposer ce qui a été
  ignoré.
- Chaque appel à l'IA est facturé/journalisé comme les autres assistants IA du projet et apparaît
  dans le dashboard admin IA.

## Voir aussi

- [Génération de backlog par IA](backlog-ai-generation.md)
- Doc technique : `.claude/technical-docs/ai/backlog-ai-clarification.md`