# AGENTS.md — yestrap repo

## What this project is

The website for *The Yes Trap*, an upcoming book by Miguel Sanchez-Grice about how always-positive AI tools can distort judgment. The site is pre-launch: a coming-soon landing page with an email waitlist. No checkout, pricing, or accounts exist.

## Stack

Plain static HTML/CSS/JS served from the repo root, deployed on Vercel. `api/subscribe.js` is a Vercel serverless function (POST endpoint that stores/sends subscription emails via Resend). There is no build step and no test suite.

## Commands

- `npm run dev` — local dev via `vercel dev` (requires Vercel CLI + env vars for Resend).
- `npm start` — serve the static site locally with `serve -s .`.
- Required env vars for the API: `RESEND_API_KEY`, optionally `RESEND_AUDIENCE_ID`, `EMAIL_FROM`.

## Project structure

- `index.html`, `styles.css`, `script.js`, `posthog.js` — root coming-soon landing page (the only URL in `sitemap.xml`).
- `comingsoon/` — "purchase coming soon" email capture page (`noindex`).
- `preview/` — full book landing page; password-gated client-side via `unlock/`.
- `unlock/` — client-side password gate for the preview.
- `api/subscribe.js` — serverless subscribe endpoint.
- `robots.txt`, `sitemap.xml`, `llms.txt`, `agents.md`, `.well-known/` — crawler/agent protocol files.
- `vercel.json` — security headers only (no build config).

## Conventions

- Single global stylesheet (`styles.css`) shared by all pages; root page uses Space Grotesk/Manrope fonts, subpages use Inter.
- Analytics: PostHog via `posthog.js` on the root page; Google Ads tag + Vercel Analytics on `comingsoon/`.
- Do not restyle or rewrite existing copy above the fold; additive, below-the-fold changes only for marketing surfaces.