Démarrage rapide

Du besoin brut au dossier exportable.

Les 5 étapes

Étape 1Démarrer depuis l'Accueil

1. Écris ton besoin dans le grand champ.
2. Vérifie le modèle IA affiché (Claude Sonnet 5 par défaut).
3. Clique Générer le dossier complet.

→ Needl crée le projet et ouvre le cadrage.

L'ordre est imposé

Un onglet cliqué en avance affiche : « Génère d'abord les User Stories pour déverrouiller cette étape ».

Décrire ton besoin

Étape 1Saisir le besoin

1. Dis qui utilise : « les acheteurs B2B ».
2. Dis ce qu'il fait : « visualiser leurs commandes, télécharger leurs factures ».
3. Dis ce qui est exclu, si tu le sais déjà.
4. Clique Générer le dossier complet.

→ Le bouton s'active dès que le champ n'est plus vide.

Quoi écrire

Joindre un fichier au besoin

Quand le contexte existe déjà dans un document — compte rendu d'atelier, cahier des charges partiel, export d'un outil — joins-le plutôt que de le retaper. Needl s'en sert pour enrichir le cadrage.

Étape 2Joindre un fichier Optionnel

1. Clique Joindre fichier, à gauche sous le champ de saisie.
2. Choisis ton document. Il apparaît en pastille au-dessus du texte, avec son nom et son poids (ici spécification.pdf · 46 Ko).
3. Écris quand même une phrase dans le champ : « Je viens de te partager les spécifications de mon projet ». Le fichier complète, il ne remplace pas.
4. Clique Générer le dossier complet.

→ Le compteur sur Joindre fichier passe à 1. Le contenu du fichier entre dans le contexte du cadrage.

Pour retirer un fichier, clique la croix sur sa pastille.

Étape 3Laisser Needl créer le projet

1. Attends la fin de la barre (« Finalisation… »).
2. Ne recharge pas la page.

→ Tu arrives sur la fiche projet, onglet PRD, cadrage ouvert.

Choisir le modèle IA

Étape 1Ouvrir le sélecteur de modèle

1. Clique sur le nom du modèle affiché, sous le champ de saisie.
2. Choisis dans la liste Modèle IA.

→ Le nouveau modèle s'applique aux générations suivantes.

Changer en cours de projet

Le modèle est aussi affiché dans l'en-tête de la fiche projet, à droite du nom. Clique dessus pour en changer.

Le cadrage du besoin

4 questions maximum. C'est l'étape qui détermine la qualité de tout le dossier.

Étape 1Répondre à la première question

1. Lis la question, à gauche.
2. Réponds en une phrase dans le champ Votre réponse…, en bas.
3. Envoie avec la flèche.

→ Le compteur passe à 1/4 et la question suivante arrive.

Étape 2Enchaîner les questions suivantes

1. Sois catégorique : « Un seul type d'utilisateur : l'acheteur B2B. »
2. Dis ce qui est exclu : ça deviendra un item out-01 du périmètre.
3. Réponds court : Needl reformule ensuite.

→ Après la dernière question, l'écran de reformulation s'ouvre.

Ce qui reste incertain n'est pas inventé : Needl le range dans Ambiguïtés et Hypothèses du PRD.

Valider la reformulation

Dernier contrôle. Ce texte est la seule base du dossier.

Étape 1Relire, corriger, valider

1. Relis le texte, en particulier ce qui est exclu.
2. Corrige directement dans le cadre, ou écris ta demande dans Affiner la reformulation….
3. Clique Valider et générer le PRD.

→ La génération du PRD démarre (3 phases).

Suivre la génération

Étape 1Suivre les 3 phases

1. Laisse l'écran ouvert : les sections se déverrouillent toutes seules.
2. Suis les 3 phases : Besoins et personas → Périmètre et règles métier → Risques et incertitudes.
3. Pour interrompre : bouton Arrêter, en haut à droite.

→ À 100 %, les 8 sections du PRD s'affichent.

Le PRD

Étape 1Lire le PRD généré

1. Lis d'abord Ambiguïtés : c'est ce que le dossier ne sait pas encore.
2. Clique une carte pour ouvrir son détail.
3. Vérifie État : à jour en bas à gauche.

→ Les 8 cartes passent en ✓ Validé quand la section est complète.

Les 8 sections

Affiner une section, puis régénérer

Étape 2Affiner un item de section

1. Clique une carte, ou son nom dans le bloc Affinage central.
2. Repère les deux blocs : Dans le périmètre et Hors périmètre.
3. Clique Affiner à droite de l'item à retravailler.
4. Ferme la modale une fois tes affinages terminés.

→ L'item est retravaillé seul, sans toucher au reste du PRD.

Étape 3Régénérer le PRD pour intégrer les affinages

1. Reviens sur la vue Affinage.
2. Clique Régénérer le PRD, en bas à droite.
3. Attends les 3 phases, comme à la première génération.
4. Vérifie la nouvelle version dans les onglets v1 / v2.

→ Une version v2 est créée. La v1 reste consultable.

Retrouver le prompt initial

ÉcranPrompt initial

1. Clique Prompt initial dans l'en-tête.
2. Lis le contexte qui a servi à générer le PRD.

→ C'est ta reformulation validée, mot pour mot.

Exporter le rapport PRD

ÉcranMenu d'export du PRD

1. Reste sur l'onglet PRD.
2. Clique le bouton PRD (icône téléchargement), en haut à droite.
3. Télécharger en PDF — PRD uniquement, pour faire valider le cadrage.
4. Télécharger en Markdown — format texte .md, pour reprendre le contenu ailleurs.

→ Le fichier ne contient que le PRD, sans les autres artefacts.

Étape finaleRapport PRD ouvert

1. Ouvre le fichier téléchargé.
2. Contrôle l'en-tête : Product Requirements Document et le titre du système.
3. Parcours les 8 sections : chacune porte ses badges Enrichi par (H2, AMB-01…).
4. Transmets le fichier au sponsor pour validation du cadrage.

→ Le cadrage est partageable hors de Needl, en l'état validé.

User Stories

Étape 1Lire et filtrer les stories

1. Filtre avec Toutes / Générées (PRD) / Ajoutées manuellement.
2. Déplie une story pour voir ses critères d'acceptation.
3. Corrige avec le crayon, supprime avec la corbeille.
4. Traite en priorité les stories marquées ⚠ Mérite affinage : Needl signale qu'elles reposent sur une zone incertaine, avec sa source (Issue de : AMB-04).

→ Les critères d'acceptation deviennent les exigences à l'étape suivante.

Anatomie d'une story

Une story oubliée par la génération se rajoute à la main : voir Ajouter une user story.

Exporter le rapport User Stories

ÉcranMenu d'export des User Stories

1. Clique le bouton User Stories (icône téléchargement), à gauche de Régénérer les US.
2. Télécharger en PDF — User Stories uniquement.
3. Télécharger en Markdown — format texte .md, pratique pour alimenter un backlog.

→ C'est le format à donner à l'équipe de dev pour estimer.

Étape finaleRapport User Stories ouvert

1. Ouvre le fichier téléchargé.
2. Contrôle l'en-tête : User Stories et le compteur total (15 user stories).
3. Vérifie le regroupement par thème : Gestion des commandes, Opérations de terrain, Logistique…
4. Pour chaque story : identifiant, criticité, estimation, format En tant que…, critères d'acceptation et tags.
5. Repère les badges Mérite affinage et leur source Issue de : AMB-02 — ce sont les stories à trancher avant le développement.

→ Le backlog est partageable hors de Needl, prêt pour l'estimation en équipe.

Ajouter une user story

Quand le faire

Étape 1Ajouter des User Stories

1. Ouvre l'onglet User Stories, sous-onglet Ajoutées manuellement.
2. Clique + Ajouter des User Stories, en bas de la liste.
3. Décris le besoin en langage naturel, en une phrase dense. Exemple : « Notification du propriétaire après modération de son annonce : validation, refus avec motif obligatoire, demande de correction, et ressoumission de l'annonce corrigée sans repartir de zéro. »
4. Clique Générer, ou fais Ctrl + Entrée.

→ Needl peut produire plusieurs stories à partir d'une seule description.

Étape 2Vérifier dans « Ajoutées manuellement »

1. Les nouvelles stories portent un identifiant en US-A07 — le A les distingue des stories générées depuis le PRD.
2. Contrôle les compteurs des sous-onglets : Toutes = Générées (PRD) + Ajoutées manuellement.
3. Relis les critères d'acceptation et corrige au crayon si besoin.
4. Les renvois RG-01, RG-02… sous la story sont cliquables et mènent aux règles associées.

→ La story est prête à entrer dans la chaîne.

Étape 3Régénérer les US

1. Clique Régénérer les US, en haut à droite.
2. Contrôle les compteurs : Toutes = Générées (PRD) + Ajoutées manuellement. Tes ajouts sont toujours là.
3. Une nouvelle version v4 apparaît ; les précédentes restent consultables.
4. Le bandeau 4 User Stories ajoutées propose Générer les exigences — c'est le maillon suivant de la chaîne.
5. Si le bandeau User Stories modifié — le PRD impacté s'affiche en bas, clique Mettre à jour le PRD pour réaligner le cadrage.

→ Les stories ajoutées font maintenant partie du dossier généré, pas d'un ajout isolé.

Étape 4 — L'intégrer à la chaîne

Une story ajoutée n'a encore ni exigence ni cas de test. Sans cette étape, elle ne sera nulle part dans la traçabilité.

1. Va sur l'onglet Exigences → Régénérer les EXG.
2. Va sur l'onglet Cas de test → Régénérer les CT.
3. Ouvre la Traçabilité et vérifie que ta story apparaît dans la colonne de gauche avec sa chaîne complète.

Bien écrire ta description

Les critères d'acceptation générés ne seront jamais plus précis que ta description. Un texte vague donne une story vague, puis une exigence vague, puis un cas de test inutilisable.

Exigences

Étape 1Lire une exigence et sa filiation

1. Commence par les onglets Sécurité et RGPD/Légal : ce sont les plus souvent oubliés.
2. Déplie une exigence pour voir ses règles métier.
3. Vérifie la ligne Dérivée de US-01 · Critère 1 — clique le badge pour remonter à la story.
4. Regarde le bloc Cas de test liés en bas.
5. Modifie l'exigence avec l'icône crayon, à droite de son titre : reformule l'énoncé ou corrige une règle métier.

→ Une exigence sans cas de test lié apparaîtra « Non couvert » en Traçabilité.

Après une modification manuelle

Régénère les Cas de test pour que les tests collent à la nouvelle formulation. Sinon ils vérifient encore l'ancienne règle.

Les 5 types

Trois filtres cumulables : type, criticité, user story. Tout replier ramène la liste aux titres.

Exporter le rapport Exigences

ÉcranMenu d'export des Exigences

1. Clique le bouton Exigences (icône téléchargement), à gauche de Régénérer les EXG.
2. Télécharger en PDF — Exigences uniquement.
3. Télécharger en Markdown — format texte .md.

→ Chaque exigence part avec ses règles métier et ses cas de test liés.

Étape finaleRapport Exigences ouvert

1. Ouvre le fichier téléchargé.
2. Contrôle l'en-tête : Exigences et le compteur total.
3. Pour chaque exigence : identifiant EXG-001, type, criticité, énoncé et règles métier.
4. Vérifie la filiation Dérivée de US-01 et Source US-01 · Critère 1 — c'est la preuve que rien n'est inventé.
5. Sous chaque exigence, le bloc Cas de test liés détaille préconditions, étapes, résultat attendu et jeu de données.

→ C'est le contrat technique complet : exigence, règle, test et données, en un seul document.

Cas de test

Étape 1Vérifier la couverture par exigence

1. Garde Groupé par EXG pour voir la couverture exigence par exigence.
2. Lis le décompte à droite : 2 Nominal 1 Erreur.
3. Une exigence sans bloc = aucun test. Régénère les CT.

→ Clique un cas pour ouvrir son détail.

Étape 2Modifier un cas de test

1. Déplie le cas pour afficher son détail complet.
2. Clique l'icône crayon, en haut à droite du cas.
3. Corrige ce qui doit l'être : préconditions (l'état de départ), étapes (les actions et leurs valeurs), résultat attendu, jeu de données.
4. Enregistre.

→ Un cas modifié à la main reste modifié, jusqu'à la prochaine régénération.

Les types de cas

Un cas peut porter en plus un marqueur d'origine :

• AMB — issu d'une zone ambiguë du PRD.
• HYP — issu d'une hypothèse non confirmée.

Exporter le rapport Cas de test

ÉcranMenu d'export des Cas de test

1. Clique le bouton Cas de test (icône téléchargement), à gauche de Régénérer les CT.
2. Télécharger en PDF — Cas de test uniquement, c'est le livrable de la QA.
3. Télécharger en Markdown — format texte .md.

→ Exporte avant de régénérer : la régénération écrase tes corrections manuelles.

Étape finaleRapport Cas de test ouvert

1. Ouvre le fichier téléchargé.
2. Contrôle l'en-tête : Cas de Test et le compteur total.
3. Les cas restent groupés par exigence : badges EXG-001 · US-01, décompte 2 Nominal 1 Erreur et total 3 cas.
4. Chaque cas est exécutable tel quel : préconditions, étapes numérotées avec leurs valeurs, résultat attendu et jeu de données.
5. Repère les scénarios E2E : ils traversent plusieurs rôles (Assistant → Contrôleur → Livreur → Facturation) et valident la chaîne complète.

→ C'est le cahier de recette à donner au testeur : aucune information à chercher ailleurs.

Traçabilité

Vue Colonnes Par défaut

Étape 1Explorer une chaîne US → EXG → CT

1. Balaie la colonne du milieu et repère les ⚠ Non couvert.
2. Clique une User Story à gauche pour filtrer sa chaîne.
3. Vérifie à droite ce que chaque test couvre : Vérifie : EXG-001.

→ Zéro « Non couvert » = dossier complet.

Vue Détail

Une user story à la fois, avec toute sa chaîne dépliée sur trois panneaux. C'est la vue d'instruction : celle qui sert à comprendre pourquoi un test existe.

Étape 2Basculer en vue Détail

1. Clique Détail dans la barre de vues, en haut à droite.
2. Choisis une story dans la colonne de gauche : chacune affiche ses compteurs 3 EXG 4 CT.
3. Bascule sur le filtre ⚠ Lacunes (6) pour n'afficher que les stories incomplètes.
4. Au centre, lis la story et ses critères d'acceptation, puis le bloc Exigences liées.
5. Clique une exigence : le panneau de droite affiche ses règles métier et ses cas de test complets (préconditions, étapes, résultat attendu).
6. Lis l'entête du panneau : 3 cas de test — dont 2 couvrent plusieurs EXG. Un cas marqué Vérifie plusieurs exigences compte pour chacune.
7. Clique Voir tout pour revenir à la liste entière.

→ L'en-tête résume la sélection : « US-04 — 3 exigences · 4 cas de test ».

Vue Matrice

La matrice de traçabilité ISTQB : les exigences en lignes, les cas de test en colonnes, une coche à chaque croisement couvert. C'est le format attendu en audit.

Étape 3Basculer en vue Matrice

1. Clique Matrice dans la barre de vues.
2. Lis le compteur d'alerte en haut à droite : ⚠ 31 EXG non couvertes — à rapprocher des 46 EXG et 12 CT.
3. Repère les lignes vides : elles portent le badge ⚠ Lacune et un 0 dans la colonne CT de droite.
4. Filtre avec Toutes les US et Tous les types pour isoler un périmètre.
5. Lis la couleur des coches : elle donne le type du cas de test.

→ Chaque colonne porte son identifiant CT-001 et la story d'origine US-01.

La légende rappelle les 4 types de cas : Nominal cas standard, Erreur cas invalide, Limite valeur frontière, Performance.

Corriger une « Lacune »

Deux mots pour la même chose : l'application affiche ⚠ Lacune, le rapport exporté écrit « Non couvert par aucun cas de test ».

1. Note l'identifiant de l'exigence (ex. EXG-002).
2. Va sur l'onglet Cas de test → Régénérer les CT.
3. Reviens en Traçabilité : le badge doit avoir disparu.
4. S'il persiste, l'exigence est trop vague : affine-la dans les Exigences.

Le badge multi-EXG signale un test qui couvre plusieurs exigences — souvent un scénario de bout en bout.

Exporter le rapport Traçabilité

Cet export ne fonctionne pas comme les autres : il propose trois sorties, dont un lot ciblé sur une seule user story.

ÉcranMenu Exporter la traçabilité

1. Clique Exporter la traçabilité, en haut à droite (bouton vert).
2. Rapport complet — PDF : toutes les US · EXG · CT, plus la matrice ISTQB.
3. Lot d'une User Story — PDF : la chaîne d'une seule story.
4. Rapport complet — Markdown : chaînes et matrice au format .md.

→ Le rapport complet PDF est le document d'audit : il contient la matrice ISTQB.

Étape finaleRapport traçabilité ouvert

1. Ouvre le fichier téléchargé.
2. Contrôle l'en-tête : Chaînes de traçabilité et le nombre de User Stories analysées.
3. Chaque story ouvre un bloc avec ses compteurs 3 EXG 4 CT, puis l'arborescence US → EXG → CT.
4. Traque les lignes rouges « Non couvert par aucun cas de test » : ce sont les trous de recette, exigence par exigence.
5. La matrice ISTQB suit les chaînes dans le même PDF — c'est elle que demande un auditeur.

→ Un dossier prêt pour l'audit : chaque exigence est soit couverte, soit explicitement signalée comme trou.

Exporter le lot d'une seule User Story

Le rapport complet fait des dizaines de pages. Le lot n'en fait qu'une : la chaîne d'une story et sa mini-matrice. C'est ce qu'on envoie à un dev ou à un testeur pour un ticket précis.

ÉcranMenu Exporter Lot d'une User Story

1. Reste en vue Colonnes et clique la story voulue à gauche : l'en-tête affiche « US-01 — 3 exigences · 4 cas de test ».
2. Clique Exporter la traçabilité. Le menu compte maintenant 4 options au lieu de 3.
3. Lot US-01 — PDF — chaîne complète de cette User Story uniquement.
4. Lot US-01 — Markdown — la même chaîne en .md.

→ Le nom de l'option porte l'identifiant réel de la story : aucun risque d'exporter la mauvaise.

RésultatRapport Lot d'une User Story ouvert

1. Ouvre le fichier téléchargé : il tient sur une page.
2. À gauche, Chaînes de traçabilité — 1 User Stories analysées : l'arborescence US-01 → EXG-001…003 → CT-001…012.
3. Les trous restent visibles : EXG-002 porte « Non couvert par aucun cas de test ».
4. À droite, la matrice ISTQB réduite au périmètre : 3 EXG x 4 CT, avec la légende N Nominal, E Erreur, L Limite.

→ Une page auto-portante par story : la pièce jointe idéale d'un ticket.

Mes projets

Étape 1Retrouver un projet

1. Filtre par statut : Tous / Actif / Partagé / Archivé.
2. Lis la colonne Artefacts : PRD · US · EXG · CT indiquent l'avancement.
3. Bascule liste / grille avec les icônes à droite.
4. Clique un projet pour l'ouvrir.

→ Un projet sans badge US n'a pas dépassé le PRD.

Étape 2Agir sur un projet

1. Clique le menu … à droite de la ligne.
2. Renommer : le nom automatique est rarement le bon.
3. Partager ou Archiver : bascule le statut.
4. Supprimer : définitif, affiché en rouge.

→ Le statut se change aussi depuis l'en-tête de la fiche projet.

Partager et laisser dupliquer

La duplication ne se déclenche pas depuis ton compte : elle s'autorise. Tu partages un lien, et c'est le destinataire qui crée sa propre copie, sous son compte, pour travailler sans toucher à ton projet.

Étape 1Ouvrir le partage et choisir la permission

1. Ouvre le projet, puis clique Partager (menu … de la liste, ou badge de statut dans l'en-tête).
2. Choisis la permission dans la modale Partager le projet.
3. Clique Copier à droite du lien de partage.
4. Envoie le lien à la personne concernée.

→ Le statut du projet passe à Partagé.

Les deux permissions

Étape 2 — Côté destinataire

1. Il ouvre le lien needl.qalilab.com/shared/… dans son navigateur, connecté à son compte.
2. Il crée sa copie depuis la vue partagée.
3. La copie apparaît dans ses projets, avec le suffixe (copie).

Couper le partage

Dans la même modale, Désactiver le partage → bouton Révoquer. Le lien cesse de fonctionner.

Recherche d'un projet

La barre de recherche est dans la barre du haut, présente sur toutes les pages. Tu n'as pas besoin d'aller sur Mes projets pour chercher.

Étape 1Rechercher depuis n'importe quelle page

1. Clique la barre Rechercher un projet…, en haut à droite.
2. Tape un mot du nom du projet — ici Sonnet.
3. Lis les cartes de résultat : compteurs PRD · US · EXG · CT, statut et date.
4. Clique la carte pour ouvrir le projet, ou le menu … pour agir dessus.

→ Sur l'Accueil, Projets récents laisse place à Résultats de recherche avec leur nombre.

Pour revenir à l'affichage normal, vide le champ avec la croix.

Versions et régénération

Étape 1Comparer deux versions

1. Clique v1, v2… en haut du panneau.
2. Lis le bandeau Origine : il dit ce qui a déclenché l'enrichissement (ici les décisions AMB-01 à AMB-03).

→ Les onglets de version existent sur le PRD et les User Stories.

Quand régénérer

Exporter

Étape 1Exporter le rapport complet

1. Clique Rapport complet, en haut à droite de la fiche projet.
2. Choisis PDF pour envoyer au client.
3. Choisis Markdown pour reprendre le contenu ailleurs (Notion, Confluence, Git).

→ Le fichier contient les 5 artefacts.

Étape 2Rapport complet ouvert

1. Ouvre le fichier téléchargé.
2. Le document enchaîne les 5 artefacts dans l'ordre de la chaîne : PRD → US → EXG → CT → Traçabilité.
3. Chaque section du PRD garde ses badges Enrichi par (H2, AMB-01…) : la provenance de l'information reste lisible.
4. La matrice ISTQB ferme le document — c'est la partie qu'un auditeur ouvre en premier.

→ C'est le livrable client : un seul fichier, aucune dépendance à Needl.

Les 5 rapports disponibles

Tous les onglets proposent PDF et Markdown. Seule la traçabilité ajoute une troisième sortie, le lot ciblé sur une story — voir Traçabilité.

Identifiants et badges

Tout ce que tu croises dans l'interface, en une page.

Identifiants

Badges

Navigation

Dépannage

Repère ton symptôme, lis la cause, applique la solution.

Limites connues

Ce que Needl ne fait pas — pour ne pas le chercher.

Ce que Needl ne fait pas

Captures encore à fournir

Les emplacements en pointillés dans cette documentation attendent ces écrans :

Sur cette documentation

Elle décrit Needl tel qu'observé dans l'application (needl.qalilab.com) et illustré par les 42 captures de ce document.