Claude
NotionRELECTURE DE SPECS
Prérequis
- Specs Notion structurées par feature ou user story
- Critères d’acceptation rédigés (même en brouillon)
- Accès export Notion (Markdown ou copie par page)
- Référentiel métier du projet (glossaire, règles métier)
Des specs ambiguës ou incomplètes se paient en développement : retours tardifs, critères d’acceptation non testables, incohérences entre pages. L’export Notion vers Claude avec un prompt structuré accélère la détection des trous de cadrage. Vous allez configurer un workflow de relecture reproductible pour le PO, avant le sprint dev.
Préparer l’export Notion pour Claude
Sélectionnez les pages spec du sprint à valider. Export Markdown (Notion → ⋯ → Export) ou copie structurée avec titres H2/H3 conservés.
Ajoutez le glossaire projet et les règles transverses (authentification, rôles, paiement) en préambule du prompt. Claude croise mieux les specs avec ce référentiel.
Retirez les commentaires internes sensibles et les brouillons non destinés à la relecture. Une spec par fichier ou un export groupé avec sommaire explicite.
Rédiger le prompt de relecture
System prompt : « Vous êtes relecteur QA fonctionnel pour une agence web. Signalez incohérences, trous et critères non vérifiables. Ne proposez pas de nouvelles features hors spec. »
Demandez une sortie tabulaire : Feature | Problème | Gravité (bloquant / mineur) | Suggestion de reformulation.
Incluez des consignes sur les critères d’acceptation : chaque critère doit être observable en recette (action + résultat attendu).
Traiter les retours et mettre à jour Notion
Priorisez les points bloquants avant le refinement. Les mineurs peuvent être traités en parallèle du sprint si le périmètre est clair.
Corrigez les specs dans Notion et relancez une relecture ciblée sur les pages modifiées. Boucle courte : export → Claude → correctifs → validation PO.
Liez les specs corrigées aux tâches delivery (voir tutoriel bases liées Notion) pour maintenir la traçabilité exigence → livrable.
Erreurs fréquentes
Exporter tout le wiki sans filtre : bruit et fatigue de relecture.
Accepter les suggestions Claude sans vérifier le métier : fausses alertes possibles.
Oublier les dépendances inter-features (auth, panier, notifications).
Critères d’acceptation rédigés en jargon marketing : non testables en recette.
Ne pas historiser les versions de spec après correction.
Ce qu’il faut retenir
Export Notion ciblé + glossaire + prompt de grille = relecture reproductible.
Sortie structurée par gravité pour prioriser le refinement.
Boucle courte export → relecture → correctif Notion avant sprint.
Validation métier humaine indispensable après la passe IA.
FAQ
Privilégiez l’export Markdown par page ou par sous-arbre sprint. Vérifiez que les titres et listes sont conservés. Pour de petits lots, la copie directe avec structure H2 suffit.
Non. Ciblez les specs nouvelles ou modifiées depuis la dernière validation. Les specs stables et déjà livrées n’ont pas besoin d’une relecture complète systématique.
Oui via Make ou l’API Notion, pour les équipes matures. Commencez manuellement pour calibrer le prompt, puis automatisez l’export des pages « Prêt pour dev » uniquement.
ChatGPT