fixing-metadata

Livrer des métadonnées correctes et complètes.

Triggers

• metadata
• meta tags
• og tags
• open graph
• seo
• title tag
• description tag
• social preview
• twitter card
• favicon
• structured data
• schema.org

how to use

• /fixing-metadata Appliquer ces contraintes à tout travail de métadonnées dans cette conversation.

• /fixing-metadata <file> Examiner le fichier par rapport à toutes les règles ci-dessous et rapporter :

  • violations (citer la ligne exacte ou l'extrait)
  • pourquoi c'est important (une courte phrase)
  • un correctif concret (suggestion au niveau du code)

Ne pas introduire de nouveaux frameworks ou bibliothèques SEO sauf si explicitement demandé. Préférer les diffs minimaux.

when to apply

Référencer ces directives quand :

• ajout ou modification de titres de page, descriptions, canonical, robots
• implémentation de métadonnées Open Graph ou Twitter card
• définition de favicons, icônes d'app, manifest, theme-color
• création de composants SEO partagés ou defaults de métadonnées de layout
• ajout de structured data (JSON-LD)
• changement de locale, langues alternatives, ou routing canonical
• livraison de nouvelles pages, pages marketing, ou liens partageables

rule categories by priority

quick reference

1. correctness and duplication (critical)

• définir les métadonnées en un seul endroit par page, éviter les systèmes concurrents
• ne pas émettre de tags title, description, canonical, ou robots dupliqués
• les métadonnées doivent être déterministes, pas de valeurs aléatoires ou instables
• échapper et nettoyer toute chaîne générée par l'utilisateur ou dynamique
• chaque page doit avoir des defaults sûrs pour le title et la description

2. title and description (high)

• chaque page doit avoir un title
• utiliser un format de title cohérent sur l'ensemble du site
• garder les titles courts et lisibles, éviter le keyword stuffing
• les pages partageables ou recherchables doivent avoir une meta description
• les descriptions doivent être du texte brut, pas de markdown ou spam de guillemets

3. canonical and indexing (high)

• canonical doit pointer vers l'URL préférée pour la page
• utiliser noindex uniquement pour les pages privées, dupliquées, ou non publiques
• robots meta doit correspondre à l'intention d'accès réelle
• les previews ou pages staging doivent être noindex par défaut si possible
• les pages paginées doivent avoir un comportement canonical correct

4. social cards (high)

• les pages partageables doivent définir Open Graph title, description, et image
• les images Open Graph et Twitter doivent utiliser des URLs absolues
• préférer les dimensions d'image correctes et les ratios d'aspect stables
• og:url doit correspondre à l'URL canonical
• utiliser un og:type sensé, généralement website ou article
• définir twitter:card correctement, summary_large_image par défaut

5. icons and manifest (medium)

• inclure au moins un favicon qui fonctionne sur tous les navigateurs
• inclure apple-touch-icon le cas échéant
• manifest doit être valide et référencé quand utilisé
• définir theme-color intentionnellement pour éviter un UI chrome mal assorti
• les chemins d'icône doivent être stables et cachéables

6. structured data (medium)

• ne pas ajouter de JSON-LD sauf s'il correspond clairement au contenu réel de la page
• JSON-LD doit être valide et refléter ce qui est réellement rendu
• ne pas inventer de ratings, reviews, prices, ou détails d'organisation
• préférer un bloc de structured data par page sauf si requis

7. locale and alternates (low-medium)

• définir correctement l'attribut html lang
• définir og:locale quand la localisation existe
• ajouter des alternates hreflang uniquement quand les pages existent réellement
• les pages localisées doivent se canonicaliser correctement par locale

8. tool boundaries (critical)

• préférer les changements minimaux, ne pas refactoriser du code non-lié
• ne pas migrer de frameworks ou bibliothèques SEO sauf si demandé
• suivre le pattern de métadonnées existant du projet (Next.js metadata API, react-helmet, manual head, etc.)

review guidance

• corriger les problèmes critiques en premier (duplicates, canonical, indexing)
• s'assurer que title, description, canonical, et og:url sont en accord
• vérifier les social cards sur une URL réelle, pas localhost
• préférer des métadonnées stables et simples plutôt que cleveres ou dynamiques
• garder les diffs minimaux et limités aux métadonnées seulement

Verify

• Title, description, OG image, canonical URL, et favicon ont chacun été inspectés sur la page live (view-source ou DOM), pas seulement édités en source
• La longueur du title est dans la fenêtre 50-60 caractères et la description dans 140-160 caractères ; les comptages finaux sont enregistrés
• Les previews OG et Twitter card ont été validées avec un vrai fetcher (p. ex., opengraph.xyz, cards-dev) et les screenshots/links sont attachés
• Le structured data (JSON-LD) se valide contre schema.org ; la sortie du validateur ou un rapport zéro-erreur est attaché
• Sitemap et directives robots ont été vérifiés pour que la page soit réellement indexable (ou intentionnellement noindex)