create-ailk 0.7.0 → 0.9.0

package/site-templates/marketing-site/TEMPLATE-MANIFEST.json

@@ -4,6 +4,7 @@
   "categories": [
     "accounting",
     "legal",
+    "consulting",
     "hvac",
     "roofing",
     "plumbing",
@@ -16,7 +17,7 @@
   ],
   "shape": "organization-product",
   "design": "standard",
-  "generatedHash": "cdad46661249780a6423cfa3e259f579d919bfeee48b9138aed13812f7c685d6",
+  "generatedHash": "bc9ceb909dc92d2f442fd5cadddc073363a7be19e780f36e26b703d99c6e680a",
   "layout": {
     "nav": "full",
     "footer": "columns",
@@ -132,27 +133,47 @@
       ]
     },
     {
-      "route": "/software",
-      "kind": "route",
-      "pageType": null,
-      "schema": null,
+      "route": "/features",
+      "kind": "page",
+      "pageType": "FeaturesList",
+      "schema": "FeaturesList",
       "shell": "MarketingShell",
       "chrome": "on",
-      "sections": []
+      "sections": [
+        {
+          "type": "hero",
+          "component": "Hero"
+        },
+        {
+          "type": "items",
+          "component": "Items",
+          "options": {
+            "columns": 3
+          }
+        },
+        {
+          "type": "cta",
+          "component": "CTA"
+        }
+      ]
     },
     {
-      "route": "/software/[slug]",
+      "route": "/features/[slug]",
       "kind": "page",
-      "contentDir": "content/en/SoftwareProduct",
-      "seeds": ["content/en/SoftwareProduct/product.mdx"],
-      "pageType": "SoftwareProduct",
-      "schema": "SoftwareProduct",
+      "contentDir": "content/en/Feature",
+      "seeds": [
+        "content/en/Feature/feature-1.mdx",
+        "content/en/Feature/feature-2.mdx",
+        "content/en/Feature/feature-3.mdx"
+      ],
+      "pageType": "Feature",
+      "schema": "Feature",
       "shell": "MarketingShell",
       "chrome": "on",
       "sections": []
     },
     {
-      "route": "/use-cases",
+      "route": "/for",
       "kind": "page",
       "pageType": "UseCasesList",
       "schema": "UseCasesList",
@@ -192,13 +213,13 @@
       ]
     },
     {
-      "route": "/use-cases/[slug]",
+      "route": "/for/[slug]",
       "kind": "page",
       "contentDir": "content/en/UseCase",
       "seeds": [
-        "content/en/UseCase/first-use-case.mdx",
-        "content/en/UseCase/second-use-case.mdx",
-        "content/en/UseCase/third-use-case.mdx"
+        "content/en/UseCase/persona-1.mdx",
+        "content/en/UseCase/persona-2.mdx",
+        "content/en/UseCase/persona-3.mdx"
       ],
       "pageType": "UseCase",
       "schema": "UseCase",
@@ -316,15 +337,11 @@
           "component": "Hero"
         },
         {
-          "type": "logoCloud",
-          "component": "LogoCloud",
+          "type": "items",
+          "component": "Items",
           "options": {
-            "layout": "inline"
+            "columns": 2
           }
-        },
-        {
-          "type": "testimonials",
-          "component": "Testimonials"
         }
       ]
     },
@@ -368,27 +385,6 @@
         }
       ]
     },
-    {
-      "route": "/book-a-call",
-      "kind": "page",
-      "pageType": "BookCall",
-      "schema": "BookCall",
-      "shell": "MarketingShell",
-      "chrome": "on",
-      "sections": [
-        {
-          "type": "hero",
-          "component": "Hero"
-        },
-        {
-          "type": "items",
-          "component": "Items",
-          "options": {
-            "columns": 3
-          }
-        }
-      ]
-    },
     {
       "route": "/sign-in",
       "kind": "route",
@@ -512,6 +508,100 @@
       "chrome": "on",
       "sections": []
     },
+    {
+      "route": "/reports",
+      "kind": "page",
+      "pageType": "ReportsList",
+      "schema": "ReportsList",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "hero",
+          "component": "Hero"
+        },
+        {
+          "type": "cta",
+          "component": "CTA"
+        }
+      ]
+    },
+    {
+      "route": "/referral",
+      "kind": "page",
+      "pageType": "LandingPage",
+      "schema": "WebPage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "hero",
+          "component": "Hero"
+        },
+        {
+          "type": "stair-steps",
+          "component": "StairSteps"
+        },
+        {
+          "type": "cta",
+          "component": "CTA"
+        }
+      ]
+    },
+    {
+      "route": "/portfolio",
+      "kind": "page",
+      "pageType": "PortfolioList",
+      "schema": "PortfolioList",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "hero",
+          "component": "Hero",
+          "options": {
+            "gapBelow": "tight",
+            "size": "display",
+            "surface": "wash-secondary"
+          }
+        },
+        {
+          "type": "items",
+          "component": "Items",
+          "options": {
+            "surface": "none",
+            "columns": 2
+          }
+        },
+        {
+          "type": "cta",
+          "component": "CTA"
+        },
+        {
+          "type": "faq",
+          "component": "FAQ",
+          "options": {
+            "surface": "gray-100"
+          }
+        }
+      ]
+    },
+    {
+      "route": "/portfolio/[slug]",
+      "kind": "page",
+      "contentDir": "content/en/PortfolioItem",
+      "seeds": [
+        "content/en/PortfolioItem/sample-four.mdx",
+        "content/en/PortfolioItem/sample-one.mdx",
+        "content/en/PortfolioItem/sample-three.mdx",
+        "content/en/PortfolioItem/sample-two.mdx"
+      ],
+      "pageType": "PortfolioItem",
+      "schema": "PortfolioItem",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": []
+    },
     {
       "route": "/blog",
       "kind": "page",
@@ -595,9 +685,16 @@
     },
     {
       "route": "/reports/[slug]",
-      "kind": "route",
-      "pageType": null,
-      "schema": null,
+      "kind": "page",
+      "contentDir": "content/en/ReportPage",
+      "seeds": [
+        "content/en/ReportPage/annual-letter-2024.mdx",
+        "content/en/ReportPage/field-notes-2023.mdx",
+        "content/en/ReportPage/platform-shift-2025.mdx",
+        "content/en/ReportPage/state-of-the-market-2026.mdx"
+      ],
+      "pageType": "ReportPage",
+      "schema": "ReportPage",
       "shell": "MarketingShell",
       "chrome": "on",
       "sections": []

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

@@ -92,40 +92,45 @@ The base rows come first, exactly as the base layer and the always-copied overla
 
 <!-- generated:end -->
 
-`/use-cases` (a UseCasesList page composing sections — operator ruling 2026-09-23; a list of the three use cases since #6658 D4):
+`/for` (a UseCasesList page composing sections — operator ruling 2026-09-23; a list of the three use cases since #6658 D4):
 
-<!-- generated:begin page=/use-cases -->
+<!-- generated:begin page=/for -->
 
 | #   | 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}                      |
+| 1   | `hero` (eyebrow "Customers" · 2 CTAs)                    | `Hero`         | {Customers: who your product or service is for}                   |
+| 2   | `items` (columns=3 · items ×3)                           | `Items`        | {The jobs customers hire your product or service 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}                   |
+| 5   | `cta` (box · checklist ×3 · 2 CTAs · closingLine)        | `CTA`          | {Switch to your product or service in time amount or less}        |
 | 6   | `faq` (accordion · items ×5 · 1 CTA · initialOpen first) | `FAQ`          | FAQs                                                              |
 
 <!-- generated:end -->
 
-`/use-cases/[slug]` (#6658 D4):
+`/for/[slug]` (#6658 D4):
 
-<!-- generated:begin page=/use-cases/[slug] -->
+<!-- generated:begin page=/for/[slug] -->
 
-_Detail route over `content/en/UseCase/` — 3 seed pages: `first-use-case.mdx`, `second-use-case.mdx`, `third-use-case.mdx`._
+_Detail route over `content/en/UseCase/` — 3 seed pages: `persona-1.mdx`, `persona-2.mdx`, `persona-3.mdx`._
 <!-- generated:end -->
 
 `/software` (code route — the product listing, core since #6658):
 
-<!-- generated:begin page=/software -->
+<!-- generated:begin page=/features -->
+
+| #   | Section                                           | Component | Copy (first line)                               |
+| --- | ------------------------------------------------- | --------- | ----------------------------------------------- |
+| 1   | `hero` (eyebrow "Features" · 2 CTAs)              | `Hero`    | {Features: what your product does}              |
+| 2   | `items` (columns=3 · items ×3)                    | `Items`   | {Everything your product does for the customer} |
+| 3   | `cta` (box · checklist ×3 · 2 CTAs · closingLine) | `CTA`     | {Switch to your product in time amount or less} |
 
-_Code route — no content, no sections._
 <!-- generated:end -->
 
-`/software/[slug]` (the product's own page, `/software/product` — #6658 D3):
+`/features/[slug]` (one page per feature — #6721, reversing #6658 D3's single product page):
 
-<!-- generated:begin page=/software/[slug] -->
+<!-- generated:begin page=/features/[slug] -->
 
-_Detail route over `content/en/SoftwareProduct/` — 1 seed page: `product.mdx`._
+_Detail route over `content/en/Feature/` — 3 seed pages: `feature-1.mdx`, `feature-2.mdx`, `feature-3.mdx`._
 <!-- generated:end -->
 
 `/pricing`:
@@ -172,15 +177,14 @@ _Detail route over `content/en/SoftwareProduct/` — 1 seed page: `product.mdx`.
 
 <!-- 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   | `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} |
+| #   | Section                                                   | Component | Copy (first line)                         |
+| --- | --------------------------------------------------------- | --------- | ----------------------------------------- |
+| 1   | `hero` (split · eyebrow "Contact" · checklist ×3 · 1 CTA) | `Hero`    | Get every message in your email, free     |
+| 2   | `items` (tiles · columns=2 · items ×4)                    | `Items`   | {Add appointment scheduling to your site} |
 
 <!-- generated:end -->
 
-`/glossary`, `/newsletter`, `/book-a-call` (#6658 D5 — every starter carries them):
+`/glossary`, `/newsletter` (#6658 D5 — every starter carries them). `/book-a-call` is retired (#6897 D10); this template's `scheduling` module serves its own live `/meet` and `/meet/[slug]` pages instead.
 
 <!-- generated:begin page=/glossary -->
 
@@ -201,15 +205,6 @@ _Detail route over `content/en/SoftwareProduct/` — 1 seed page: `product.mdx`.
 
 <!-- generated:end -->
 
-<!-- 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 -->
-
 `/sign-in`:
 
 <!-- generated:begin page=/sign-in -->
@@ -377,7 +372,7 @@ _Code route — no content, no sections._
 
 <!-- generated:begin page=/reports/[slug] -->
 
-_Code route — no content, no sections._
+_Detail route over `content/en/ReportPage/` — 4 seed pages: `annual-letter-2024.mdx`, `field-notes-2023.mdx`, `platform-shift-2025.mdx`, `state-of-the-market-2026.mdx`._
 <!-- generated:end -->
 
 ### `/projects`, `/projects/<slug>`, `/projects/apply` — CollectionPage / WebPage · schema `ProjectsList` / `Project` · signal-collectors
@@ -412,6 +407,49 @@ Authored per form (#3960): `contact` (if the Pro contact form redirects), `newsl
 _Detail route over `content/en/ThankYouPage/` — 3 seed pages: `apply.mdx`, `contact.mdx`, `newsletter.mdx`._
 <!-- generated:end -->
 
+### `/reports` — ReportsList hub · schema `CollectionPage` · signal-collectors
+
+Spec 6892 D2/D3 — a signal-collectors module sample, self-seeded alongside its four `ReportPage` spokes at `/reports/<slug>` (below). Its seed carries `hero` and `cta`; the card grid is a generated `reports-list` section the route appends from the module's own seeds (never hand-authored).
+
+<!-- generated:begin page=/reports -->
+
+| #   | Section                               | Component | Copy (first line)                           |
+| --- | ------------------------------------- | --------- | ------------------------------------------- |
+| 1   | `hero` (centered · eyebrow "Reports") | `Hero`    | Research on {your field}, published in full |
+| 2   | `cta` (minimal · 1 CTA)               | `CTA`     | Want the next one as it lands?              |
+
+<!-- generated:end -->
+
+### `/referral` — flow landing page · schema `LandingPage` · signal-collectors
+
+Spec 6892 D3 — a signal-collectors module sample: the referral magnet, whose CTA opens the `referral` flow at `/flows/referral/start`.
+
+<!-- generated:begin page=/referral -->
+
+| #   | Section                                                        | Component    | Copy (first line)                        |
+| --- | -------------------------------------------------------------- | ------------ | ---------------------------------------- |
+| 1   | `hero` (centered · eyebrow "Referrals" · checklist ×3 · 1 CTA) | `Hero`       | Know someone who should be on this list? |
+| 2   | `stair-steps` (tiles ×3)                                       | `StairSteps` | Three steps, about a minute              |
+| 3   | `cta` (minimal · 1 CTA)                                        | `CTA`        | Make an introduction                     |
+
+<!-- generated:end -->
+
+<!-- generated:begin page=/portfolio -->
+
+| #   | Section                                                                                                    | Component | Copy (first line)                       |
+| --- | ---------------------------------------------------------------------------------------------------------- | --------- | --------------------------------------- |
+| 1   | `hero` (default · gapBelow=tight · size=display · surface=wash-secondary · eyebrow "{Portfolio}" · 2 CTAs) | `Hero`    | {The work, before and after.}           |
+| 2   | `items` (tile · surface=none · columns=2 · items ×4)                                                       | `Items`   |                                         |
+| 3   | `cta` (beam · chips ×3 · 2 CTAs)                                                                           | `CTA`     | {Is your site the before or the after?} |
+| 4   | `faq` (centered · surface=gray-100 · accordion · items ×3 · initialOpen first)                             | `FAQ`     | Frequently Asked Questions              |
+
+<!-- generated:end -->
+
+<!-- generated:begin page=/portfolio/[slug] -->
+
+_Detail route over `content/en/PortfolioItem/` — 4 seed pages: `sample-four.mdx`, `sample-one.mdx`, `sample-three.mdx`, `sample-two.mdx`._
+<!-- generated:end -->
+
 ## 2a. State and persistence — Pro delta
 
 Everything in the Free manifest § 2a applies. Pro adds:
@@ -436,22 +474,21 @@ Everything in the Free manifest § 2a applies. Pro adds:
 ```
 marketing-site:
   requires: [marketing, docs-blog, scheduling, signal-collectors]
-  categories: [accounting, legal, hvac, roofing, plumbing, electrical, landscaping, auto-repair, real-estate, technology, medical-specialty]
+  categories: [accounting, legal, consulting, hvac, roofing, plumbing, electrical, landscaping, auto-repair, real-estate, technology, medical-specialty]
   shape: organization-product
   design: standard
   roster:
     - { 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: "/features",                       kind: page, content: ["content/en/FeaturesList/features.mdx"] }
+    - { route: "/features/[slug]",                kind: page, contentDir: "content/en/Feature" }
+    - { route: "/for",                            kind: page, content: ["content/en/UseCasesList/for.mdx"] }
+    - { route: "/for/[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"] }
@@ -460,6 +497,10 @@ marketing-site:
     - { route: "/projects",                       kind: page, content: ["content/en/ProjectsList/projects.mdx"] }
     - { route: "/projects/[slug]",                kind: page, contentDir: "content/en/Project" }
     - { route: "/thanks/[slug]",                  kind: page, contentDir: "content/en/ThankYouPage" }
+    - { route: "/reports",                        kind: page, content: ["content/en/ReportsList/reports.mdx"] }
+    - { route: "/referral",                       kind: page, content: ["content/en/LandingPage/referral.mdx"] }
+    - { route: "/portfolio",                      kind: page, content: ["content/en/PortfolioList/portfolio.mdx"] }
+    - { route: "/portfolio/[slug]",               kind: page, contentDir: "content/en/PortfolioItem" }
     - { route: "/blog",                           kind: page, content: ["apps/web/content/en/blog/index.mdx", "apps/web/content/en/blog/01-8-things-that-prove-coding-skills-are-directly-linked-to-successfully-assembling-ikea-furniture.mdx", "apps/web/content/en/blog/02-5-ways-to-guarantee-your-startup-goes-nowhere-fast.mdx", "apps/web/content/en/blog/03-10-ideas-that-will-guarantee-1000x-growth.mdx", "apps/web/content/en/blog/04-7-keys-to-saas-success-the-elite-doesnt-want-you-to-know.mdx", "apps/web/content/en/blog/launching-ailk.mdx"] }
     - { route: "/docs",                           kind: page, content: ["apps/web/content/en/docs/getting-started.mdx", "apps/web/content/en/docs/configure.mdx", "apps/web/content/en/docs/deploy.mdx"] }
     - { route: "/meet",                           kind: route }
@@ -469,7 +510,7 @@ marketing-site:
     - { route: "/flows/[slug]",                   kind: route }
     - { route: "/flows/[slug]/start",             kind: route }
     - { route: "/flows/[slug]/results/[payload]", kind: route }
-    - { route: "/reports/[slug]",                 kind: route }
+    - { route: "/reports/[slug]",                 kind: page, contentDir: "content/en/ReportPage" }
 ```
 
 <!-- generated:end -->
@@ -491,11 +532,11 @@ Every component the roster rows' seed content composes today (generated):
 
 <!-- generated:begin inventory -->
 
-| Tier     | Used by this template                                                                                                                                                                    |
-| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Shell    | `MarketingShell`                                                                                                                                                                         |
-| Chrome   | `Nav`, `Footer`, `Banner` (+ `BannerConsentIsland`, `BannerDismissIsland`)                                                                                                               |
-| Sections | `ContentBlock`, `CTA`, `DecisionSplit`, `DocumentChassis`, `FAQ`, `Feature`, `GlossaryIndex`, `Hero`, `Items`, `LogoCloud`, `MediaBand`, `Newsletter`, `Pricing`, `Team`, `Testimonials` |
+| Tier     | Used by this template                                                                                                                                                                                  |
+| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Shell    | `MarketingShell`                                                                                                                                                                                       |
+| Chrome   | `Nav`, `Footer`, `Banner` (+ `BannerConsentIsland`, `BannerDismissIsland`)                                                                                                                             |
+| Sections | `ContentBlock`, `CTA`, `DecisionSplit`, `DocumentChassis`, `FAQ`, `Feature`, `GlossaryIndex`, `Hero`, `Items`, `LogoCloud`, `MediaBand`, `Newsletter`, `Pricing`, `StairSteps`, `Team`, `Testimonials` |
 
 <!-- generated:end -->
 

package/site-templates/marketing-site-free/DESIGN.md

@@ -1,6 +1,6 @@
 ---
 name: Standard
-description: The standard design — the black-on-white foundation any shape wears by default: full navigation, a multi-column footer, the document-scroll home.
+description: "The standard design — the black-on-white foundation any shape wears by default: full navigation, a multi-column footer, the document-scroll home."
 colors:
   bg: "#ffffff"
   fg: "#000000"
@@ -15,6 +15,19 @@ colors:
   fg-dark: "#ffffff"
   border-dark: "#ffffff"
   brand-dark: "#ffffff"
+  text-muted-dark: "#cccccc"
+treatments:
+  corners: square
+  eyebrowCase: sentence
+  placeholders: fill
+  checkmarks: plain
+layout:
+  nav: full
+  footer: columns
+  announcementBanner: false
+  home: default
+copy:
+  density: standard
 typography:
   display:
     fontFamily: "system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif"
@@ -69,9 +82,12 @@ spacing:
   stays on-system.
   Edit the canonical file, never a copy — a test holds every copy to it.
 
-  The tokens above describe what the site RENDERS today. Colours come from
-  content/_site.mdx (`theme.colors`); type, radius and spacing are platform
-  defaults a site cannot override yet — see "Where this is heading" below.
+  The tokens above describe what the site RENDERS today. The design's own
+  colours and shape knobs live in content/_site.mdx `theme:`, which
+  `create-ailk apply-design` replaces wholesale; the owner's brand colours and
+  fonts live beside it in `brand.colors` and `brand.fonts`, which applying a
+  design never rewrites. Radius and spacing are platform defaults a site
+  cannot override yet — see "Where this is heading" below.
 -->
 
 # Standard
@@ -84,6 +100,27 @@ Every page is composed from the AI Launch Kit component library (`@working-theor
 
 ## Colors
 
+<!-- generated:begin colors -->
+
+| Key                 | Value     | Compiles to                                                                                                    |
+| ------------------- | --------- | -------------------------------------------------------------------------------------------------------------- |
+| `bg`                | `#ffffff` | `light.bg`                                                                                                     |
+| `fg`                | `#000000` | `light.text`                                                                                                   |
+| `surface`           | `#ffffff` | `light.surface`                                                                                                |
+| `surface-secondary` | `#ffffff` | `light.bgMuted`                                                                                                |
+| `border`            | `#000000` | `light.border`                                                                                                 |
+| `text-muted`        | `#333333` | `light.textMuted`                                                                                              |
+| `brand`             | `#000000` | `light.primary`                                                                                                |
+| `fg-on-brand`       | `#ffffff` | `light.primaryFg`                                                                                              |
+| `accent`            | `#000000` | `light.accent`                                                                                                 |
+| `bg-dark`           | `#000000` | `dark.bg`, `dark.bgMuted` (fallback of L1), `dark.surface` (fallback of L2), `dark.primaryFg` (fallback of L4) |
+| `fg-dark`           | `#ffffff` | `dark.text`                                                                                                    |
+| `border-dark`       | `#ffffff` | `dark.border`                                                                                                  |
+| `brand-dark`        | `#ffffff` | `dark.primary`, `dark.accent` (fallback of L5)                                                                 |
+| `text-muted-dark`   | `#cccccc` | `dark.textMuted`                                                                                               |
+
+<!-- generated:end -->
+
 ### Primary
 
 **Black** (`brand` `#000000`) fills the primary button; its label is white. The secondary button is white with a black hairline and black label.
@@ -100,6 +137,18 @@ Dark mode inverts: black ground, white ink, white rules, white primary button wi
 
 ## Typography
 
+<!-- generated:begin typography -->
+
+| Role              | Family                                                                   | Size       | Weight | Line height | Tracking |
+| ----------------- | ------------------------------------------------------------------------ | ---------- | ------ | ----------- | -------- |
+| `display`         | `system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif` | `3.5rem`   | 700    | 1.1         | `normal` |
+| `heading-section` | `system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif` | `3rem`     | 700    | 1.1         | `normal` |
+| `heading-item`    | —                                                                        | `2rem`     | 700    | 1.375       | `normal` |
+| `body`            | `system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif` | `1.125rem` | 400    | 1.5         | —        |
+| `eyebrow`         | —                                                                        | `0.875rem` | 600    | 1.4         | `0.05em` |
+
+<!-- generated:end -->
+
 System sans throughout; no web font.
 
 ### Hierarchy
@@ -118,10 +167,53 @@ The small label above a section heading is **kept** as part of this foundation's
 
 ## Layout
 
+<!-- generated:begin layout -->
+
+| Knob                 | Value     |
+| -------------------- | --------- |
+| `nav`                | `full`    |
+| `footer`             | `columns` |
+| `announcementBanner` | `false`   |
+| `home`               | `default` |
+
+| Spacing          | Value    |
+| ---------------- | -------- |
+| `section`        | `7rem`   |
+| `section-mobile` | `4rem`   |
+| `card`           | `1.5rem` |
+| `grid`           | `1.5rem` |
+| `container`      | `1280px` |
+| `measure`        | `36rem`  |
+
+<!-- generated:end -->
+
 Full navigation; a multi-column footer; the default home. The home-only announcement banner is off by default (`layout.announcementBanner`). Every page this site carries is listed in its roster of record, `.ailk-site-manifest.json` at the site root. Shared foundation: a 1280px container, sections at 7rem (4rem below 1024px), card grids at 1.5rem, breakpoints 320 / 768 / 1024 / 1440.
 
+## Copy
+
+<!-- generated:begin copy -->
+
+Copy density: standard — pages carry the ordinary amount of body copy for their section.
+<!-- generated:end -->
+
 ## Shapes
 
+<!-- generated:begin shapes -->
+
+| Rounded  | Value     |
+| -------- | --------- |
+| `button` | `0.5rem`  |
+| `card`   | `0.75rem` |
+
+| Treatment                 | Value      |
+| ------------------------- | ---------- |
+| `treatments.corners`      | `square`   |
+| `treatments.eyebrowCase`  | `sentence` |
+| `treatments.placeholders` | `fill`     |
+| `treatments.checkmarks`   | `plain`    |
+
+<!-- generated:end -->
+
 Square corners everywhere (`theme.corners: square`) — buttons, cards, the auth card, image placeholders; the tokens above are the base foundation's defaults a site overrides.
 
 ## Components
@@ -156,7 +248,12 @@ The foundation's pinned direction is the pacing of a classic wireframe marketing
 ## Do's and Don'ts
 
 - **Do** keep every page built from registered sections. If a section you need does not exist, request it rather than writing one-off markup.
-- **Do** change colours in `content/_site.mdx` `theme.colors`; they reach every section.
-- **Don't** add a colour accent. The foundation's one idea is black on white; a brand pass adds colour deliberately, through the theme.
+- **Do** set your brand colours (`primary`, `primaryFg`, `accent`, per mode) in `content/_site.mdx` `brand.colors` and your fonts (`display`, `body`) in `brand.fonts`; they reach every section and survive applying another design, which replaces `theme:`.
+- **Don't** add a colour accent. The foundation's one idea is black on white; a brand pass adds colour deliberately, through `brand.colors`.
 - **Don't** replace a black rule with a shadow or a grey fill.
 - **Don't** hard-code the "heading toward" values above into a page. They arrive through the platform, or not at all.
+
+## Revisions
+
+- **2026-09-24 — tile hover is outline-only (operator ruling, /build-starter live pass, #6687).** A comparison tile (`items` in `variant: tile`) hovers by shifting its border to the accent only — no lift, no glow — matching the Positionary `/alternatives` ruling of 2026-08-29. Expressed as the bounded `tileHover: "outline"` option (Card `wash-outline`); the library default `lift` is unchanged for every other site.
+- **2026-09-25 — the before-after section's rulings (operator, /build-starter live pass, #6687).** One layout, not two variants: a panel body is an image or rows of content under the same label bar. The label bar is the tone's fill (brand → black bar, white text) at the heading-4 role; a `neutral` panel keeps a white bar. The view selector is underline tabs with the underline under the current tab only (no full-width baseline), active black, inactive muted, black on hover. The pager is a ghost "‹ Previous" at the left edge and "Next ›" at the right edge. The catalyst column carries no icon tile — it starts at the arrow, or at an image when one is set. No back-to-all link and no tag chips on the seed pages.