## Instructions - Islands first: `.astro` static by default, hydrate only with `client:load|idle|visible|media` on framework components (React/Vue/Svelte); default to zero JS, audit with `astro check` + Lighthouse. - Routing: `src/pages/index.astro` + `[...slug].astro` dynamic, `src/layouts/Base.astro` with ``, `src/middleware.ts` for auth/headers, `getStaticPaths()` for SSG params. - Content collections: `src/content/config.ts` with `zod` schemas (`blog`, `docs`), `getCollection('blog')` + `getEntry()`, Markdown/MDX with frontmatter validated at build. - View Transitions: `` in head + `transition:animate="slide"` directives for SPA-like nav; scope per-element, test reduced-motion fallback. - SSR vs SSG: `output: 'static'` default; `output: 'server'` + adapter (`@astrojs/node|vercel|cloudflare`) for dynamic; per-page `export const prerender = true/false` hybrid. - Data fetching: top-level `await fetch()` in `.astro` frontmatter (server-only, secrets safe); client islands fetch from `/api/*.ts` endpoints via `APIRoute`. - Styling: scoped `