docs: public demo sites with a before-and-after page

README.md

@@ -55,8 +55,16 @@ browser) and whether each is installed and logged in. Every script prints `--hel
 ![45 WordPress sites converted to static Astro: average run time 83 minutes, design parity passed on 45 of 45, Google PageSpeed performance 74 to 98 on mobile and 87 to 99 on desktop](docs/examples/results.png)
 
 Averages over 45 WordPress conversions run with the kit, intake to pull request. Every run passed
-the pixel-parity review at all three widths. Public demo sites, with their before and after
-screenshots and the full gate output, are being added to [docs/examples](docs/examples/README.md).
+the pixel-parity review at all three widths.
+
+Public demos, converted by a coding agent following the skills as published:
+[sxsw.com](https://sxsw-com-astro-v2.vercel.app) (WordPress VIP, block theme, 71 pages) and
+[harvard.edu](https://harvard-edu-astro.vercel.app) (WordPress multisite, 457 pages). Drag between
+the live page and the Astro build on the
+[before and after page](https://astro-conversion-kit-demos.vercel.app); the counts, timings and
+screenshots are in [docs/examples](docs/examples/README.md).
+
+![sxsw.com /about/ at 1440 px: the live WordPress page on the left, the Astro build on the right, 0.00 % of pixels differ](docs/examples/sxsw-about-1440.png)
 
 ## What happens
 

docs/examples/README.md

@@ -17,7 +17,72 @@ following `convert-site`:
 
 ## Public demo sites
 
-Per-site write-ups are being added here as public demo conversions finish. Each will give the
-numbers the run recorded (from the converted repository's `baseline/`, `review/` and
-`.conversion/state.json`), the home page before and after at 390 and 1440 px, the staging URL, and
-the launch skills' "Not covered" sections quoted in full.
+Two WordPress sites converted by a coding agent following the skills as published, shown as
+the runs left them. Each has a public Astro build on Vercel (a noindexed staging deploy) and a
+before-and-after page where you drag between the live page and the Astro build. The screenshots
+on that page are the ones the kit's visual review took during the run, not retaken, and each
+pair carries the review's pixel-diff percentage for that page and width.
+
+**Before and after:** https://astro-conversion-kit-demos.vercel.app
+
+The numbers below are read from each converted repository: `.conversion/state.json` for the
+phase results and timings, `baseline/` for the counts, `review/diff/diff.json` for the pixel
+diffs. Agent time is the time the agent spent working, intake to pull request; both runs also
+sat idle for a while on an API rate limit, and that pause is not counted.
+
+### sxsw.com
+
+WordPress on WordPress VIP, block theme with the Interactivity API, Osano consent manager.
+
+| | |
+|---|---|
+| Astro build | https://sxsw-com-astro-v2.vercel.app |
+| Before and after | https://astro-conversion-kit-demos.vercel.app/#sxsw |
+| Pages | 71 (82 captured URLs; 11 answer 404 on live and are reproduced) |
+| Redirects | 83 |
+| Media | 916 files, 2.0 GB |
+| Templates | 26 |
+| Agent time | 1 h 35 min |
+
+![sxsw.com /about/ at 1440 px, top of the page: the live WordPress page on the left, the Astro build on the right](sxsw-about-1440.png)
+
+`/about/` at 1440 px: live on the left, Astro on the right, 0.00 % of pixels differ.
+
+### harvard.edu
+
+WordPress multisite, classic theme. The run converted the main site and left the sub-sites that
+run as their own installs (`/president/`, `/media-relations/`) out by prefix.
+
+| | |
+|---|---|
+| Astro build | https://harvard-edu-astro.vercel.app |
+| Before and after | https://astro-conversion-kit-demos.vercel.app/#harvard |
+| Pages | 457 (461 captured URLs; 4 answer 404 on live and are reproduced) |
+| Redirects | 417 |
+| Media | 2,537 files, 563 MB |
+| Templates | 30 |
+| Agent time | 4 h 01 min |
+
+![harvard.edu /ai/ at 1440 px, top of the page: the live WordPress page on the left, the Astro build on the right](harvard-ai-1440.png)
+
+`/ai/` at 1440 px: live on the left, Astro on the right, 0.00 % of pixels differ.
+
+### angrybirds.com
+
+WordPress on WP Engine behind Cloudflare, converted in a separate run with the media library
+(15,715 files) stored in Vercel Blob at the original paths.
+
+| | |
+|---|---|
+| Astro build | https://angrybirds-com.vercel.app |
+| Pages | 388 |
+| Redirects | 2 |
+| Media | 15,715 files in Vercel Blob, 102 theme and plugin files in the repo |
+| Templates | 23 clusters, built as 8 layouts |
+
+## What a demo is not
+
+A demo is a staging deploy of the converted site, noindexed, with forms pointed at a placeholder
+endpoint and nothing launched. The demo sites are not affiliated with the organisations whose
+public pages they reproduce, and they exist to show what the kit produces from a live site, not
+to serve those sites' visitors.