PRD IA : rédiger des exigences qu'un système modèle peut réellement respecter
Un PRD pour un système d'IA est un document différent. Vos exigences ne sont pas des instructions pour un ingénieur ; ce sont des contraintes sur un système qui improvisera. Cette compétence restructure le document autour de ce fait.
Fichiers pilotés par cette compétence
- ../../templates/definition/prd.md, le modèle de PRD de base
- Le calque IA dans
templates/ai/: eval-spec.md, guardrails.md, hallucination-controls.md, human-approval-gates.md, prompt-structure.md, context-management.md, red-team-review.md, et pour les systèmes agentiques agent-architecture.md et multi-agent-workflow.md - Pour les contextes réglementés : ../../modules/regulated/templates/regulated-ai-prd-template.md, piloté par ../../modules/regulated/SKILL.md
Quand l'utiliser
- Spécifier toute fonctionnalité où un LLM, un agent ou un modèle prend ou rédige une décision
- Réviser un PRD existant qui mentionne « l'IA devrait... » quelque part
- Transformer une démo en quelque chose dont une équipe d'ingénierie peut être tenue responsable
Les cinq sections imposées par cette compétence
1. Les critères d'acceptation sont des ensembles d'évaluation, pas des phrases
« L'agent doit extraire le nom du marchand » est un souhait. Une exigence est :
- Un ensemble d'exemples étiquetés (minimum 30 à 50 cas pour une première version)
- Un seuil de réussite exprimé sous forme de nombre (précision, rappel à k, ou score du juge)
- La règle pour ce qui se passe en dessous du seuil (bloquer la version, pas « réviser »)
Pour chaque « devrait » dans le brouillon, demandez : où est l'ensemble d'exemples, quel est le nombre, qui est responsable d'ajouter les cas échoués dans l'ensemble. Capturez les réponses dans ../../templates/ai/eval-spec.md.
2. Les cas limites sont les spécifications, pas l'annexe
Le chemin heureux est ce que le modèle fait gratuitement. Le document prouve sa valeur aux limites. Exigez des tables explicites pour :
- DOIT REFUSER : les entrées que le système décline (hors périmètre, dangereuses, ambiguës au-delà de toute réparation)
- DOIT ESCALADER : les conditions qui redirigent vers un humain, avec la cible de routage nommée ; capturez les déclencheurs et le comportement de temporisation dans ../../templates/ai/human-approval-gates.md
- NE DOIT JAMAIS INVENTER : les champs où la fabrication est pire que l'absence (nombres, noms, déclarations juridiques ou réglementaires, montants monétaires) ; la politique d'abstention se trouve dans ../../templates/ai/hallucination-controls.md
3. La non-déterminisme est mise par écrit
La même entrée peut produire une sortie différente demain. Le PRD doit indiquer :
- Quelles variations de sortie sont acceptables (formulation ? ordre ? formatage ?)
- Lesquelles sont des défauts (décision différente, nombre différent, comportement de refus différent)
- La posture de reproductibilité : politique de température et de seed, et si les journaux capturent suffisamment pour rejouer toute décision
Si le PRD ne le dit pas, l'assurance qualité le décidera plus tard, dans un système de suivi de bugs, avec colère.
4. Les garde-fous sont des fonctionnalités avec des propriétaires
Chaque garde-fou obtient une ligne dans ../../templates/ai/guardrails.md : nom, déclencheur, comportement, propriétaire, test. Ensemble minimum à considérer pour toute fonctionnalité agentique :
- Échec-fermé sur une sortie non vérifiable (ne peut pas la vérifier = ne pas l'envoyer à l'utilisateur)
- Approbation humaine avant tout irréversible (envois, paiements, suppressions, publications)
- Plafonds de dépenses et de débit avec un plafond indiqué et un comportement indiqué au plafond
- Isolation des entrées : le contenu que le système lit est une donnée, jamais des instructions
- Piste d'audit : qui ou quoi a décidé, sur la base de quelles entrées, à quelle version du modèle
5. La page des opérations
- Coût par appel cible et seuil d'alerte
- Budget de latence par étape
- Épinglage de version du modèle et processus de décision de mise à niveau
- Télémétrie : ce qui est enregistré par décision, où s'exécutent les évaluations (CI, pré-version, échantillonnage en production), et le déclencheur de retour arrière
La voie réglementée
Les outils génériques de PRD écrivent les cinq sections ci-dessus et s'arrêtent là. Lorsque le produit se trouve sous un régulateur financier ou de données, n'exécutez pas le propre calque de cette compétence de mémoire. Commencez plutôt par le modèle exact octet par octet à ../../modules/regulated/templates/regulated-ai-prd-template.md, suivez ../../modules/regulated/SKILL.md, et complétez sa section 0 (conditions préalables de licence, règles du schéma, résidence des données et conditions du fournisseur, points de contact pour la criminalité financière, conduite, la preuve d'audit) avant d'écrire toute exigence. Un champ de calque vide est une décision reportée à celui qui le trouvera vide. Les noms de régulateurs, les numéros de sections et les textes cités proviennent uniquement de ce module ou d'un texte principal fourni par l'utilisateur ; ne les inventez jamais.
Flux de travail
- Classez le contexte. Réglementé : suivez la voie réglementée ci-dessus, puis revenez ici pour les sections que le module ne couvre pas. Non réglementé : commencez par ../../templates/definition/prd.md.
- Lisez le brouillon du PRD, ou interrogez le PM si vous partez de zéro.
- Réécrivez chaque énoncé « devrait » dans la forme de la section 1. Listez ceux qui ne peuvent pas être transformés en évaluations ; ce ne sont pas encore des exigences, marquez-les.
- Construisez les trois tables de cas limites. Visez au moins 5 lignes chacune ; des tables vides signifient que la découverte n'est pas terminée.
- Rédigez la clause de non-déterminisme et la table des garde-fous.
- Produisez une liste de LACUNES d'une page : chaque endroit où le document original supposait un implémenteur déterministe, classé par rayon d'impact.
Format de sortie
Retournez le PRD restructuré avec les cinq sections, puis la table des LACUNES :
| # | Lacune | Où dans l'original | Rayon d'impact si livré tel quel | Correction minimale |
|---|
Porte de sortie
La sortie de cette compétence alimente la Porte 2 dans ../../os/STAGE-GATES.md. Ne signalez pas le PRD comme terminé tant qu'une exigence manque de condition de réussite numérique, qu'un garde-fou manque de propriétaire et de test, ou qu'une ligne de LACUNES manque de propriétaire et de date.