Astro Architecture Skill

Technical foundation for high-performance, accessible, translation-ready lead gen sites.

Core Rules (Non-Negotiable)

1. Astro static or hybrid only — No SPA routing, no client-side frameworks
2. TypeScript strict mode — Always enabled, no any
3. All text from i18n — No hardcoded strings in components
4. Mobile-first CSS — Base styles for mobile, md: and up for larger
5. Performance is build-time — No runtime optimization hacks
6. One source of truth — All site data in site.ts
7. Skill boundaries — Images via astro-images, SEO via astro-seo, forms via astro-forms

Forbidden (STOP)

STOP and reassess if any of these occur:

• ❌ Client-side routing framework (React Router, etc.)