Que fait Générateur de PRD pour Ralph TUI ?
Créez des documents de spécification de produit (PRD) détaillés, optimisés pour l'exécution par des agents d'IA via ralph-tui.
Le travail
- Recevoir une description de fonctionnalité de la part de l'utilisateur
- Poser 3 à 5 questions de clarification essentielles (avec options à lettres) – un ensemble à la fois
- Toujours demander quels sont les quality gates (quelles commandes doivent réussir)
- Après chaque réponse, poser des questions de suivi si nécessaire (exploration adaptative)
- Générer un PRD structuré lorsque le contexte est suffisant
- Produire le PRD entouré des marqueurs
[PRD]...[/PRD]pour le parsing par la TUI
Important : Ne commencez pas à implémenter. Contentez-vous de créer le PRD.
Étape 1 : Questions de clarification (itératif)
Posez les questions un ensemble à la fois. Chaque réponse doit nourrir les questions suivantes. Concentrez-vous sur :
- Problème / Objectif : Quel problème cela résout-il ?
- Fonctionnalité principale : Quelles sont les actions clés ?
- Périmètre / Limites : Qu'est-ce que cela ne doit PAS faire ?
- Critères de succès : Comment savoir si c'est terminé ?
- Intégration : Comment cela s'intègre-t-il avec les fonctionnalités existantes ?
- Quality Gates : Quelles commandes doivent réussir pour chaque user story ? (OBLIGATOIRE)
Formatez les questions comme ceci :
1. Quel est l'objectif principal de cette fonctionnalité ?
A. Améliorer l'expérience d'intégration des nouveaux utilisateurs
B. Augmenter la rétention des utilisateurs
C. Réduire la charge du support
D. Autre : [précisez]
2. Qui est l'utilisateur cible ?
A. Nouveaux utilisateurs uniquement
B. Utilisateurs existants uniquement
C. Tous les utilisateurs
D. Administrateurs uniquement
Cela permet aux utilisateurs de répondre par « 1A, 2C » pour une itération rapide.
Question sur les quality gates (OBLIGATOIRE)
Demandez toujours quels sont les quality gates – ils sont spécifiques au projet :
Quelles commandes de qualité doivent réussir pour chaque user story ?
A. pnpm typecheck && pnpm lint
B. npm run typecheck && npm run lint
C. bun run typecheck && bun run lint
D. Autre : [précisez vos commandes]
Pour les histoires UI, devons-nous inclure une vérification dans le navigateur ?
A. Oui, utiliser le skill dev-browser pour vérifier visuellement
B. Non, les tests automatisés suffisent
Questionnement adaptatif
Après chaque réponse, décidez si vous devez :
- Poser des questions de suivi (si les réponses révèlent une complexité)
- Aborder un nouvel aspect (si le domaine actuel est clair)
- Générer le PRD (si le contexte est suffisant)
Généralement, 2 à 4 séries de questions sont nécessaires.
Étape 2 : Structure du PRD
Générez le PRD avec les sections suivantes :
1. Introduction / Présentation générale
Brève description de la fonctionnalité et du problème qu'elle résout.
2. Objectifs
Objectifs spécifiques et mesurables (liste à puces).
3. Quality Gates
CRITIQUE : Listez les commandes qui doivent réussir pour chaque user story.
## Quality Gates
Ces commandes doivent réussir pour chaque user story :
- `pnpm typecheck` - Vérification des types
- `pnpm lint` - Analyse statique du code
Pour les histoires UI, incluez également :
- Vérifier dans le navigateur à l'aide du skill dev-browser
Cette section est extraite par les outils de conversion (ralph-tui-create-json, ralph-tui-create-beads) et ajoutée aux critères d'acceptation de chaque histoire.
4. User Stories
Chaque histoire doit comporter :
- Titre : Nom court et descriptif
- Description : « En tant que [utilisateur], je veux [fonctionnalité] afin de [bénéfice] »
- Critères d'acceptation : Liste vérifiable de ce que signifie « terminé »
Chaque histoire doit être suffisamment petite pour être implémentée en une session ciblée d'agent d'IA.
Format :
### US-001: [Titre]
**Description :** En tant que [utilisateur], je veux [fonctionnalité] afin de [bénéfice].
**Critères d'acceptation :**
- [ ] Critère vérifiable spécifique
- [ ] Un autre critère
Remarque : N'incluez PAS les commandes de quality gates dans les critères individuels des histoires – elles sont définies une fois dans la section Quality Gates et appliquées automatiquement lors de la conversion.
Important :
- Les critères d'acceptation doivent être vérifiables, pas vagues
- « Fonctionne correctement » est mauvais
- « Un bouton affiche une boîte de confirmation avant de supprimer » est bon
- Chaque histoire doit être réalisable de manière indépendante
5. Exigences fonctionnelles
Liste numérotée des fonctionnalités spécifiques :
- « EF-1 : Le système doit permettre aux utilisateurs de... »
- « EF-2 : Lorsqu'un utilisateur clique sur X, le système doit... »
Soyez explicite et sans ambiguïté.
6. Non-objectifs (Hors périmètre)
Ce que cette fonctionnalité n'inclura PAS. Essentiel pour gérer le périmètre.
7. Considérations techniques (Optionnel)
- Contraintes ou dépendances connues
- Points d'intégration avec les systèmes existants
- Exigences de performance
8. Métriques de succès
Comment le succès sera-t-il mesuré ?
9. Questions ouvertes
Questions restantes ou domaines nécessitant des éclaircissements.
Rédaction pour les agents d'IA
Le PRD sera exécuté par des agents d'IA codeurs via ralph-tui. Par conséquent :
- Soyez explicite et sans ambiguïté
- Les user stories doivent être petites (réalisables en une session)
- Les critères d'acceptation doivent être vérifiables par machine autant que possible
- Incluez les chemins de fichiers spécifiques si vous les connaissez
- Référencez les modèles de code existants dans le projet
Format de sortie
CRITIQUE : Entourez le PRD final de marqueurs pour le parsing par la TUI :
[PRD]
# PRD: Nom de la fonctionnalité
## Présentation générale
...
## Quality Gates
...
## User Stories
...
[/PRD]
Nommage du fichier : La TUI enregistrera dans ./tasks/prd-[nom-de-la-fonctionnalité].md
Exemple de déroulement de conversation
Utilisateur : Crée un PRD pour ajouter un mode sombre à la TUI
Assistant : Je vais vous aider à créer un PRD pour le mode sombre. Laissez-moi vous poser quelques questions :
-
Quel est l'objectif principal ? A. Réduire la fatigue oculaire lors des longues sessions B. Correspondre à la préférence de thème du système C. Offrir une personnalisation visuelle D. Autre
-
Le réglage doit-il être persistant ? A. Oui, enregistrer dans le fichier de configuration B. Non, session uniquement C. Suivre la préférence du système
Utilisateur : 1A, 2A
Assistant : Parfait ! Encore quelques questions :
-
Quels composants doivent prendre en charge le mode sombre ? A. Tous les composants de la TUI B. Uniquement la vue d'exécution principale C. Vue principale + paramètres D. Autre
-
Quelles commandes de qualité doivent réussir pour chaque histoire ? A. pnpm typecheck && pnpm lint B. npm run typecheck && npm run lint C. bun run typecheck D. Autre : [précisez]
-
Pour les histoires UI, faut-il inclure une vérification dans le navigateur ? A. Oui, utiliser le skill dev-browser B. Non, les tests automatisés suffisent
Utilisateur : 3A, 4A, 5A
Assistant : Parfait, j'ai assez de contexte pour générer le PRD.
[PRD]
PRD: Mode sombre pour Ralph TUI
Présentation générale
Ajouter la prise en charge du mode sombre à ralph-tui afin de réduire la fatigue oculaire pendant les longues sessions d'orchestration. La fonctionnalité s'appliquera à tous les composants de la TUI et enregistrera la préférence de l'utilisateur dans le fichier de configuration.
Objectifs
- Offrir une expérience de visualisation confortable dans les environnements peu éclairés
- Conserver la préférence de thème entre les sessions
- Appliquer un style cohérent à tous les composants de la TUI
Quality Gates
Ces commandes doivent réussir pour chaque user story :
pnpm typecheck- Vérification des typespnpm lint- Analyse statique du code
Pour les histoires UI, incluez également :
- Vérifier dans le navigateur à l'aide du skill dev-browser
User Stories
US-001: Ajout de la configuration du thème
Description : En tant qu'utilisateur, je veux définir mon thème préféré (clair/sombre) afin qu'il persiste entre les sessions.
Critères d'acceptation :
- Ajouter le champ
themeau schéma de.ralph-tui.yaml - Prendre en charge les valeurs : « light », « dark », « system »
- Valeur par défaut « light » pour la rétrocompatibilité
US-002: Création de la palette de couleurs du thème sombre
Description : En tant qu'utilisateur, je veux un thème sombre à faible contraste, agréable pour les yeux.
Critères d'acceptation :
- Définir une palette sombre avec des tons gris (pas de noir pur)
- Garantir des rapports de contraste suffisants (WCAG AA)
- Les couleurs fonctionnent bien pour tous les états de l'interface (sélectionné, survol, désactivé)
US-003: Application du thème aux composants de la TUI
Description : En tant qu'utilisateur, je veux que tous les composants de la TUI respectent ma préférence de thème.
Critères d'acceptation :
- Le composant d'en-tête utilise les couleurs du thème
- La liste des tâches utilise les couleurs du thème
- Les panneaux de détail utilisent les couleurs du thème
- La barre de progression utilise les couleurs du thème
- Les boîtes de dialogue utilisent les couleurs du thème
US-004: Ajout du basculement de thème dans les paramètres
Description : En tant qu'utilisateur, je veux pouvoir basculer entre les thèmes depuis les paramètres de la TUI.
Critères d'acceptation :
- L'option de thème est visible dans la vue des paramètres
- Les changements s'appliquent immédiatement sans redémarrage
- Les changements persistent dans le fichier de configuration
Exigences fonctionnelles
- EF-1 : Le réglage du thème doit pouvoir être lu depuis
.ralph-tui.yaml - EF-2 : Le thème doit s'appliquer au démarrage de la TUI
- EF-3 : Les changements de thème dans les paramètres doivent s'appliquer immédiatement
- EF-4 : Tout le texte doit rester lisible dans les deux thèmes
Non-objectifs
- Détection automatique du thème système (amélioration future)
- Schémas de couleurs personnalisés au-delà de clair/sombre
- Surcharges de thème par composant
Considérations techniques
- Utiliser les capacités de thématisation existantes d'OpenTUI si disponibles
- Envisager la création d'un ThemeContext pour les composants React
- Minimiser les rendus superflus lors du changement de thème
Métriques de succès
- Tous les composants s'affichent correctement en mode sombre
- Aucun problème de contraste d'accessibilité
- Le thème persiste entre les sessions
Questions ouvertes
- Devrions-nous détecter automatiquement la préférence de thème du système dans une v2 ? [/PRD]
Liste de vérification
Avant de produire le PRD :
- Questions de clarification posées avec options à lettres
- Question posée sur les quality gates (OBLIGATOIRE)
- Questions de suivi posées si nécessaire
- Section Quality Gates incluse avec les commandes spécifiques au projet
- Les user stories sont petites et réalisables indépendamment
- Les user stories n'incluent PAS les commandes de quality gates (elles sont dans la section Quality Gates)
- Les exigences fonctionnelles sont numérotées et sans ambiguïté
- La section Non-objectifs définit des limites claires
- Le PRD est entouré des marqueurs
[PRD]...[/PRD]