create-ailk 0.8.0 → 0.10.0

package/templates/.claude/skills/add-page/references/page-types.md

@@ -1,17 +1,16 @@
-<!-- GENERATED — do not hand-edit. Regenerate with:
-       cd packages/create-ailk && pnpm page-types:build
-     Source: packages/schema/src/registry/entries.ts
-     Generator: packages/create-ailk/scripts/generate-page-types-reference.ts
+<!-- GENERATED — do not hand-edit. AI Launch Kit generates this file
+     from its page-type registry and ships it with the scaffold. The
+     source of record for this site's own page-type registry is `pageTypeRegistry` in the installed `@working-theory/schema` package.
 -->
 
 # Page-Type → schema.org Registry Reference
 
 The full page-type catalog the `add-page` skill reads at runtime to
 resolve a slug or page-purpose hint to a family, chassis, schema.org
-`@type`, and route convention. Generated from
-`packages/schema/src/registry/entries.ts` — every registered page type
-appears exactly once, list/detail pairs are shown together, and no row
-here can name a type the registry doesn't have.
+`@type`, and route convention. Generated from the page-type registry
+`@working-theory/schema` exports — every registered page type appears
+exactly once, list/detail pairs are shown together, and no row here
+can name a type the registry doesn't have.
 
 The skill resolves in this order:
 
@@ -20,96 +19,105 @@ The skill resolves in this order:
 3. **Free-text hint match** — "company story" / "team" → `AboutPage`.
 4. **Ask** — if nothing matches, ask the consumer rather than guessing.
 
+**Level** and **Module** name what a page type needs: the module whose
+code renders it, and the level that module comes with. Read the site's
+`.ailk-site-manifest.json` `modules` first — a page type whose Module is
+not in that list is one this site cannot render, so it is never offered;
+name its module and level instead (the `upgrade-plan` skill explains the
+levels). The level is the module's, never a claim about this site's key.
+
 `<slug>` in a route below is the page's own slug (e.g. `hello-world`);
 `<Type>` families using two-layer builders route supplementary schema
 through the `schema:` frontmatter override — see this skill's
-[Adding schema to an existing page](../SKILL.md#adding-schema-to-an-existing-page) section, or `packages/schema/README.md` for the full
-override contract.
+[Adding schema to an existing page](../SKILL.md#adding-schema-to-an-existing-page) section, or the installed `@working-theory/schema`
+package's README for the full override contract.
 
 ## Core
 
-| Key | `@type` | Family | Chassis | Route |
-| --- | --- | --- | --- | --- |
-| `HomePage` | `HomePage` | core | home | / |
-| `AboutPage` | `AboutPage` | core | detail | /about |
-| `ContactPage` | `ContactPage` | core | detail | /contact |
-| `PrivacyPage` | `WebPage` | core | detail | /privacy |
-| `TermsPage` | `WebPage` | core | detail | /terms |
-| `PurchasePolicyPage` | `WebPage` | core | detail | /purchase-policy |
-| `WorkingAgreementPage` | `WebPage` | core | detail | /working-agreement |
-| `LandingPage` | `WebPage` | core | home | /<slug> |
-| `ThankYouPage` | `WebPage` | core | detail | /thanks/<slug> |
-| `BookCall` | `WebPage` | core | home | /book-a-call |
-| `NewsletterSignup` | `WebPage` | core | home | /newsletter |
-| `DemoRequest` | `WebPage` | core | home | /demo-request |
-| `TrialSignup` | `WebPage` | core | home | /trial-signup |
-| `Waitlist` | `WebPage` | core | home | /waitlist |
-| `Assessment` | `WebApplication` | core | home | /assessment |
-| `Calculator` | `WebApplication` | core | home | /calculator |
-| `CampaignLP` | `WebPage` | core | home | /<slug> |
+| Key | `@type` | Family | Chassis | Route | Level | Module |
+| --- | --- | --- | --- | --- | --- | --- |
+| `HomePage` | `HomePage` | core | home | / | Free | `marketing` |
+| `AboutPage` | `AboutPage` | core | detail | /about | Free | `marketing` |
+| `ContactPage` | `ContactPage` | core | detail | /contact | Free | `marketing` |
+| `PrivacyPage` | `WebPage` | core | detail | /privacy | Free | `marketing` |
+| `TermsPage` | `WebPage` | core | detail | /terms | Free | `marketing` |
+| `PurchasePolicyPage` | `WebPage` | core | detail | /purchase-policy | Free | `marketing` |
+| `WorkingAgreementPage` | `WebPage` | core | detail | /working-agreement | Free | `marketing` |
+| `LandingPage` | `WebPage` | core | home | /<slug> | Free | `marketing` |
+| `ThankYouPage` | `WebPage` | core | detail | /thanks/<slug> | Free | `marketing` |
+| `BookCall` | `WebPage` | core | home | /meet/:slug | Pro | `scheduling` |
+| `NewsletterSignup` | `WebPage` | core | home | /newsletter | Free | `marketing` |
+| `DemoRequest` | `WebPage` | core | home | /demo-request | Free | `marketing` |
+| `TrialSignup` | `WebPage` | core | home | /trial-signup | Free | `marketing` |
+| `Waitlist` | `WebPage` | core | home | /waitlist | Free | `marketing` |
+| `Assessment` | `WebApplication` | core | home | /assessment | Pro | `signal-collectors` |
+| `Calculator` | `WebApplication` | core | home | /calculator | Pro | `signal-collectors` |
+| `CampaignLP` | `WebPage` | core | home | /<slug> | Free | `marketing` |
 
 ## Identity
 
-| Key | `@type` | Family | Chassis | Route |
-| --- | --- | --- | --- | --- |
-| `Organization` | `Organization` | identity | detail | — site-wide identity — emitted on the home page or in a layout |
-| `Person` | `Person` | identity | detail | — site-wide identity — emitted on the home page or in a layout |
-| `BreadcrumbList` | `BreadcrumbList` | identity | detail | — site-wide — attached alongside another page's own schema |
-| `ContactPoint` | `ContactPoint` | identity | detail | — site-wide — embedded in `Organization` or `Person` |
+| Key | `@type` | Family | Chassis | Route | Level | Module |
+| --- | --- | --- | --- | --- | --- | --- |
+| `Organization` | `Organization` | identity | detail | — site-wide identity — emitted on the home page or in a layout | Free | `marketing` |
+| `Person` | `Person` | identity | detail | — site-wide identity — emitted on the home page or in a layout | Free | `marketing` |
+| `BreadcrumbList` | `BreadcrumbList` | identity | detail | — site-wide — attached alongside another page's own schema | Free | `marketing` |
+| `ContactPoint` | `ContactPoint` | identity | detail | — site-wide — embedded in `Organization` or `Person` | Free | `marketing` |
 
 ## Canonical
 
-| Key | `@type` | Family | Chassis | Route |
-| --- | --- | --- | --- | --- |
-| `ServicesList` | `CollectionPage` | canonical-list | list | /services |
-| `Service` | `Service` | canonical-detail | detail | /services/<slug> |
-| `ProductsList` | `CollectionPage` | canonical-list | list | /products |
-| `Product` | `Product` | canonical-detail | detail | /products/<slug> |
-| `ProjectsList` | `CollectionPage` | canonical-list | list | /projects |
-| `Project` | `CreativeWork` | canonical-detail | detail | /projects/<slug> |
-| `FAQPage` | `FAQPage` | canonical-list | list | /faq |
-| `CareersList` | `CollectionPage` | canonical-list | list | /careers |
-| `JobPosting` | `JobPosting` | canonical-detail | detail | /careers/<slug> |
-| `UseCasesList` | `CollectionPage` | canonical-list | list | /use-cases |
-| `UseCase` | `WebPage` | canonical-detail | detail | /use-cases/<slug> |
-| `PortfolioList` | `CollectionPage` | canonical-list | list | /portfolio |
-| `PortfolioItem` | `WebPage` | canonical-detail | detail | /portfolio/<slug> |
-| `FeaturesList` | `CollectionPage` | canonical-list | list | /features |
-| `Feature` | `WebPage` | canonical-detail | detail | /features/<slug> |
-| `TestimonialsList` | `CollectionPage` | canonical-list | list | /testimonials |
-| `ClientsList` | `CollectionPage` | canonical-list | list | /clients |
-| `DownloadsList` | `CollectionPage` | canonical-list | list | /downloads |
-| `EventsList` | `CollectionPage` | canonical-list | list | /events |
-| `Event` | `Event` | canonical-detail | detail | /events/<slug> |
-| `CoursesList` | `CollectionPage` | canonical-list | list | /courses |
-| `Course` | `Course` | canonical-detail | detail | /courses/<slug> |
-| `TeamList` | `CollectionPage` | canonical-list | list | /team |
-| `TeamMember` | `ProfilePage` | canonical-detail | detail | /team/<slug> |
-| `PartnersList` | `CollectionPage` | canonical-list | list | /partners |
-| `Partner` | `AboutPage` | canonical-detail | detail | /partners/<slug> |
-| `IntegrationsList` | `CollectionPage` | canonical-list | list | /integrations |
-| `Integration` | `WebPage` | canonical-detail | detail | /integrations/<slug> |
-| `GlossaryList` | `CollectionPage` | canonical-list | list | /glossary |
-| `LocationsList` | `CollectionPage` | canonical-list | list | /locations |
-| `Location` | `Place` | canonical-detail | detail | /locations/<slug> |
-| `DocsList` | `CollectionPage` | canonical-list | list | /docs |
-| `SoftwareProduct` | `WebPage` | canonical-detail | detail | /software/<slug> |
-| `ServiceAreaPage` | `WebPage` | canonical-detail | detail | /service-areas/<slug> |
-| `Pricing` | `WebPage` | canonical-detail | detail | /pricing |
-| `ComparisonPage` | `WebPage` | canonical-detail | detail | /comparisons/<slug> |
-| `ReportPage` | `Report` | canonical-detail | detail | /reports/<slug> |
+| Key | `@type` | Family | Chassis | Route | Level | Module |
+| --- | --- | --- | --- | --- | --- | --- |
+| `ServicesList` | `CollectionPage` | canonical-list | list | /services | Free | `marketing` |
+| `Service` | `Service` | canonical-detail | detail | /services/<slug> | Free | `marketing` |
+| `ProductsList` | `CollectionPage` | canonical-list | list | /products | Free | `marketing` |
+| `Product` | `Product` | canonical-detail | detail | /products/<slug> | Free | `marketing` |
+| `ProjectsList` | `CollectionPage` | canonical-list | list | /projects | Free | `marketing` |
+| `Project` | `CreativeWork` | canonical-detail | detail | /projects/<slug> | Free | `marketing` |
+| `FAQPage` | `FAQPage` | canonical-list | list | /faq | Free | `marketing` |
+| `CareersList` | `CollectionPage` | canonical-list | list | /careers | Free | `marketing` |
+| `JobPosting` | `JobPosting` | canonical-detail | detail | /careers/<slug> | Free | `marketing` |
+| `UseCasesList` | `CollectionPage` | canonical-list | list | /for | Free | `marketing` |
+| `UseCase` | `WebPage` | canonical-detail | detail | /for/<slug> | Free | `marketing` |
+| `PortfolioList` | `CollectionPage` | canonical-list | list | /portfolio | Free | `marketing` |
+| `PortfolioItem` | `WebPage` | canonical-detail | detail | /portfolio/<slug> | Free | `marketing` |
+| `FeaturesList` | `CollectionPage` | canonical-list | list | /features | Free | `marketing` |
+| `Feature` | `WebPage` | canonical-detail | detail | /features/<slug> | Free | `marketing` |
+| `ComparisonsList` | `CollectionPage` | canonical-list | list | /alternatives | Free | `marketing` |
+| `ComparisonPage` | `WebPage` | canonical-detail | detail | /vs/<slug> | Free | `marketing` |
+| `ReportsList` | `CollectionPage` | canonical-list | list | /reports | Free | `marketing` |
+| `ReportPage` | `Report` | canonical-detail | detail | /reports/<slug> | Pro | `signal-collectors` |
+| `TestimonialsList` | `CollectionPage` | canonical-list | list | /testimonials | Free | `marketing` |
+| `ClientsList` | `CollectionPage` | canonical-list | list | /clients | Free | `marketing` |
+| `DownloadsList` | `CollectionPage` | canonical-list | list | /downloads | Free | `marketing` |
+| `EventsList` | `CollectionPage` | canonical-list | list | /events | Free | `marketing` |
+| `Event` | `Event` | canonical-detail | detail | /events/<slug> | Free | `marketing` |
+| `CoursesList` | `CollectionPage` | canonical-list | list | /courses | Free | `marketing` |
+| `Course` | `Course` | canonical-detail | detail | /courses/<slug> | Free | `marketing` |
+| `TeamList` | `CollectionPage` | canonical-list | list | /team | Free | `marketing` |
+| `TeamMember` | `ProfilePage` | canonical-detail | detail | /team/<slug> | Free | `marketing` |
+| `PartnersList` | `CollectionPage` | canonical-list | list | /partners | Free | `marketing` |
+| `Partner` | `AboutPage` | canonical-detail | detail | /partners/<slug> | Free | `marketing` |
+| `IntegrationsList` | `CollectionPage` | canonical-list | list | /integrations | Free | `marketing` |
+| `Integration` | `WebPage` | canonical-detail | detail | /integrations/<slug> | Free | `marketing` |
+| `GlossaryList` | `CollectionPage` | canonical-list | list | /glossary | Free | `marketing` |
+| `LocationsList` | `CollectionPage` | canonical-list | list | /locations | Free | `marketing` |
+| `Location` | `Place` | canonical-detail | detail | /locations/<slug> | Free | `marketing` |
+| `DocsList` | `CollectionPage` | canonical-list | list | /docs | Pro | `docs-blog` |
+| `SoftwareProduct` | `WebPage` | canonical-detail | detail | /software/<slug> | Free | `marketing` |
+| `ServiceAreaPage` | `WebPage` | canonical-detail | detail | /service-areas/<slug> | Free | `marketing` |
+| `Pricing` | `WebPage` | canonical-detail | detail | /pricing | Free | `marketing` |
 
 ## Editorial
 
-| Key | `@type` | Family | Chassis | Route |
-| --- | --- | --- | --- | --- |
-| `BlogList` | `Blog` | editorial-list | list | /blog |
-| `BlogPosting` | `BlogPosting` | editorial-detail | detail | /blog/<slug> |
-| `ResourcesHub` | `CollectionPage` | editorial-list | list | /resources |
-| `ResourceDetail` | `Article` | editorial-detail | detail | /resources/<slug> |
-| `CaseStudiesList` | `CollectionPage` | editorial-list | list | /case-studies |
-| `CaseStudy` | `Article` | editorial-detail | detail | /case-studies/<slug> |
-| `HowTo` | `HowTo` | editorial-detail | detail | /how-to/<slug> |
-| `Whitepaper` | `Article` | editorial-detail | detail | /whitepapers/<slug> |
-| `TechArticle` | `TechArticle` | editorial-detail | detail | /tech-articles/<slug> |
-| `DocsDetail` | `TechArticle` | editorial-detail | detail | /docs/<slug> |
+| Key | `@type` | Family | Chassis | Route | Level | Module |
+| --- | --- | --- | --- | --- | --- | --- |
+| `BlogList` | `Blog` | editorial-list | list | /blog | Free | `marketing` |
+| `BlogPosting` | `BlogPosting` | editorial-detail | detail | /blog/<slug> | Pro | `docs-blog` |
+| `ResourcesHub` | `CollectionPage` | editorial-list | list | /resources | Free | `marketing` |
+| `ResourceDetail` | `Article` | editorial-detail | detail | /resources/<slug> | Free | `marketing` |
+| `CaseStudiesList` | `CollectionPage` | editorial-list | list | /case-studies | Free | `marketing` |
+| `CaseStudy` | `Article` | editorial-detail | detail | /case-studies/<slug> | Free | `marketing` |
+| `HowTo` | `HowTo` | editorial-detail | detail | /how-to/<slug> | Free | `marketing` |
+| `Whitepaper` | `Article` | editorial-detail | detail | /whitepapers/<slug> | Free | `marketing` |
+| `TechArticle` | `TechArticle` | editorial-detail | detail | /tech-articles/<slug> | Free | `marketing` |
+| `DocsDetail` | `TechArticle` | editorial-detail | detail | /docs/<slug> | Pro | `docs-blog` |

package/templates/.claude/skills/add-page/scripts/site-pages.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+// site-pages.mjs — report what THIS site can serve, read from the site itself.
+//
+// Usage: node .claude/skills/add-page/scripts/site-pages.mjs [--json] [<site-root>]
+//
+// It scans apps/web/app/[locale]/**/page.tsx for the page type each route
+// renders (the `type: "X"` literal in renderPage / renderPageMetadata, or a
+// getMdxSource("X", …) call), then pairs each type with its content folder and
+// the pages already written there. It also echoes .ailk-site-manifest.json's
+// shape, design and (when recorded) level. Read-only: it never writes.
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+
+const args = process.argv.slice(2);
+const asJson = args.includes("--json");
+const root = args.find((a) => !a.startsWith("--")) ?? process.cwd();
+const appRoot = join(root, "apps/web/app/[locale]");
+if (!existsSync(appRoot)) {
+  console.error(`site-pages: ${appRoot} not found — run from the site's root.`);
+  process.exit(2);
+}
+
+// Types whose content lives outside content/<locale>/<Type>.
+const CONTENT_OVERRIDES = {
+  BlogPosting: "apps/web/content/en/blog",
+  BlogList: "apps/web/content/en/blog",
+  DocsDetail: "apps/web/content/en/docs",
+  DocsList: "apps/web/content/en/docs",
+};
+
+function walk(dir, out = []) {
+  for (const name of readdirSync(dir)) {
+    const abs = join(dir, name);
+    if (name === "__tests__" || name === "node_modules") continue;
+    if (statSync(abs).isDirectory()) walk(abs, out);
+    else if (name === "page.tsx") out.push(abs);
+  }
+  return out;
+}
+
+const routes = [];
+for (const file of walk(appRoot)) {
+  const src = readFileSync(file, "utf8");
+  const types = new Set();
+  for (const m of src.matchAll(/type:\s*"([A-Z][A-Za-z]+)"/g)) types.add(m[1]);
+  for (const m of src.matchAll(/getMdxSource\(\s*"([A-Z][A-Za-z]+)"/g)) types.add(m[1]);
+  const dir = relative(appRoot, file).split(sep).slice(0, -1);
+  // Route groups like (auth) do not appear in the URL.
+  const path = "/" + dir.filter((s) => !/^\(.*\)$/.test(s)).join("/");
+  const dynamic = dir.some((s) => s.startsWith("["));
+  routes.push({ route: path === "/" ? "/" : path, file: relative(root, file), types: [...types], dynamic });
+}
+
+const byType = {};
+for (const r of routes) {
+  for (const t of r.types) {
+    const entry = (byType[t] ??= { type: t, routes: [], contentDir: CONTENT_OVERRIDES[t] ?? `content/en/${t}`, pages: [] });
+    entry.routes.push(r.route);
+  }
+}
+for (const e of Object.values(byType)) {
+  const abs = join(root, e.contentDir);
+  if (existsSync(abs)) {
+    e.pages = readdirSync(abs).filter((f) => /\.mdx?$/.test(f)).map((f) => f.replace(/\.mdx?$/, ""));
+  }
+  // A type served by a dynamic route takes new pages; a static-only type is one page.
+  e.takesNewPages = routes.some((r) => r.dynamic && r.types.includes(e.type));
+}
+
+let manifest = null;
+const manifestPath = join(root, ".ailk-site-manifest.json");
+if (existsSync(manifestPath)) {
+  const m = JSON.parse(readFileSync(manifestPath, "utf8"));
+  manifest = { shape: m.shape ?? null, design: m.design ?? null, level: m.level ?? null, modules: m.modules ?? m.requires ?? null };
+}
+
+const result = { manifest, types: Object.values(byType).sort((a, b) => a.type.localeCompare(b.type)) };
+if (asJson) {
+  console.log(JSON.stringify(result, null, 2));
+} else {
+  if (manifest) console.log(`shape: ${manifest.shape}  design: ${manifest.design}  level: ${manifest.level ?? "(not recorded)"}`);
+  console.log("");
+  console.log("type".padEnd(22) + "route(s)".padEnd(34) + "new pages?".padEnd(12) + "existing");
+  for (const e of result.types) {
+    console.log(e.type.padEnd(22) + e.routes.join(" ").padEnd(34) + (e.takesNewPages ? "yes" : "no").padEnd(12) + (e.pages.join(", ") || "—"));
+  }
+}

package/templates/.claude/skills/add-page/templates/comparison-page.mdx.tmpl

@@ -0,0 +1,99 @@
+---
+type: ComparisonPage
+slug: {{SLUG}}
+placeholder: true
+title: {{TITLE}}
+description: {{DESCRIPTION}}
+sections:
+  [
+    {
+      "id": "hero",
+      "type": "hero",
+      "data":
+        {
+          "eyebrow": "Comparisons",
+          "headline": "{{TITLE}}",
+          "subheadline": "{{DESCRIPTION}}",
+          "primaryCta": { "label": "{Primary CTA}", "href": "/contact" },
+        },
+    },
+    {
+      "id": "decision-split",
+      "type": "decision-split",
+      "data":
+        {
+          "headline": "{Which one fits you}",
+          "panels":
+            [
+              {
+                "title": "{{TITLE}}",
+                "checklist":
+                  [
+                    "{Reason 1 to choose us}",
+                    "{Reason 2 to choose us}",
+                    "{Reason 3 to choose us}",
+                  ],
+              },
+              {
+                "title": "{The alternative}",
+                "glyph": "cross",
+                "checklist":
+                  [
+                    "{Reason 1 to choose them instead}",
+                    "{Reason 2 to choose them instead}",
+                  ],
+              },
+            ],
+        },
+    },
+    {
+      "id": "comparison-table",
+      "type": "comparison-table",
+      "data":
+        {
+          "headline": "{How they compare}",
+          "columns":
+            [
+              { "key": "us", "name": "{{TITLE}}", "highlighted": true },
+              { "key": "them", "name": "{The alternative}" },
+            ],
+          "groups":
+            [
+              {
+                "groupName": "{Core features}",
+                "rows":
+                  [
+                    {
+                      "featureName": "{Feature 1}",
+                      "values": { "us": true, "them": false },
+                    },
+                    {
+                      "featureName": "{Feature 2}",
+                      "values": { "us": true, "them": true },
+                    },
+                  ],
+              },
+            ],
+        },
+    },
+    {
+      "id": "cta",
+      "type": "cta",
+      "data":
+        {
+          "variant": "box",
+          "headline": "{Ready to switch?}",
+          "description": "{One sentence on what happens next}",
+          "primaryCta": { "label": "{Primary CTA}", "href": "/contact" },
+          "secondaryCta":
+            {
+              "label": "See all alternatives",
+              "href": "/alternatives",
+              "variant": "outline",
+            },
+        },
+    },
+  ]
+---
+
+{/* Rendered from frontmatter `sections[]` by the /vs/<slug> route (D10 — the generic detail chassis: hero, decision-split, comparison-table, cta; no dedicated comparison section). Listed automatically by the /alternatives hub. Placeholder copy — replace every {brace} with your own words before you launch. */}

package/templates/.claude/skills/add-page/templates/content.mdx.tmpl

@@ -5,24 +5,14 @@ title: {{TITLE}}
 description: {{DESCRIPTION}}
 ---
 
+{/*
+  Written by the add-page skill, used only when this site had no other page of
+  this type to copy. The frontmatter drives the page's route and its JSON-LD:
+  keep `type` as it is, and make `description` a true one-sentence summary.
+  Run `fill-page` to write the real copy, then `check-site` to score it.
+  Extra structured data goes in a `schema:` block — see the add-page skill.
+*/}
+
 # {{TITLE}}
 
 {{DESCRIPTION}}
-
-<!--
-  This is the MDX content stub emitted by `add-page`.
-  The frontmatter is the source of truth for JSON-LD — the
-  `{{BUILDER}}(page)` call in `app/{{SLUG}}/page.tsx` reads it.
-
-  Edit this file freely:
-   - Add sections, prose, components imported from your project.
-   - Update `description` (it's used both as the meta description
-     and as input to the JSON-LD builder).
-   - Don't change `type` unless you also update the route's import
-     to match a different `@working-theory/schema` builder.
-
-  When you're happy with the page, run `check-site` to see
-  how it scores on citation-readiness. Use the `schema:` frontmatter
-  override to add supplementary schema (FAQPage, HowTo, etc.) without
-  re-scaffolding.
--->

package/templates/.claude/skills/add-page/templates/flow-landing-page.mdx.tmpl

@@ -0,0 +1,43 @@
+---
+type: LandingPage
+slug: {{SLUG}}
+placeholder: true
+title: {{TITLE}}
+description: {{DESCRIPTION}}
+sections:
+  [
+    {
+      "id": "hero",
+      "type": "hero",
+      "data":
+        {
+          "variant": "centered",
+          "eyebrow": "{{TITLE}}",
+          "headline": "{{TITLE}}",
+          "subheadline": "{{DESCRIPTION}}",
+          "primaryCta":
+            { "label": "{Get started →}", "href": "/flows/{{FLOW_SLUG}}/start" },
+          "ctaSize": "xl",
+        },
+    },
+    {
+      "id": "request",
+      "type": "cta",
+      "data":
+        {
+          "variant": "minimal",
+          "headline": "{Ready?}",
+          "primaryCta":
+            { "label": "{Get started →}", "href": "/flows/{{FLOW_SLUG}}/start" },
+        },
+    },
+  ]
+---
+
+{/* This page's CTA opens the `{{FLOW_SLUG}}` flow at
+    /flows/{{FLOW_SLUG}}/start — a signal-collectors module route, not a page
+    this seed owns. The flow definition itself
+    (`database/flows/{{FLOW_SLUG}}.flow.json`) is a separate artifact this
+    skill does not write; seed it via the flow engine before this page's CTA
+    resolves. Placeholder copy — replace every {brace} with your own words
+    before you launch. */}

package/templates/.claude/skills/add-page/templates/report-page.mdx.tmpl

@@ -0,0 +1,52 @@
+---
+type: ReportPage
+slug: {{SLUG}}
+placeholder: true
+title: {{TITLE}}
+description: {{DESCRIPTION}}
+schema:
+  datePublished: "{{DATE_PUBLISHED}}"
+  author:
+    "@type": Organization
+    name: "{Your Company}"
+sections:
+  [
+    {
+      "id": "header",
+      "type": "report-header",
+      "data":
+        {
+          "title": "{{TITLE}}",
+          "eyebrow": "{{DATE_LABEL}}",
+          "backHref": "/reports",
+          "backLabel": "All reports",
+          "tone": "on-dark",
+        },
+    },
+    {
+      "id": "document",
+      "type": "document-viewer",
+      "data":
+        {
+          "src": "/reports/sample-report.pdf",
+          "geometry": "16:9",
+          "pages": 8,
+          "downloadFilename": "{{SLUG}}.pdf",
+          "outline":
+            [
+              { "id": "opening", "label": "Opening", "startPage": 1 },
+              { "id": "findings", "label": "Findings", "startPage": 3 },
+              { "id": "outlook", "label": "Outlook", "startPage": 6 },
+            ],
+        },
+    },
+  ]
+---
+
+{/* A PLACEHOLDER report. Its bytes are the signal-collectors module's own
+    sample PDF (apps/web/public/reports/sample-report.pdf), shared by every
+    sample report so the site ships no binary of its own. Point `src` at your
+    real document and set `pages` to its real page count. Rendered by the
+    signal-collectors module's own /reports/<slug> route (`app/[locale]/reports/[slug]/page.tsx`)
+    and listed automatically by the /reports hub (ReportsList) — never
+    hand-list a report there. */}

package/templates/.claude/skills/add-page/templates/reports-list.mdx.tmpl

@@ -0,0 +1,38 @@
+---
+type: ReportsList
+slug: reports
+placeholder: true
+title: {{TITLE}}
+description: {{DESCRIPTION}}
+sections:
+  [
+    {
+      "id": "hero",
+      "type": "hero",
+      "data":
+        {
+          "variant": "centered",
+          "eyebrow": "Reports",
+          "headline": "{{TITLE}}",
+          "subheadline": "{{DESCRIPTION}}",
+        },
+    },
+    {
+      "id": "closing",
+      "type": "cta",
+      "data":
+        {
+          "variant": "minimal",
+          "headline": "{Want the next one as it lands?}",
+          "primaryCta": { "label": "{Contact me →}", "href": "/contact" },
+        },
+    },
+  ]
+---
+
+{/* Rendered from frontmatter `sections[]` by the /reports route
+    (`app/[locale]/reports/page.tsx`). Its card list is GENERATED, not
+    authored here (spec 6892 D2): the route appends one `reports-list`
+    section listing every ReportPage seed, so this seed carries only its own
+    hero and closing cta. Placeholder copy — replace every {brace} with your
+    own words before you launch. */}