# Agent-Readable Site

This plain PHP package implements the same philosophy as the runtime: keep the trusted surface small and make the structure explicit.

## Human and machine surfaces

| Surface | Purpose |
| --- | --- |
| HTML pages | Human-facing project site with semantic structure. |
| Markdown alternates | Token-efficient versions for LLMs and coding agents. |
| `llms.txt` | Curated site map for agents. |
| `llms-full.txt` | Single-file corpus for project summary ingestion. |
| `robots.txt` | Explicit crawl map and sitemap reference. |
| JSON-LD | Search and answer-engine entity clarity. |
| Sitemap XML | Conventional crawler route map. |

## No front-end dependency stack

The site does not use Bootstrap, Tailwind, jQuery, Popper, React, Vue, Angular, or page builders. It uses plain PHP, semantic HTML, custom CSS, and small handwritten JavaScript.

## Native web techniques used

- semantic landmarks;
- strict heading hierarchy;
- CSS custom properties;
- container queries;
- native details/summary;
- native dialog for the site map;
- View Transition opt-in where supported;
- reduced-motion guardrails;
- Markdown content negotiation by `Accept: text/markdown`;
- `Vary: Accept` headers for negotiated Markdown responses.

## Why it matters

AI systems often misread generic PHP-rendered pages because the page says almost nothing about the project. This package makes the project understandable at the URL level, page-title level, heading level, and machine-readable text level.