docs: entry pages, the renderer's scope, and llms files

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Wc67NX9MM964uaVGn4bpZJ

Author: TMHSDigital

CONTRIBUTING.md

@@ -31,9 +31,10 @@ One new markdown file is enough — the website rebuilds from frontmatter on dep
 6. For `status: active`, include an `## Evidence` line with a short quote from that page.
 7. Bump `expectedEntryCount` in [`site/config.json`](site/config.json) by the number of files you added (or lowered if you removed some).
 8. Run `node site/validate.mjs` — it must exit 0.
-9. Optional 2D/UI fields: `grid_dimensions`, `camera_perspective`, `hardware_tags`, `attribution_string` (see [`TEMPLATE.md`](catalog/TEMPLATE.md)).
-10. Add a row to the matching category `README.md`. This is required: the validator fails an entry that is not listed there, and the row's licence cell must match your frontmatter.
-11. Optional: add the `id` to `site/config.json` → `featured` to pin it under Safe starting points.
+9. Run `node site/build.mjs`. It renders your entry's page and fails if the body uses markdown the site does not support (tables, code fences, blockquotes, images, raw HTML, `###` headings, numbered lists) or links to a file that does not exist.
+10. Optional 2D/UI fields: `grid_dimensions`, `camera_perspective`, `hardware_tags`, `attribution_string` (see [`TEMPLATE.md`](catalog/TEMPLATE.md)).
+11. Add a row to the matching category `README.md`. This is required: the validator fails an entry that is not listed there, and the row's licence cell must match your frontmatter.
+12. Optional: add the `id` to `site/config.json` → `featured` to pin it under Safe starting points.
 
 ### Frontmatter rules
 

site/README.md

@@ -12,6 +12,7 @@ Static GitHub Pages UI for this catalog.
 | `site/config.json` → `featured` | Safe starting points table (`id` + `need`) |
 | `site/config.json` → `categories` / `guides` | Labels and guide links |
 | `site/public/*` | Page chrome / design |
+| An entry's body (Notes, Evidence) | Its page at `entry/<id>/` |
 
 ## Public JSON
 
@@ -26,12 +27,25 @@ and tools that want the metadata without scraping the page. The page itself load
   `subcategories`, `license`, `license_spdx` where set, `commercial`,
   `attribution_required`, `attribution_string` where set, `formats`, `tags`, `verified`,
   `status`, `publisher` where set, and the optional 2D fields), plus `path` (the entry's
-  file in this repo), `summary` (the first paragraph of its body), and two derived sort
+  file in this repo), `page` (the entry's page, relative to the site root), `summary` (the first paragraph of its body), and two derived sort
   fields, `attributionClass` and `licenseRank`.
 - It is regenerated from `catalog/` on every push to `main`. Field names are stable;
   new optional fields may appear. The licence facts are only as current as each entry's
   `verified` date: re-check the source before you ship on one.
 
+## Entry pages
+
+`build.mjs` writes `entry/<id>/index.html` for every entry from its frontmatter and
+body, using `site/lib/markdown.mjs`. The renderer supports exactly what entries use:
+`#` and `##` headings, paragraphs, bullet lists (nesting allowed), bold, `*italic*`,
+inline code, links and bare URLs. Underscores are literal. Anything else (tables,
+code fences, blockquotes, images, raw HTML, `###`, numbered lists) fails the build
+with the file and line, as does a relative link to a file that does not exist.
+
+The build also writes `llms.txt` (one line per entry) and `llms-full.txt` (with each
+entry's Notes) for AI assistants, and checks every generated page before it succeeds.
+Tests: `node site/lib/lib.test.mjs`.
+
 ## Social preview
 
 `docs/images/readme/og-card.png` is a 1200x630 screenshot of this site's first screen.