ClaudeSORTIES JSON LIVRABLES
Prérequis
- Schéma JSON ou TypeScript du livrable cible
- Exemple de sortie valide (golden sample) pour calibrer le prompt
- Environnement de validation (jq, script Node, Zod)
- Convention de nommage et chemins du dépôt
Copier-coller du texte libre depuis Claude vers le code génère des erreurs de parsing et des allers-retours. En imposant un schéma JSON explicite et une validation avant intégration, vous transformez Claude en producteur de livrables exploitables : metadata, FAQ, props de composants ou specs d’API. Vous allez configurer des prompts à sortie structurée pour l’équipe dev.
Définir le schéma cible
Partez du type TypeScript ou du JSON Schema existant dans le projet. Listez les champs obligatoires, les enums, les longueurs max (ex. title ≤ 44 caractères pour l’Académie).
Préparez un golden sample : un fichier JSON valide qui sert de référence visuelle dans le prompt. Claude imite mieux avec un exemple concret que avec une description abstraite.
Documentez les interdits : pas de champs supplémentaires, pas de null sur les propriétés requises, encodage UTF-8.
Construire le prompt à sortie structurée
System prompt : « Vous produisez uniquement du JSON valide conforme au schéma fourni. Aucun markdown, aucun commentaire. »
Collez le schéma et le golden sample. Décrivez la tâche : « Générez metadata pour la page /contact selon le schéma PageMetadata. »
Utilisez le prefill `{` en début de réponse assistant pour ancrer le format. Répétez la consigne « JSON seul » en fin de prompt utilisateur.
Valider et intégrer dans le dépôt
Passez la sortie dans un validateur : `JSON.parse`, Zod, ou `as const satisfies MonType`. Rejetez et relancez si le parse échoue.
Pour des lots (10 metadata, 5 FAQ), demandez un tableau JSON et validez chaque entrée. Script Node reproductible en CI si le flux est récurrent.
Intégrez le JSON validé dans le fichier cible (`*.tutorial.ts`, `metadata.ts`, config redirects). Revue PR humaine sur le fond, pas seulement la syntaxe.
Erreurs fréquentes
Accepter du JSON entouré de balises markdown ```json.
Schéma flou : Claude invente des clés non prévues.
Pas de golden sample : formats inconsistants entre générations.
Intégration directe sans validation : build cassé en CI.
Demander du JSON trop volumineux en une passe : dépassement de contexte ou troncature.
Ce qu’il faut retenir
Schéma strict + golden sample + prefill `{` = JSON fiable.
Validation parse/schéma obligatoire avant écriture disque.
Lots découpés pour les gros volumes de livrables.
Revue humaine sur le fond éditorial et métier après validation technique.
FAQ
Relancez avec le message d’erreur de parse (« Unexpected token à la ligne X »). Limitez à deux tentatives automatiques, puis intervention humaine pour ajuster le schéma ou le prompt.
Oui pour des objets simples, mais le JSON intermédiaire suivi d’un typage TypeScript avec `satisfies` reste plus sûr. Vous séparez ainsi la génération IA du contrôle compile-time. Validez toujours le parse avant écriture disque.
Pour des flux répétitifs (metadata Académie, inventaire SEO), un script de validation Zod en pre-commit ou CI évite les régressions. La génération Claude reste manuelle ou semi-automatisée.
Cursor
ChatGPT