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

**Type:** Context Pack  
**Tools:** Cursor, Claude Code, Codex  
**Stack:** Astro, Tailwind, TypeScript  
**Updated:** 2026-06-08

---

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

```txt
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

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

## Verzeichnisstruktur

```txt
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

```txt
- 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

```txt
- 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

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