Astro Statische SEO-Website — Kontextpaket

Ein kopierbares Kontextpaket, das eine statische Astro-SEO-Website beschreibt, damit ein KI-Agent von der ersten Eingabe an korrekt darin arbeiten kann.

Fügen Sie dies oben in eine Aufgabe ein, damit der Agent das Projekt versteht, bevor er etwas schreibt. Es ist so geschrieben, dass es von Menschen und von Ihrem Agenten gelesen werden kann.

Projekt-Hintergrund

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

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

Verzeichnisstruktur

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/

Programmierkonventionen

- 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.

KI-Aufgabengrenzen

- 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.