Cette compétence prend le contexte de la conversation en cours et la compréhension du codebase pour produire un PRD. N'interviewez PAS l'utilisateur — contentez-vous de synthétiser ce que vous savez déjà.
Le système de suivi des problèmes et le vocabulaire des étiquettes de triage devraient vous avoir été fournis — exécutez /setup-matt-pocock-skills si ce n'est pas le cas.
Processus
-
Explorez le dépôt pour comprendre l'état actuel du codebase, si vous ne l'avez pas déjà fait. Utilisez le vocabulaire du glossaire du domaine du projet tout au long du PRD, et respectez les ADR dans la zone que vous touchez.
-
Esquissez les points de test (seams) auxquels vous allez tester la fonctionnalité. Les points de test existants doivent être préférés aux nouveaux. Utilisez le point de test le plus élevé possible. Si de nouveaux points de test sont nécessaires, proposez-les au niveau le plus élevé possible. Moins il y a de points de test dans le codebase, mieux c'est — le nombre idéal est un.
Vérifiez avec l'utilisateur que ces points de test correspondent à ses attentes.
- Rédigez le PRD en utilisant le modèle ci-dessous, puis publiez-le dans le système de suivi des problèmes du projet. Appliquez l'étiquette de triage
ready-for-agent— pas besoin de triage supplémentaire.
Énoncé du Problème
Le problème auquel l'utilisateur est confronté, du point de vue de l'utilisateur.
Solution
La solution au problème, du point de vue de l'utilisateur.
User Stories
Une longue liste numérotée de user stories. Chaque user story doit être au format :
- En tant qu', je veux une <fonctionnalité>, afin de <bénéfice>
Cette liste de user stories doit être extrêmement complète et couvrir tous les aspects de la fonctionnalité.
Décisions d'Implémentation
Une liste des décisions d'implémentation qui ont été prises. Cela peut inclure :
- Les modules qui seront construits/modifiés
- Les interfaces de ces modules qui seront modifiées
- Des clarifications techniques du développeur
- Des décisions architecturales
- Des modifications de schéma
- Des contrats API
- Des interactions spécifiques
N'incluez PAS de chemins de fichiers spécifiques ou d'extraits de code. Ils pourraient devenir obsolètes très rapidement.
Exception : si un prototype a produit un extrait qui encode une décision plus précisément qu'une prose ne le pourrait (machine d'état, réducteur, schéma, forme de type), intégrez-le dans la décision concernée et notez brièvement qu'il provient d'un prototype. Limitez-vous aux parties riches en décisions — pas une démo fonctionnelle, seulement les éléments importants.
Décisions de Test
Une liste des décisions de test qui ont été prises. Incluez :
- Une description de ce qui constitue un bon test (tester uniquement le comportement externe, pas les détails d'implémentation)
- Quels modules seront testés
- Des exemples antérieurs pour les tests (c'est-à-dire des types de tests similaires dans le codebase)
Hors Scope
Une description des éléments qui sont hors scope pour ce PRD.
Notes Complémentaires
Toutes notes supplémentaires concernant la fonctionnalité.