create-ailk 0.8.0 → 0.10.0

package/site-templates/marketing-site/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,8 +248,8 @@ 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.
 

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

@@ -17,7 +17,7 @@
   ],
   "shape": "organization-product",
   "design": "standard",
-  "generatedHash": "2fd8ca4f5860bc4ac7ccf086daa46c56d65a8d92e106e428ca838c435a335a76",
+  "generatedHash": "bc9ceb909dc92d2f442fd5cadddc073363a7be19e780f36e26b703d99c6e680a",
   "layout": {
     "nav": "full",
     "footer": "columns",
@@ -173,7 +173,7 @@
       "sections": []
     },
     {
-      "route": "/use-cases",
+      "route": "/for",
       "kind": "page",
       "pageType": "UseCasesList",
       "schema": "UseCasesList",
@@ -213,7 +213,7 @@
       ]
     },
     {
-      "route": "/use-cases/[slug]",
+      "route": "/for/[slug]",
       "kind": "page",
       "contentDir": "content/en/UseCase",
       "seeds": [
@@ -335,6 +335,13 @@
         {
           "type": "hero",
           "component": "Hero"
+        },
+        {
+          "type": "items",
+          "component": "Items",
+          "options": {
+            "columns": 2
+          }
         }
       ]
     },
@@ -378,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",
@@ -522,6 +508,46 @@
       "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",
@@ -659,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,24 +92,24 @@ 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: `persona-1.mdx`, `persona-2.mdx`, `persona-3.mdx`._
 <!-- generated:end -->
@@ -177,13 +177,14 @@ _Detail route over `content/en/Feature/` — 3 seed pages: `feature-1.mdx`, `fea
 
 <!-- generated:begin page=/contact -->
 
-| #   | Section                                                   | Component | Copy (first line)                     |
-| --- | --------------------------------------------------------- | --------- | ------------------------------------- |
-| 1   | `hero` (split · eyebrow "Contact" · checklist ×3 · 1 CTA) | `Hero`    | Get every message in your email, free |
+| #   | 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 -->
 
@@ -204,15 +205,6 @@ _Detail route over `content/en/Feature/` — 3 seed pages: `feature-1.mdx`, `fea
 
 <!-- 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 -->
@@ -380,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
@@ -415,6 +407,33 @@ 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)                       |
@@ -462,15 +481,14 @@ marketing-site:
     - { route: "/",                               kind: page, content: ["content/en/HomePage/home.mdx"] }
     - { route: "/features",                       kind: page, content: ["content/en/FeaturesList/features.mdx"] }
     - { route: "/features/[slug]",                kind: page, contentDir: "content/en/Feature" }
-    - { route: "/use-cases",                      kind: page, content: ["content/en/UseCasesList/use-cases.mdx"] }
-    - { route: "/use-cases/[slug]",               kind: page, contentDir: "content/en/UseCase" }
+    - { 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"] }
@@ -479,6 +497,8 @@ 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"] }
@@ -490,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 -->
@@ -512,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,8 +248,8 @@ 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.