Pack de contexte pour site SEO statique Astro

Un pack de contexte copiable décrivant un site SEO statique Astro afin qu'un agent IA puisse y travailler correctement dès la première invite.

Collez ceci en haut d’une tâche pour que l’agent comprenne le projet avant d’écrire quoi que ce soit. Il est conçu pour être lu par les humains et par votre agent.

Contexte du projet

A content-driven static site built with Astro. No database, no server runtime.
Content lives in Markdown/MDX under src/content and is rendered to static HTML
at build time. Deployed to Cloudflare Pages.

Stack technique

Astro 6 (static output)
MDX content collections (Content Layer API)
Tailwind CSS v4 (via @tailwindcss/vite)
Pagefind for static search
TypeScript (strict)

Structure des répertoires

src/content/        # MDX content, one folder per collection
src/content.config.ts
src/layouts/        # BaseLayout, ResourceLayout
src/pages/          # routes + .md/.json endpoints + llms.txt
src/components/

Conventions de codage

- Content is data: edits to copy should be MDX edits, not template changes.
- Keep components in plain Astro; add a framework island only when needed.
- Every resource page also emits a .md and .json version.
- No client-side rendering of primary content — output HTML at build time.

Limites des tâches IA

- Do not add a server adapter or database.
- Do not break the .md/.json/llms.txt endpoints.
- Validate frontmatter against the zod schema in content.config.ts.

llms.txt

This site publishes /llms.txt and a .md version of every page so agents can
read content as clean Markdown instead of scraping HTML.