diff --git a/AGENTS.md b/AGENTS.md
index 5535aed..81a4313 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -108,7 +108,14 @@ not for the public pages. See `docs/design-principles.md` for the design.
rendering straight from the `Data.menu` tree (siblings sorted by
`Node.order`; nav links to content-less labels point at their first
child via `first_leaf`, the first published descendant with content),
- and page/404 rendering. If the markdown contains its own h1, the page title
+ and page/404 rendering. Content pages get SEO/social meta (description,
+ canonical link, Open Graph + twitter card) from heuristics over the
+ rendered article: the description is the first paragraph's text, the
+ share image prefers a `{.hero}`-classed image, then the first raster
+ `
`, then the first SVG; the first `