create-ailk 0.8.0 → 0.9.0

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

@@ -20,6 +20,13 @@ 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
@@ -28,88 +35,90 @@ 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. */}

package/templates/.claude/skills/check-site/SKILL.md

@@ -34,6 +34,23 @@ Skip this skill when:
 
 ## The mechanic
 
+### Step 0 — Read what this site can render
+
+Read `.ailk-site-manifest.json` at the site root, the site's roster of
+record:
+
+- `modules` — the modules this site has. Add any module the
+  `# Modules:` line of `architecture.yaml` names that `modules` does not:
+  `create-ailk add-module` records a module it adds there. With no
+  manifest, or none carrying `modules`, that line is the set.
+- `rows` — every route the site carries and the page type each renders.
+- `level` — present only when the scaffold derived it from the licence
+  key. It never decides what to suggest; `modules` does.
+
+A page type renders on this site only when its **Module** in
+`.claude/skills/add-page/references/page-types.md` is in that set.
+Step 7 suggests a page only of such a type.
+
 ### Step 1 — Invoke the CLI
 
 Run `ailk-audit --json` from the consumer's project root. Use
@@ -136,6 +153,12 @@ themselves on a subsequent turn.
 | `entity-markup`       | Manual edit — ensure `Organization` (or `Person`) JSON-LD is emitted somewhere site-wide |
 | `faq-howto-incentive` | `add-page`'s `schema:` frontmatter override — add an `FAQPage` or `HowTo` block to a relevant page |
 
+When a fix means adding a page, name only a page type this site can
+render (Step 0) — for `faq-howto-incentive`, a `FAQPage` or `HowTo`
+page, never one the site's modules do not render. When only a type the
+site cannot render would fix a finding, say which module renders it and
+which level carries it, and point at the `upgrade-plan` skill.
+
 Phrase the pointer as a single sentence:
 
 > "Missing `Product` schema on `/pricing` — add it via `add-page`'s

package/templates/.claude/skills/fill-page/SKILL.md

@@ -67,15 +67,30 @@ comes from `_site.mdx` `siteIdentity.name`.
 
 ## Step 0 — Read
 
-1. Read the profile: `profiles/<slug>.yaml`.
-2. Read `content/_site.mdx` for `siteIdentity.name`.
-3. Read the page file. Note its stack (`sections[].type` in order).
-4. For each section type in the stack, read its data schema: the
+1. Read `.ailk-site-manifest.json` at the site root, the site's roster
+   of record: `modules` (the modules this site has) and `rows` (every
+   route it carries). Add any module the `# Modules:` line of
+   `architecture.yaml` names that `modules` does not — `create-ailk
+   add-module` records a module it adds there; with no manifest, or none
+   carrying `modules`, that line is the set. `level`, when present, never
+   decides anything here.
+
+   The page's `type` must render on this site: its **Module** in
+   `../add-page/references/page-types.md` is in that set, or a row
+   already renders it (`rows[].pageType` — a Free starter's `/meet/<slug>`
+   `BookCall` placeholders). When it does not,
+   say which module renders the type and which level carries it, point at
+   the `upgrade-plan` skill, and stop. Never fill a page this site cannot
+   render.
+2. Read the profile: `profiles/<slug>.yaml`.
+3. Read `content/_site.mdx` for `siteIdentity.name`.
+4. Read the page file. Note its stack (`sections[].type` in order).
+5. For each section type in the stack, read its data schema: the
    `<Type>SectionDataSchema` (or `<Type>DataSchema`) export in the
    installed `@working-theory/validation`'s `schemas/page-sections`. Fill
    only fields the schema declares. Every field a section renders from
    copy gets content; a field the source page did not use stays unused.
-5. Find the route that renders this page type under `apps/web/app/[locale]/`
+6. Find the route that renders this page type under `apps/web/app/[locale]/`
    and read its `bodyMode`. When it is `"mdx-body"`, the MDX body is
    rendered and must be filled too. Otherwise the body is a short note,
    and you rewrite it as one plain sentence that names no braces.
@@ -88,7 +103,9 @@ fields and intake answers that fill it.
 1. **Sections.** For each section, in place, write every copy field from
    the profile using `references/section-sources.md`:
    - offerings → `items` entries (`title` = the offering `name`,
-     `description` = its `job`, `link.href` = `/services/<kebab name>`);
+     `description` = its `job`, `link.href` = `/services/<kebab name>`
+     only when the manifest's `rows` carry `/services/[slug]`; otherwise
+     no `link`, so no entry points at a page the site does not have);
    - vocabulary → headlines, eyebrows and FAQ questions (the buyer's own
      words: the `problem` list for what went wrong, `outcome` for what
      they get);
@@ -176,5 +193,7 @@ and run both again. Stop only when both are clean.
 - Tier 3 (the Messaging Canvas through the content pipeline).
 - Create a page — use `add-page`.
 - Edit `_site.mdx`, the nav or the page roster. A profile's `roster` and
-  `nav` entries are declared for a later step and are not applied here.
+  `nav` entries are declared for a later step and are not applied here,
+  and a profile page type this site cannot render (Step 0) is never
+  suggested.
 - Write a price, a name or an address the owner did not give.

package/templates/.claude/skills/fill-page/profiles/plumbing.yaml

@@ -50,7 +50,7 @@ vocabulary:
     - tidy job, nothing left behind
 roster:
   - op: add
-    route: /emergency
+    route: /meet/emergency
     pageType: BookCall
     reason: Emergency jobs book a call, not a form.
   - op: drop