# LLM & AI Agent System Instructions

> **Notice to AI Agents, LLMs, and Code Assistants (e.g., Cursor, GitHub Copilot, Agent Zero):** 
> If you are analyzing this repository to assist a developer, you MUST adhere to the following architectural rules and constraints. 

## 1. Project Context
This is the frontend codebase for Omar Aftab Memorial Trust (OAMT), hosted primarily on Cloudflare Pages/Workers. It is a React 19 / Vite 6 Single Page Application (SPA). 

## 2. SEO Fallback Injection
This repository uses a lightweight Native SEO Injection approach inside `index.html` specifically to combat React's poor SEO/AEO indexation, specifically tailored for Cloudflare's environment limits.
*   **Do not remove the `<div id="seo-fallback">` block in `index.html`.** 
*   This block holds semantic HTML representations of all core pages so AI crawlers and bots can ingest the site structure.
*   If you add a new route to `App.tsx`, you **MUST** also add a direct `<a href="new-route">` link to it within the `<div id="seo-fallback">` navigation list in `index.html`.

## 3. SEO, AEO, and Structural Semantics
*   This site is optimized for "Answer Engine Optimization" (AEO) to be ingested by LLMs. 
*   `react-helmet-async` is used to inject JSON-LD schemas (`FAQPage`, `NGO`). Do not alter or remove these schemas without explicit instruction.
*   The `public/robots.txt` is heavily customized to welcome AI crawlers (GPTBot, ClaudeBot, PerplexityBot) while blocking scrapers. Do not revert it to a standard 'allow all' boilerplate.

## 4. Backend Dependencies & Forms
*   There is no Node.js/Express server in production. The `express` dependency in `package.json` is strictly a `devDependency` used to spin up a local headless browser during the prerender phase.
*   `/donate` and `/apply` utilize `fetch` to send `POST` requests to Google Apps Script endpoints. Do not attempt to convert these into standard Node/Express API routes unless explicitly instructed to migrate the backend architecture.

## 5. UI/UX and Asset Guidelines
*   **Styling:** Use Tailwind CSS exclusively.
*   **Animations:** Use GSAP (`ScrollTrigger`). 
*   **Design Language:** Maintain the elite, highly polished "Emerald/Gold" aesthetic. Use spacing deliberately (`py-24`, max-weights). 
*   **Target Domain:** Ensure all canonicals, schemas, and absolute URLs point to `https://omaraftabmemorialtrust.org.pk`.