Règles de codage IA pour les sites de contenu SEO

Règles AGENTS.md pour les sites de contenu axés sur le SEO qui empêchent les métadonnées en double, imposent des données structurées et empêchent les agents de casser la crawlability.

Déposez ceci dans la racine de votre dépôt en tant que AGENTS.md. Il cible tout site à contenu dense où le trafic de recherche organique est le principal levier de croissance — blogs, sites de documentation, sites marketing et bibliothèques de ressources.

AGENTS.md

# Project Rules — SEO Content Site

## Stack
- Astro (static) or Next.js (App Router, static export or ISR).
- TypeScript strict. Content schema enforced via Zod (content collections or manual).
- Tailwind CSS for styling.

## Hard rules — SEO correctness
- Every page MUST have a unique `<title>` (50–60 chars) and a unique
  `<meta name="description">` (120–160 chars). Duplicate titles and descriptions
  cause Google to de-rank or rewrite them. Check both before marking a task done.
- Every page MUST render a `<link rel="canonical" href="...">` pointing to its own
  canonical URL. This is required even on pages that are not duplicated — it is a
  signal, not just a deduplication tool.
- Never generate two pages with the same slug or URL path. Before adding a new content
  file or route, confirm the path does not already exist in `src/pages/` or the
  content collection.
- Every blog post or article MUST include JSON-LD structured data: at minimum
  `Article` with `headline`, `datePublished`, `dateModified`, and `author`.
  Product pages need `Product` schema. FAQ pages need `FAQPage` schema.
- Open Graph tags (`og:title`, `og:description`, `og:image`, `og:url`) must be
  present on every page. The `og:image` must be an absolute URL (not a relative path).
- Do NOT use `noindex` on pages that should rank. Do NOT remove `noindex` from pages
  in `src/pages/api/`, `src/pages/admin/`, or any route that should not be crawled.

## URL and routing conventions
- URLs are lowercase, hyphen-separated, no trailing slashes (or consistently with
  trailing slash if the framework default — pick one and enforce it with a redirect).
- Never rename a published URL without adding a 301 redirect from the old path.
  Broken inbound links are ranking signals that are lost permanently.
- Paginated series use `/page/2/` style paths, not query strings (`?page=2`).
  Query-string pagination is not indexed by Google.

## Content and performance
- All images must have descriptive `alt` text that includes the target keyword where
  natural. Empty `alt=""` is only correct for decorative images.
- Images must be served in WebP or AVIF format. No JPEG or PNG without a `<picture>`
  element providing a next-gen fallback.
- Every page must load without render-blocking scripts. No `<script>` without `defer`
  or `async` in the `<head>` unless it is a critical inline script.
- Internal links must use the full path and must not 404. Before adding a link, verify
  the target page exists.

## Definition of done
- `astro check` or `tsc --noEmit` passes.
- `astro build` completes without warnings.
- Running a spot-check: `curl -s <page-url> | grep -c 'canonical'` returns 1.
- No duplicate `<title>` values across built HTML (run `grep -r '<title>'` on dist/).
- JSON-LD is present and valid (use schema.org validator).

Pourquoi ces règles

Titre et description uniques par page est la règle SEO la plus impactante pour les sites de contenu. Les agents qui génèrent des pages de contenu en masse réutilisent souvent le même modèle de métadonnées, produisant des dizaines de pages techniquement distinctes mais apparaissant identiques aux crawlers — déclenchant des pénalités de déduplication douce.
Canonical sur chaque page, pas seulement sur les doublons est souvent mal compris. Les agents qui lisent la documentation SEO n’ajoutent souvent des canoniques que là où le contenu est clairement dupliqué (par ex. pagination). En pratique, chaque page doit s’auto-référencer avec son canonical pour empêcher les variantes d’exploration injectées par paramètres de diviser l’équité des liens.

Bon ajustement

Blogs, sites de documentation, hubs de contenu SEO et sites marketing où la recherche organique est le principal canal d’acquisition.

Pas un ajustement

Outils internes, tableaux de bord ou applications où le SEO est non pertinent — les exigences de canonique/données structurées ajoutent une surcharge sans bénéfice.

Règles de codage IA pour les sites de contenu SEO

AGENTS.md

Pourquoi ces règles

Bon ajustement

Pas un ajustement

Connexes