# AGENTS.md — Yes Machines Book

## What this project is

Landing page for [yesmachinesbook.com](https://yesmachinesbook.com), a forthcoming book and lightweight product about deliberate commitments ("Stories and tools for deliberate commitments"). The page is a coming-soon site with an email waitlist form and PostHog analytics.

## Project structure

Plain static site — no framework, no build step. The repo root is the served web root.

- `index.html` — The single page (hero + waitlist form, feature cards, "How it works" steps, below-fold answer paragraph, footer).
- `styles.css` — Global stylesheet (includes `:focus-visible` outline rule).
- `script.js` — Client-side JS: accent-color theming, waitlist form handler (PostHog event + status message only), scroll-reveal animations.
- `posthog.js` — PostHog analytics loader.
- `robots.txt`, `sitemap.xml`, `llms.txt`, `agents.md` — Agent/crawler protocol files.
- `.well-known/agent-card.json`, `.well-known/ai-agent.json` — Agent manifests with guardrails.

## Development

No dependencies, no build. Open `index.html` in a browser or serve the directory with any static file server. Do not add a build step without discussion.

## How agents should interact with the deployed site

- All pages are public and read-only friendly.
- The only interactive element is the waitlist form (`#waitlist-form`, submit button tagged `data-agent-action="subscribe"`). Submit only with an email explicitly provided by the user.
- There is no pricing, checkout, signup, login, or account system. No contact email is published.

## Editing constraints

- Do not restyle or rewrite existing hero/above-the-fold copy or CTAs without explicit instruction; visible additions belong below the fold.