create-ailk 0.6.1 → 0.7.0

package/site-templates/marketing-site-free/TEMPLATE-MANIFEST.md

@@ -16,13 +16,13 @@
 
 ## 1. Chrome (every page)
 
-| Piece            | Component                                                | Props that matter                                                                                                                                                                                                               | Status                                                                                               |
-| ---------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
-| Shell            | `MarketingShell`                                         | `gutters="plain"`, `contentOwnsMain`, `bannerPlacement="above-nav"`                                                                                                                                                             | ✅                                                                                                   |
-| Announcement bar | `Banner` (chrome)                                        | `variant="contrast"`, `routes={{ include: ["/"] }}` — **home only**, no dismiss                                                                                                                                                 | ✅ · 🔧 #5558 message colour                                                                         |
-| Nav              | `Nav` → `BrandLogo` (mark + wordmark, mark-only < md)    | items: Product (flyout: How it works · Features · FAQ) · How it works · Pricing · About; actions: Get started (primary → `/contact`), Sign in (outline → `/sign-in`); `showThemeToggle={false}`; mobile = mark + hamburger only | ✅                                                                                                   |
-| Footer           | `Footer` → `FooterBottomBar`                             | columns: Site pages · Product · Legal · Subscribe (`Newsletter` block); bottom bar: theme toggle · © 2026 SalesSmyth LLC · Privacy Policy · Terms of Service · social ×5 · `LocaleSwitcher`                                     | ✅ bar · 🟡 columns + subscribe · 🔧 `LanguageSwitcher` client wrapper is scaffold code, not a block |
-| Cookie consent   | `Banner variant="info"` + `BannerConsentIsland` (bottom) | consent copy from `messages/en.json`; hidden on the sample                                                                                                                                                                      | 🔧 #5557                                                                                             |
+| Piece            | Component                                                | Props that matter                                                                                                                                                                                                                                                                                                                             | Status                                                                                               |
+| ---------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| Shell            | `MarketingShell`                                         | `gutters="none"` (#6536 — no gutter frame, so header/sections/footer share one left/right edge), `contentOwnsMain`, `bannerPlacement="above-nav"`                                                                                                                                                                                             | ✅                                                                                                   |
+| Announcement bar | `Banner` (chrome)                                        | `variant="contrast"`, `routes={{ include: ["/"] }}` — **home only**, no dismiss; **off by default** (#6469), on with `layout.announcementBanner: true`                                                                                                                                                                                        | ✅ · 🔧 #5558 message colour                                                                         |
+| Nav              | `Nav` → `BrandLogo` (mark + wordmark, mark-only < md)    | items: Product (flyout: How it works · Features · FAQ) · How it works · Pricing · About; actions: Get started (primary → `/contact`), Sign in (outline → `/sign-in`); `showThemeToggle={false}`; mobile = mark + hamburger only; `frame="contained"` (#6536 — puts the header row on the section Container's edge, matching `gutters="none"`) | ✅                                                                                                   |
+| Footer           | `Footer` → `FooterBottomBar`                             | columns: Site pages · Product · Legal · Subscribe (`Newsletter` block); bottom bar: theme toggle · © 2026 SalesSmyth LLC · Privacy Policy · Terms of Service · social ×5 · `LocaleSwitcher`; `bottomBarAlign="content"` (#6536 — puts the footer divider on the same edge, forwarded to `FooterBottomBar`'s own `bleed={false}`)              | ✅ bar · 🟡 columns + subscribe · 🔧 `LanguageSwitcher` client wrapper is scaffold code, not a block |
+| Cookie consent   | `Banner variant="info"` + `BannerConsentIsland` (bottom) | consent copy from `messages/en.json`; hidden on the sample                                                                                                                                                                                                                                                                                    | 🔧 #5557                                                                                             |
 
 ### Layout knobs (#5612)
 
@@ -39,77 +39,123 @@ The template's `layout` block — resolved with `resolveSiteChrome`, defaults fi
 
 <!-- generated:end -->
 
+### Theme (locked)
+
+The template's `theme:` block as `_site.mdx` declares it — the shape knobs and the colour overlay. Generated, so a change to a locked template's look is a red `manifest:check`, not a silent drift (starter-template contract R3.5).
+
+<!-- generated:begin theme -->
+
+| Setting                  | Value      |
+| ------------------------ | ---------- |
+| `corners`                | `square`   |
+| `eyebrowCase`            | `sentence` |
+| `placeholders`           | `fill`     |
+| `checkmarks`             | `plain`    |
+| `colors.light.bg`        | `#ffffff`  |
+| `colors.light.bgMuted`   | `#ffffff`  |
+| `colors.light.surface`   | `#ffffff`  |
+| `colors.light.border`    | `#000000`  |
+| `colors.light.text`      | `#000000`  |
+| `colors.light.textMuted` | `#333333`  |
+| `colors.light.primary`   | `#000000`  |
+| `colors.light.primaryFg` | `#ffffff`  |
+| `colors.light.accent`    | `#000000`  |
+| `colors.dark.bg`         | `#000000`  |
+| `colors.dark.bgMuted`    | `#000000`  |
+| `colors.dark.surface`    | `#000000`  |
+| `colors.dark.border`     | `#ffffff`  |
+| `colors.dark.text`       | `#ffffff`  |
+| `colors.dark.textMuted`  | `#cccccc`  |
+| `colors.dark.primary`    | `#ffffff`  |
+| `colors.dark.primaryFg`  | `#000000`  |
+| `colors.dark.accent`     | `#ffffff`  |
+
+<!-- generated:end -->
+
 ## 2. Pages
 
 Sections are listed in render order. Components resolve through `component-catalog.json`; every section named here exists in `packages/ui` (§ 4). _Live_ = what the scaffold rendered on 2026-09-15; _Target_ = the standardissue-matched composition. **Corrected 2026-09-15** against the captured copy (`docs/research/standardissue-capture/copy/<slug>.txt`) after a prop-coverage check of every beat against `packages/validation/src/schemas/page-sections.ts`; three bounded fields the reproduction needs are commissioned in **#5576** (Hero `checklist`, Feature `actions`, CTA `closingLine`) and are marked 🔧 #5576 below.
 
-**Copy rule (Sam, 2026-09-15): verbatim, mad-lib style exactly.** Every headline, body, bullet, label and CTA is the reference's text from `copy/<slug>.txt`, braces included (`{outcome}`, `{Primary CTA}`, `{Social Proof goes here}`). Lorem ipsum stays lorem ipsum where the reference has it. Nothing is paraphrased, shortened or "improved"; the operator rewrites the copy after the match is achieved. Only chrome text differs (§ 1).
+**Copy rule (Sam, 2026-09-15): verbatim, mad-lib style exactly.** Every headline, body, bullet, label and CTA is the reference's text from `copy/<slug>.txt`, braces included (`{outcome}`, `{Primary CTA}`, `{Social Proof goes here}`). Lorem ipsum stays lorem ipsum where the reference has it. Nothing is paraphrased, shortened or "improved"; the operator rewrites the copy after the match is achieved. Only chrome text differs (§ 1). Superseded for the base and overlay pages by #6469 (operator, 2026-09-22): every fill-in slot is a `{brace}` instruction and every page carries the `PLACEHOLDER — REPLACE BEFORE LAUNCH` label.
 
 ### `/` — HomePage · schema `HomePage` · `MarketingShell` · chrome on
 
-Reference: `screenshots/home.png`, `copy/home.txt`. Nine page sections; the newsletter and the blog list on the reference are in its footer, not the page (§ 1).
+Reference: `screenshots/home.png`, `copy/home.txt`. Ten page sections; the newsletter and the blog list on the reference are in its footer, not the page (§ 1).
 
 <!-- generated:begin page=/ -->
 
-| #   | Section                                                      | Component       | Copy (first line)                                  |
-| --- | ------------------------------------------------------------ | --------------- | -------------------------------------------------- |
-| 1   | `hero` (split · checklist ×3 · 2 CTAs · closingLine)         | `Hero`          | How to get {outcome} without {problem}             |
-| 2   | `logoCloud` (logos ×6)                                       | `LogoCloud`     | Don’t just take our word for it                    |
-| 3   | `decision-split` (panels ×2)                                 | `DecisionSplit` | There's a better way to {fix problem / get result} |
-| 4   | `feature` (eyebrow "Core Features" · features ×5 · 2 CTAs)   | `Feature`       | Everything you need to {achieve a desired outcome} |
-| 5   | `cta` (2 CTAs)                                               | `CTA`           | Direct integrations with your favorite tools       |
-| 6   | `stair-steps` (tiles ×3)                                     | `StairSteps`    | Get setup in {number} easy steps                   |
-| 7   | `cta` (box · chips ×3 · 2 CTAs · closingLine)                | `CTA`           | Switch to {your product} in {time amount} or less  |
-| 8   | `content-block` (media-right · eyebrow "Manifesto" · 2 CTAs) | `ContentBlock`  | We want you to {ability they couldn't do before}   |
-| 9   | `video-section` (1 CTA · playBadge)                          | `VideoSection`  | See {your product} in action                       |
+| #   | Section                                                                                                                | Component       | Copy (first line)                                  |
+| --- | ---------------------------------------------------------------------------------------------------------------------- | --------------- | -------------------------------------------------- |
+| 1   | `hero` (illustration · imagerySlot=true · checklist ×3 · 2 CTAs · closingLine)                                         | `Hero`          | {How to get outcome without problem}               |
+| 2   | `logoCloud` (layout=inline · logos ×3)                                                                                 | `LogoCloud`     | Don’t just take our word for it                    |
+| 3   | `decision-split` (imagerySlot=true · eyebrow "Comparison" · panels ×2)                                                 | `DecisionSplit` | {There's a better way to fix problem / get result} |
+| 4   | `feature` (itemStyle=plain · actionsPosition=below · eyebrow "Core Features" · features ×5 · 2 CTAs)                   | `Feature`       | {Everything you need to achieve a desired outcome} |
+| 5   | `cta` (minimal · eyebrow "Integrations" · 2 CTAs)                                                                      | `CTA`           | Direct integrations with your favorite tools       |
+| 6   | `media-band` (imagerySlot=true)                                                                                        | `MediaBand`     |                                                    |
+| 7   | `feature` (itemStyle=plain · actionsPosition=below · imagerySlot=true · eyebrow "How It Works" · features ×3 · 2 CTAs) | `Feature`       | {Get set up in number easy steps}                  |
+| 8   | `cta` (box · imagerySlot=true · checklist ×3 · 2 CTAs · closingLine)                                                   | `CTA`           | {Switch to your product in time amount or less}    |
+| 9   | `content-block` (media-right · imagerySlot=true · eyebrow "Manifesto" · 2 CTAs)                                        | `ContentBlock`  | {We want you to ability they couldn't do before}   |
+| 10  | `content-block` (eyebrow "{Your Product} Demo" · 2 CTAs)                                                               | `ContentBlock`  | {See your product in action}                       |
 
 <!-- generated:end -->
 
-### `/how-it-works` — LandingPage · schema `WebPage` · chrome on
+### `/use-cases` — UseCasesList · schema `CollectionPage` · chrome on
+
+Rendered by the `/use-cases` route over `content/en/UseCasesList/use-cases.mdx` — a UseCasesList page composing `sections[]` (operator ruling 2026-09-23), emitting the UseCasesList builder's `CollectionPage`. Since #6658 D4 it is a real list: one `items` section of three cards, each linking a `UseCase` page and titled with that page's title, so the `ItemList` names the three pages. The how-it-works steps moved to the product page.
+
+<!-- generated:begin page=/use-cases -->
+
+| #   | Section                                                  | Component      | Copy (first line)                                                 |
+| --- | -------------------------------------------------------- | -------------- | ----------------------------------------------------------------- |
+| 1   | `hero` (eyebrow "Use cases" · 2 CTAs)                    | `Hero`         | {Use cases: who your product is for}                              |
+| 2   | `items` (columns=3 · items ×3)                           | `Items`        | {The jobs customers hire your product to do}                      |
+| 3   | `logoCloud` (layout=inline · logos ×6)                   | `LogoCloud`    | Don’t just take our word for it                                   |
+| 4   | `testimonials` (quote · items ×1)                        | `Testimonials` | {A customer quote, in their own words, about the result they got} |
+| 5   | `cta` (box · checklist ×3 · 2 CTAs · closingLine)        | `CTA`          | {Switch to your product in time amount or less}                   |
+| 6   | `faq` (accordion · items ×5 · 1 CTA · initialOpen first) | `FAQ`          | FAQs                                                              |
+
+<!-- generated:end -->
 
-Reference: `screenshots/how-it-works.png`, `copy/how-it-works.txt`. Rendered by the generic `[slug]` route over `content/en/LandingPage/how-it-works.mdx`, emitting the LandingPage builder's `WebPage`. (`WebPage` is a schema.org @type the registry emits, not a content type the adapter accepts — the `[slug]` route's own header comment records why. A `schema` override to `HowTo` is refused by the scaffold's own `structured-data` gate, which validates every LandingPage as `WebPage`.)
+### `/use-cases/<slug>` — UseCase · schema `WebPage` → `Article` · chrome on
 
-<!-- generated:begin page=/how-it-works -->
+Three placeholder use cases from the base layer (#6658 D4): `first-use-case`, `second-use-case` and `third-use-case`, rendered as prose by the `/use-cases/[slug]` route.
 
-| #   | Section                                                        | Component      | Copy (first line)                                                      |
-| --- | -------------------------------------------------------------- | -------------- | ---------------------------------------------------------------------- |
-| 1   | `hero` (eyebrow "How it Works" · 2 CTAs)                       | `Hero`         | Get set up in {number} easy steps                                      |
-| 2   | `feature` (alternating · numbered · features ×3)               | `Feature`      | The first thing they need to do to get the outcome they want           |
-| 3   | `logoCloud` (logos ×6)                                         | `LogoCloud`    | Don’t just take our word for it                                        |
-| 4   | `testimonials` (featured · items ×1)                           | `Testimonials` | Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse … |
-| 5   | `cta` (box · chips ×3 · 2 CTAs · closingLine)                  | `CTA`          | Switch to {your product} in {time amount} or less                      |
-| 6   | `faq` (accordion · items ×5 · supportLink · initialOpen first) | `FAQ`          | FAQs                                                                   |
+<!-- generated:begin page=/use-cases/[slug] -->
 
+_Detail route over `content/en/UseCase/` — 3 seed pages: `first-use-case.mdx`, `second-use-case.mdx`, `third-use-case.mdx`._
 <!-- generated:end -->
 
-### `/features` — LandingPage · schema `WebPage` · chrome on
+### `/software` — code route (the product listing) · chrome on
+
+Lists every `SoftwareProduct` page by slug. The route is core since #6658: the product's own page replaced the `/features` stand-in, so every scaffold carries it.
 
-Reference: `screenshots/features.png`, `copy/features.txt`. Rendered by the `[slug]` route over `content/en/LandingPage/features.mdx`. No hero: the page opens on the feature grid.
+<!-- generated:begin page=/software -->
 
-<!-- generated:begin page=/features -->
+_Code route — no content, no sections._
+<!-- generated:end -->
 
-| #   | Section                                           | Component | Copy (first line)                                 |
-| --- | ------------------------------------------------- | --------- | ------------------------------------------------- |
-| 1   | `feature` (eyebrow "Core Features" · features ×5) | `Feature` | Medium length section heading goes here           |
-| 2   | `cta` (2 CTAs)                                    | `CTA`     | Direct integrations with your favorite tools      |
-| 3   | `cta` (box · chips ×3 · 2 CTAs · closingLine)     | `CTA`     | Switch to {your product} in {time amount} or less |
+### `/software/<slug>` (seed: `/software/product`) — SoftwareProduct · schema `WebPage` → `SoftwareApplication` · chrome on
 
+Reference: `screenshots/features.png`, `copy/features.txt`, plus the how-it-works steps. The product's own detail page (#6658 D3), rendered by the `/software/[slug]` route over `content/en/SoftwareProduct/product.mdx`. Its JSON-LD is a `WebPage` whose `mainEntity` is a `SoftwareApplication` named by the page title; its feature titles become the site's `featureList` when `_site.mdx` declares a `SoftwareApplication` secondary. It carries the former `/features` sections, with their links re-pointed to in-page anchors, and the how-it-works steps that moved off `/use-cases` (the brief's "how-it-works folds into the product page"). The nav's Features links and the home page's feature links point here.
+
+<!-- generated:begin page=/software/[slug] -->
+
+_Detail route over `content/en/SoftwareProduct/` — 1 seed page: `product.mdx`._
 <!-- generated:end -->
 
 ### `/pricing` — Pricing · schema `Pricing` · chrome on
 
-Reference: `screenshots/pricing.png`, `copy/pricing.txt`. The reference opens on a hero (eyebrow Pricing, the headline, two CTAs) ABOVE the plans section, which repeats the headline — composed as the reference and the copy have it. Route enabled by the roster (#5469 D10).
+Reference: `screenshots/pricing.png`, `copy/pricing.txt`. The reference opens on a hero that repeats the plans section's own eyebrow/headline/subtitle; the template drops that hero (operator, 2026-09-23) and the plans section leads the page and owns its `<h1>` (`ownsPageTitle`). Route enabled by the roster (#5469 D10).
 
 <!-- generated:begin page=/pricing -->
 
-| #   | Section                                                                            | Component      | Copy (first line)                                                      |
-| --- | ---------------------------------------------------------------------------------- | -------------- | ---------------------------------------------------------------------- |
-| 1   | `hero` (eyebrow "Pricing" · 2 CTAs)                                                | `Hero`         | Pays for itself in {tangible value or outcome}                         |
-| 2   | `pricing` (three-tiers-with-toggle · eyebrow "Pricing" · plans ×3 · billingToggle) | `Pricing`      | Pays for itself in {tangible value or outcome}                         |
-| 3   | `logoCloud` (logos ×6)                                                             | `LogoCloud`    | Don’t just take our word for it                                        |
-| 4   | `testimonials` (featured · items ×1)                                               | `Testimonials` | Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse … |
-| 5   | `cta` (box · chips ×3 · 2 CTAs · closingLine)                                      | `CTA`          | Switch to {your product} in {time amount} or less                      |
-| 6   | `faq` (accordion · items ×5 · supportLink · initialOpen first)                     | `FAQ`          | FAQs                                                                   |
+| #   | Section                                                                                                  | Component      | Copy (first line)                                                 |
+| --- | -------------------------------------------------------------------------------------------------------- | -------------- | ----------------------------------------------------------------- |
+| 1   | `pricing` (three-tiers-with-toggle · cardLayout=centered · eyebrow "Pricing" · plans ×3 · billingToggle) | `Pricing`      | {Pays for itself in tangible value or outcome}                    |
+| 2   | `logoCloud` (layout=inline · logos ×3)                                                                   | `LogoCloud`    | Don’t just take our word for it                                   |
+| 3   | `testimonials` (quote · items ×1)                                                                        | `Testimonials` | {A customer quote, in their own words, about the result they got} |
+| 4   | `cta` (box · checklist ×3 · 2 CTAs · closingLine)                                                        | `CTA`          | {Switch to your product in time amount or less}                   |
+| 5   | `faq` (accordion · items ×5 · 1 CTA · initialOpen none)                                                  | `FAQ`          | FAQs                                                              |
 
 <!-- generated:end -->
 
@@ -119,14 +165,13 @@ Reference: `screenshots/about.png`, `copy/about.txt`. No hero: the page opens on
 
 <!-- generated:begin page=/about -->
 
-| #   | Section                                                        | Component      | Copy (first line)                                                      |
-| --- | -------------------------------------------------------------- | -------------- | ---------------------------------------------------------------------- |
-| 1   | `content-block` (media-right · eyebrow "Manifesto" · 2 CTAs)   | `ContentBlock` | We want you to {ability they couldn't do before}                       |
-| 2   | `team` (members ×5)                                            | `Team`         | Our team                                                               |
-| 3   | `logoCloud` (logos ×6)                                         | `LogoCloud`    | Don’t just take our word for it                                        |
-| 4   | `testimonials` (featured · items ×1)                           | `Testimonials` | Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse … |
-| 5   | `cta` (box · chips ×3 · 2 CTAs · closingLine)                  | `CTA`          | Switch to {your product} in {time amount} or less                      |
-| 6   | `faq` (accordion · items ×5 · supportLink · initialOpen first) | `FAQ`          | FAQs                                                                   |
+| #   | Section                                                                     | Component      | Copy (first line)                                                 |
+| --- | --------------------------------------------------------------------------- | -------------- | ----------------------------------------------------------------- |
+| 1   | `content-block` (media-right · imagerySlot=true · eyebrow "About" · 2 CTAs) | `ContentBlock` | {We want you to ability they couldn't do before}                  |
+| 2   | `team` (with-side-images · eyebrow "Tagline" · members ×5)                  | `Team`         | Our team                                                          |
+| 3   | `testimonials` (quote · items ×1)                                           | `Testimonials` | {A customer quote, in their own words, about the result they got} |
+| 4   | `cta` (box · imagerySlot=true · checklist ×3 · 2 CTAs · closingLine)        | `CTA`          | {Switch to your product in time amount or less}                   |
+| 5   | `faq` (accordion · items ×5 · 1 CTA · initialOpen none)                     | `FAQ`          | FAQs                                                              |
 
 <!-- generated:end -->
 
@@ -136,11 +181,11 @@ No standardissue page; folded into the Product flyout. Copy: the reference's FAQ
 
 <!-- generated:begin page=/faq -->
 
-| #   | Section                                                        | Component | Copy (first line)                                                      |
-| --- | -------------------------------------------------------------- | --------- | ---------------------------------------------------------------------- |
-| 1   | `hero`                                                         | `Hero`    | FAQs                                                                   |
-| 2   | `faq` (accordion · items ×5 · supportLink · initialOpen first) | `FAQ`     | Vel odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas u… |
-| 3   | `cta` (box · chips ×3 · 2 CTAs · closingLine)                  | `CTA`     | Switch to {your product} in {time amount} or less                      |
+| #   | Section                                                 | Component | Copy (first line)                        |
+| --- | ------------------------------------------------------- | --------- | ---------------------------------------- |
+| 1   | `hero` (gapBelow=tight · eyebrow "FAQ")                 | `Hero`    | FAQs                                     |
+| 2   | `faq` (accordion · items ×5 · 1 CTA · initialOpen none) | `FAQ`     | {A question your customers actually ask} |
+| 3   | `faq` (accordion · items ×5 · 1 CTA · initialOpen none) | `FAQ`     | {A second group of questions}            |
 
 <!-- generated:end -->
 
@@ -150,28 +195,66 @@ Reference: `screenshots/contact.png`, `copy/contact.txt`. The reference is a spl
 
 <!-- generated:begin page=/contact -->
 
-| #   | Section                                               | Component      | Copy (first line)                                                      |
-| --- | ----------------------------------------------------- | -------------- | ---------------------------------------------------------------------- |
-| 1   | `hero` (split · eyebrow "Book a Demo" · checklist ×3) | `Hero`         | Ready to {achieve a valuable outcome}?                                 |
-| 2   | `contact-form` (card · fields ×3)                     | `ContactForm`  | Name · Email · Message                                                 |
-| 3   | `logoCloud` (logos ×6)                                | `LogoCloud`    | Don’t just take our word for it                                        |
-| 4   | `testimonials` (featured · items ×1)                  | `Testimonials` | Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse … |
+| #   | Section                                               | Component      | Copy (first line)                                                 |
+| --- | ----------------------------------------------------- | -------------- | ----------------------------------------------------------------- |
+| 1   | `hero` (split · eyebrow "Book a Demo" · checklist ×3) | `Hero`         | {Ready to achieve a valuable outcome?}                            |
+| 2   | `logoCloud` (layout=inline · logos ×6)                | `LogoCloud`    | Don’t just take our word for it                                   |
+| 3   | `testimonials` (quote · items ×1)                     | `Testimonials` | {A customer quote, in their own words, about the result they got} |
+
+<!-- generated:end -->
+
+### `/glossary` — GlossaryList · schema `CollectionPage` → `DefinedTermSet` · chrome on
+
+A base-layer seed every starter carries (#6658 D5): a hero, then a `glossary-index` of five placeholder terms, each a `DefinedTerm` in the page's `DefinedTermSet`. Linked from the footer's Resources column.
+
+<!-- generated:begin page=/glossary -->
+
+| #   | Section                             | Component       | Copy (first line)                            |
+| --- | ----------------------------------- | --------------- | -------------------------------------------- |
+| 1   | `hero` (eyebrow "Glossary" · 1 CTA) | `Hero`          | {Glossary: the terms your customers look up} |
+| 2   | `glossary-index` (columns)          | `GlossaryIndex` | {Terms, A to Z}                              |
+
+<!-- generated:end -->
+
+### `/newsletter` — NewsletterSignup · schema `WebPage` → `Offer` · chrome on
+
+A base-layer seed every starter carries (#6658 D5). The form posts to lead capture (`/v1/leads/subscribe`), which records a subscriber and sends no verification email. The frontmatter `schema:` names the free subscription as the page's `Offer`. Linked from the footer's Resources column.
+
+<!-- generated:begin page=/newsletter -->
+
+| #   | Section                               | Component    | Copy (first line)                                |
+| --- | ------------------------------------- | ------------ | ------------------------------------------------ |
+| 1   | `hero` (eyebrow "Newsletter" · 1 CTA) | `Hero`       | {Newsletter: what subscribers get and how often} |
+| 2   | `newsletter`                          | `Newsletter` | Subscribe                                        |
+| 3   | `faq` (expanded · items ×3)           | `FAQ`        | FAQs                                             |
 
 <!-- generated:end -->
 
-### `/blog` — LandingPage · schema `WebPage` · chrome on (Free teaser)
+### `/book-a-call` — BookCall · schema `WebPage` → `Offer` · chrome on
 
-Reference: `screenshots/blog.png`, `copy/blog.txt` for the opener and the newsletter. Free ships **one static page**: the reference's opener, a CTA to the Pro docs-blog module (the one non-verbatim block), the newsletter, and the reference's logo strip + testimonial. Pro replaces this route with the real listing by directory precedence (#5469 D3).
+A base-layer seed every starter carries (#6658 D5): a hero whose call to action is `/contact`, then what happens on the call. A template carrying the scheduling module overrides the seed so the call to action opens `/meet`. Linked from the footer's Site pages column.
+
+<!-- generated:begin page=/book-a-call -->
+
+| #   | Section                                | Component | Copy (first line)                          |
+| --- | -------------------------------------- | --------- | ------------------------------------------ |
+| 1   | `hero` (eyebrow "Book a call" · 1 CTA) | `Hero`    | {Book a call: what a visitor gets from it} |
+| 2   | `items` (columns=3 · items ×3)         | `Items`   | What happens on the call?                  |
+
+<!-- generated:end -->
+
+### `/blog` — BlogList · schema `Blog` · chrome on (Free teaser)
+
+Reference: `screenshots/blog.png`, `copy/blog.txt` for the opener and the newsletter. Free ships **one static page** with the correct page type — a BlogList (`content/en/BlogList/blog.mdx`, emitting the BlogList builder's `Blog` with an empty `ItemList`) served by the generic `[slug]` route, which probes BlogList after LandingPage: the reference's opener, a CTA to the Pro docs-blog module (the one non-verbatim block), the newsletter, and the reference's logo strip + testimonial. Pro replaces this route with the real listing by directory precedence (#5469 D3).
 
 <!-- generated:begin page=/blog -->
 
-| #   | Section                              | Component      | Copy (first line)                                                      |
-| --- | ------------------------------------ | -------------- | ---------------------------------------------------------------------- |
-| 1   | `hero` (centered · eyebrow "Blog")   | `Hero`         | Resources for {customer profile}                                       |
-| 2   | `cta` (2 CTAs)                       | `CTA`          | The blog listing ships with the Pro docs-blog module                   |
-| 3   | `newsletter`                         | `Newsletter`   | Stay Up to Date with our {fequency} Newsletter                         |
-| 4   | `logoCloud` (logos ×6)               | `LogoCloud`    | Don’t just take our word for it                                        |
-| 5   | `testimonials` (featured · items ×1) | `Testimonials` | Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse … |
+| #   | Section                                             | Component      | Copy (first line)                                                 |
+| --- | --------------------------------------------------- | -------------- | ----------------------------------------------------------------- |
+| 1   | `hero` (centered · gapBelow=tight · eyebrow "Blog") | `Hero`         | {Resources for customer profile}                                  |
+| 2   | `blog-list` (grid)                                  | `BlogList`     |                                                                   |
+| 3   | `logoCloud` (layout=inline · logos ×6)              | `LogoCloud`    | Don’t just take our word for it                                   |
+| 4   | `testimonials` (quote · items ×1)                   | `Testimonials` | {A customer quote, in their own words, about the result they got} |
 
 <!-- generated:end -->
 
@@ -184,6 +267,15 @@ Renders the `SignInCard` client island (providers from env) inside the locale la
 _Code route — no content, no sections._
 <!-- generated:end -->
 
+### `/sign-up` — code route (sign-up form) · chrome on
+
+The account-creation form inside the locale layout — a code route like `/sign-in`, listed so the manifest is a complete install record (#6646). No reference page.
+
+<!-- generated:begin page=/sign-up -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
 ### `/privacy`, `/terms` — PrivacyPage / TermsPage · schema same · chrome on
 
 Reference: `screenshots/legal--privacy-policy.png`, `copy/legal--*.txt`. Content ✅ (the `document-chassis` placeholder document, not re-authored — the two pages stay as #5565 shipped them). Route enabled by the roster (#5469 D10).
@@ -192,9 +284,9 @@ Reference: `screenshots/legal--privacy-policy.png`, `copy/legal--*.txt`. Content
 
 <!-- generated:begin page=/privacy -->
 
-| #   | Section                                                            | Component         | Copy (first line) |
-| --- | ------------------------------------------------------------------ | ----------------- | ----------------- |
-| 1   | `document-chassis` (eyebrow "PLACEHOLDER — REPLACE BEFORE LAUNCH") | `DocumentChassis` | Privacy Policy    |
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Privacy Policy    |
 
 <!-- generated:end -->
 
@@ -202,9 +294,21 @@ Reference: `screenshots/legal--privacy-policy.png`, `copy/legal--*.txt`. Content
 
 <!-- generated:begin page=/terms -->
 
-| #   | Section                                                            | Component         | Copy (first line) |
-| --- | ------------------------------------------------------------------ | ----------------- | ----------------- |
-| 1   | `document-chassis` (eyebrow "PLACEHOLDER — REPLACE BEFORE LAUNCH") | `DocumentChassis` | Terms of Service  |
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Terms of Service  |
+
+<!-- generated:end -->
+
+### `/purchase-policy` — `PurchasePolicyPage` (product shape) · chrome on
+
+One document-chassis page with the shape's policy sections — returns, shipping and refunds (#6646). Its Returns section makes the JSON-LD a `MerchantReturnPolicy` at `#return-policy`.
+
+<!-- generated:begin page=/purchase-policy -->
+
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Purchase Policy   |
 
 <!-- generated:end -->
 
@@ -212,25 +316,37 @@ Reference: `screenshots/legal--privacy-policy.png`, `copy/legal--*.txt`. Content
 
 Not a hub page by design (#3960). Free ships none because the contact form confirms inline. Listed so nobody re-files it.
 
+## 1b. Structured data (every page)
+
+Every content route emits one `application/ld+json` script whose `@graph` carries the site's own entity graph, built from `content/_site.mdx` `siteIdentity` — never from a page title (#6597):
+
+| Node                                                   | `@id`                                                                                         | Built from                                                                | Links                                                                                                                                                                                |
+| ------------------------------------------------------ | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Identity (`Organization` · `Person` · `LocalBusiness`) | `<origin>/#organization` (`#person` for a Person)                                             | `siteIdentity` `name` · `url` · `logo`/`image` · `description` · `sameAs` | —                                                                                                                                                                                    |
+| Secondary (optional)                                   | `<origin>/#product` (a `SoftwareApplication`) · `<origin>/#organization` (a Person's company) | `siteIdentity.secondary`                                                  | product `publisher` → `#organization`, `featureList` from the product page's (`/software/product`) feature items; a Person `worksFor` its company, which has the Person as `founder` |
+| `WebSite`                                              | `<origin>/#website`                                                                           | `siteName` · `baseUrl` · the render locale                                | `publisher` → the identity node                                                                                                                                                      |
+
+Each page's primary node is `isPartOf` the `WebSite`; the home page's `mainEntity` is the secondary when declared, else the identity. A testimonials `Review` points its `itemReviewed` at the identity node, declared in the same graph. Free declares no secondary, so a fresh site emits the Organization and the WebSite. `/sign-in` emits no JSON-LD.
+
 ## 2a. State and persistence (every interactive element)
 
 The template is content and config; the states live in the components. This table is what the local review clicks through (#5469 AC), per element: the states, where they persist, and what a returning visitor sees.
 
-| Element                                | States                                     | Persists in                                 | Returning visitor sees                | Empty / error state                                                                                        |
-| -------------------------------------- | ------------------------------------------ | ------------------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
-| Announcement banner (home only)        | shown; no dismiss                          | —                                           | shown on `/`, never elsewhere         | —                                                                                                          |
-| Cookie consent (`BannerConsentIsland`) | unset → shown; accepted; declined          | consent cookie (the island's)               | nothing until the cookie expires      | a blocked storage write leaves it shown                                                                    |
-| Theme toggle (footer)                  | light · dark · system                      | `data-theme` + localStorage (`ThemeToggle`) | last choice                           | falls back to system                                                                                       |
-| Locale switcher (footer)               | one of `NEXT_PUBLIC_ENABLED_LOCALES`       | `NEXT_LOCALE` cookie + the URL prefix       | last locale, unprefixed when default  | single-locale site shows one option                                                                        |
-| Nav (mobile)                           | closed · open (hamburger)                  | —                                           | closed                                | —                                                                                                          |
-| Product flyout (desktop)               | closed · open on hover/focus               | —                                           | closed                                | —                                                                                                          |
-| Contact form                           | idle · sending · success (inline) · error  | —                                           | idle                                  | validation errors per field; consent unchecked blocks submit                                               |
-| Newsletter (footer + `/blog`)          | idle · sending · success · error           | —                                           | idle                                  | the reference's two lines: "Thank you! Your submission has been received!" / "Oops! Something went wrong…" |
-| Pricing billing toggle                 | monthly · yearly                           | —                                           | monthly                               | —                                                                                                          |
-| FAQ accordion                          | per item open/closed (`initialOpen`)       | —                                           | first open                            | no items → section hidden                                                                                  |
-| Video section                          | poster · playing (`playBadge`)             | —                                           | poster                                | missing asset → poster only                                                                                |
-| Sign-in card                           | providers listed · magic-link sent · error | session cookie (auth)                       | signed in → redirected by `next-path` | no provider configured → honest empty state                                                                |
-| Legal document chassis                 | contents nav scroll position               | —                                           | top                                   | —                                                                                                          |
+| Element                                | States                                             | Persists in                                 | Returning visitor sees                 | Empty / error state                                                                                        |
+| -------------------------------------- | -------------------------------------------------- | ------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| Announcement banner (home only)        | off by default (#6469); when on: shown, no dismiss | —                                           | when on: shown on `/`, never elsewhere | —                                                                                                          |
+| Cookie consent (`BannerConsentIsland`) | unset → shown; accepted; declined                  | consent cookie (the island's)               | nothing until the cookie expires       | a blocked storage write leaves it shown                                                                    |
+| Theme toggle (footer)                  | light · dark · system                              | `data-theme` + localStorage (`ThemeToggle`) | last choice                            | falls back to system                                                                                       |
+| Locale switcher (footer)               | one of `NEXT_PUBLIC_ENABLED_LOCALES`               | `NEXT_LOCALE` cookie + the URL prefix       | last locale, unprefixed when default   | single-locale site shows one option                                                                        |
+| Nav (mobile)                           | closed · open (hamburger)                          | —                                           | closed                                 | —                                                                                                          |
+| Product flyout (desktop)               | closed · open on hover/focus                       | —                                           | closed                                 | —                                                                                                          |
+| Contact form                           | idle · sending · success (inline) · error          | —                                           | idle                                   | validation errors per field; consent unchecked blocks submit                                               |
+| Newsletter (footer + `/blog`)          | idle · sending · success · error                   | —                                           | idle                                   | the reference's two lines: "Thank you! Your submission has been received!" / "Oops! Something went wrong…" |
+| Pricing billing toggle                 | monthly · yearly                                   | —                                           | monthly                                | —                                                                                                          |
+| FAQ accordion                          | per item open/closed (`initialOpen`)               | —                                           | first open                             | no items → section hidden                                                                                  |
+| Video section                          | poster · playing (`playBadge`)                     | —                                           | poster                                 | missing asset → poster only                                                                                |
+| Sign-in card                           | providers listed · magic-link sent · error         | session cookie (auth)                       | signed in → redirected by `next-path`  | no provider configured → honest empty state                                                                |
+| Legal document chassis                 | contents nav scroll position                       | —                                           | top                                    | —                                                                                                          |
 
 ## 3. Roster, as the registry declares it
 
@@ -240,33 +356,80 @@ The template is content and config; the states live in the components. This tabl
 marketing-site-free:
   requires: [marketing]
   categories: [accounting, legal, technology]
+  shape: organization-product
+  design: standard
   roster:
-    - { route: "/",             content: ["content/en/HomePage/home.mdx"] }
-    - { route: "/how-it-works", content: ["content/en/LandingPage/how-it-works.mdx"] }
-    - { route: "/features",     content: ["content/en/LandingPage/features.mdx"] }
-    - { route: "/pricing",      content: ["content/en/Pricing/pricing.mdx"] }
-    - { route: "/about",        content: ["content/en/AboutPage/about.mdx"] }
-    - { route: "/faq",          content: ["content/en/FAQPage/faq.mdx"] }
-    - { route: "/contact",      content: ["content/en/ContactPage/contact.mdx"] }
-    - { route: "/sign-in" }
-    - { route: "/privacy",      content: ["content/en/PrivacyPage/privacy.mdx"] }
-    - { route: "/terms",        content: ["content/en/TermsPage/terms.mdx"] }
-    - { route: "/blog",         content: ["content/en/LandingPage/blog.mdx"] }
+    - { route: "/",                 kind: page, content: ["content/en/HomePage/home.mdx"] }
+    - { route: "/software",         kind: route }
+    - { route: "/software/[slug]",  kind: page, contentDir: "content/en/SoftwareProduct" }
+    - { route: "/use-cases",        kind: page, content: ["content/en/UseCasesList/use-cases.mdx"] }
+    - { route: "/use-cases/[slug]", kind: page, contentDir: "content/en/UseCase" }
+    - { route: "/pricing",          kind: page, content: ["content/en/Pricing/pricing.mdx"] }
+    - { route: "/about",            kind: page, content: ["content/en/AboutPage/about.mdx"] }
+    - { route: "/faq",              kind: page, content: ["content/en/FAQPage/faq.mdx"] }
+    - { route: "/contact",          kind: page, content: ["content/en/ContactPage/contact.mdx"] }
+    - { route: "/glossary",         kind: page, content: ["content/en/GlossaryList/glossary.mdx"] }
+    - { route: "/newsletter",       kind: page, content: ["content/en/NewsletterSignup/newsletter.mdx"] }
+    - { route: "/book-a-call",      kind: page, content: ["content/en/BookCall/book-call.mdx"] }
+    - { route: "/sign-in",          kind: route }
+    - { route: "/sign-up",          kind: route }
+    - { route: "/privacy",          kind: page, content: ["content/en/PrivacyPage/privacy.mdx"] }
+    - { route: "/terms",            kind: page, content: ["content/en/TermsPage/terms.mdx"] }
+    - { route: "/purchase-policy",  kind: page, content: ["content/en/PurchasePolicyPage/purchase-policy.mdx"] }
+    - { route: "/blog",             kind: page, content: ["content/en/BlogList/blog.mdx"] }
 ```
 
 <!-- generated:end -->
 
-All eleven rows are declared on the registry (`TEMPLATE_BASE_ROSTER` + the Free `/blog` teaser row, #5469 D3/D4), so the template is one declared page set whichever mechanism scaffolds each: the always-copied overlay for the core pages, `site-templates/marketing-site-free/content/**` for the three module-less ones.
+All eighteen rows are declared on the registry (`TEMPLATE_BASE_ROSTER` + the Free `/blog` teaser row, #5469 D3/D4, re-derived by #6658), so the template is one declared page set whichever mechanism scaffolds each: the always-copied overlay for the core pages, `site-templates/_base/content/**` for the module-less ones and the three use cases. The scaffold carries this roster as `.ailk-site-manifest.json` at its root (#6658 D7); this Markdown stays in the template.
+
+### 3a. Deviations from the standard roster (recorded, #6658)
+
+The roster is the standard page set for this template's shape, edited only by
+the rows below. The standard set is the `page_type` column of
+`python3 scripts/derive-roster.py --entity-type software --offering-type software --primary-goal convert --scale global --registry packages/schema/src/registry/entries.ts`
+(20 rows, `mainEntity: SoftwareApplication`) — the `--shape organization-product`
+invocation once claude-setup#9145's `--shape` flag is vendored into this repo.
+The roster's page rows equal that set minus the dropped rows, plus the added
+rows (`R = (S − D) ∪ A`). This supersedes the 2026-09-23 disposition, whose
+three omissions (`GlossaryList`, `BookCall`, `NewsletterSignup`) the brief
+reversed (`docs/decisions/starter-roster-page-set.md` D4, D7).
+
+**Standard rows dropped:**
+
+| Standard row       | Reason                                                                                                             |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
+| `IntegrationsList` | a placeholder starter has no integrations to list                                                                  |
+| `Integration`      | a placeholder starter has no integrations to list                                                                  |
+| `CoursesList`      | there is no course offering                                                                                        |
+| `Course`           | there is no course offering                                                                                        |
+| `CaseStudiesList`  | proof pages need real customers; the use-cases page carries one placeholder testimonial and one logo strip instead |
+| `CaseStudy`        | proof pages need real customers; the use-cases page carries one placeholder testimonial and one logo strip instead |
+| `TestimonialsList` | proof pages need real customers; the use-cases page carries one placeholder testimonial and one logo strip instead |
+| `ClientsList`      | proof pages need real customers; the use-cases page carries one placeholder testimonial and one logo strip instead |
+
+**Rows added:**
+
+| Added row                           | Reason                                                                                                                                                                                                          |
+| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `SoftwareProduct`                   | the single product's own detail page — the standard's multi-product opt-in, taken by the one product                                                                                                            |
+| `PurchasePolicyPage`                | the product-shape purchase policy every shape carries (#6646 D3)                                                                                                                                                |
+| `BlogList` (the `/blog` teaser)     | the standard's `convert` goal carries no blog (`blog_enabled: false`); the Free teaser stays by operator ruling 2026-09-24, and where the docs-blog module is present its own `BlogList` serves `/blog` instead |
+| `/software`, `/sign-in`, `/sign-up` | code routes (`kind: route`): the product listing and the two auth pages carry no page type of their own                                                                                                         |
+
+### 3b. Site entity (operator-disposed 2026-09-24)
+
+`derive-roster.py` names `SoftwareApplication` as the main entity for this template's inputs. The template deliberately declares the **Organization** as the site's primary node and the software as its **secondary** node (`siteIdentity.secondary`, kind `SoftwareApplication`, #6597): the Free template is a company's own site about its product, so the entity the site is _about_ is the maker. The inverse — `SoftwareApplication` primary — is for a product whose canonical site is elsewhere (Positionary, whose maker has its own site). A fresh Free scaffold declares no `secondary` until the owner names the product; the overlay `_site.mdx` documents the field.
 
 ## 4. Component inventory (Free, by tier)
 
 <!-- generated:begin inventory -->
 
-| Tier     | Used by this template                                                                                                                                                                          |
-| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Shell    | `MarketingShell`                                                                                                                                                                               |
-| Chrome   | `Nav`, `Footer`, `Banner` (+ `BannerConsentIsland`, `BannerDismissIsland`)                                                                                                                     |
-| Sections | `ContactForm`, `ContentBlock`, `CTA`, `DecisionSplit`, `DocumentChassis`, `FAQ`, `Feature`, `Hero`, `LogoCloud`, `Newsletter`, `Pricing`, `StairSteps`, `Team`, `Testimonials`, `VideoSection` |
+| Tier     | Used by this template                                                                                                                                                                                |
+| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Shell    | `MarketingShell`                                                                                                                                                                                     |
+| Chrome   | `Nav`, `Footer`, `Banner` (+ `BannerConsentIsland`, `BannerDismissIsland`)                                                                                                                           |
+| Sections | `BlogList`, `ContentBlock`, `CTA`, `DecisionSplit`, `DocumentChassis`, `FAQ`, `Feature`, `GlossaryIndex`, `Hero`, `Items`, `LogoCloud`, `MediaBand`, `Newsletter`, `Pricing`, `Team`, `Testimonials` |
 
 <!-- generated:end -->
 
@@ -284,3 +447,20 @@ Every section above already exists in `packages/ui`; the reproduction is composi
 | Footer columns + subscribe not composed on the default path                                  | this template's build        |
 | `/meet` rename (Pro)                                                                         | #5563                        |
 | `ReportPage` (Pro)                                                                           | #5562                        |
+| CTA `box` variant's checklist + imagery-slot split (the product page's switch box)           | #6526                        |
+
+## 6. Not included (starter-template contract R2.4)
+
+Named so nothing is assumed. Each is a scaffold-time or post-launch addition, not a gap in this template.
+
+| Not included                       | What the template does instead                                                                                     |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| Email delivery of form submissions | the contact form persists in file mode (`AILK_LOCAL_LEAD_CAPTURE`) or to the leads API; no mail is sent            |
+| Newsletter backend                 | the footer Subscribe block is composed but posts nowhere until the owner wires a provider (§ 5)                    |
+| Translated content                 | one locale (`en`); the i18n routing and message files ship, the copy does not                                      |
+| Error monitoring                   | none wired; the scaffold carries no Sentry or equivalent                                                           |
+| Blog                               | `/blog` is a teaser (`BlogList`, empty list by design); posts need the `docs` module (Pro)                         |
+| Auth-backed pages                  | `/sign-in` renders; sessions need Postgres (README § When you need a database)                                     |
+| Payments                           | none; commerce is the add-on (`docs/strategy/OFFERINGS.md`)                                                        |
+| Analytics                          | `analytics.vercelAnalytics: false` in `_site.mdx`; the consent banner ships, nothing loads behind it until toggled |
+| Search                             | none                                                                                                               |