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: Acceptheaders 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.