@wix/agent-skills 1.7.0 → 1.9.0

package/skills/wix-headless/references/astro/templates/bookings/components-bookings.css

@@ -0,0 +1,356 @@
+/* src/styles/components-bookings.css
+ *
+ * Bookings-pack component CSS. Pre-copied by the orchestrator before the build
+ * wave (it is brand-agnostic var(--token) CSS). The designer's global.css does
+ * NOT publish these classes — they live here. See references/shared/STYLING.md
+ * § "Component-specific CSS is owned by the component, not the designer".
+ *
+ * Class groups:
+ * - .service-card / .service-grid / .service-card-*  → ServiceCard.astro, services/index.astro
+ * - .availability-* / .time-slot*                    → AvailabilityCalendar.tsx (week calendar + slots)
+ * - .booking-*                                        → BookingForm.tsx (schema-driven form)
+ *
+ * Primary actions (a selected slot, the confirm button) use var(--color-accent)
+ * so the flow matches the site's primary-action styling.
+ *
+ * Direct var(--token) only (no @apply). Fallback chains for sometimes-published
+ * tokens, e.g. var(--color-paper-warm, var(--color-paper, var(--color-cream))).
+ */
+
+/* ── Service grid + card ────────────────────────────────────────────────────── */
+.service-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
+  gap: var(--spacing-xl);
+  transition: opacity 200ms ease;
+}
+body[data-navigating="true"] .service-grid {
+  opacity: 0.55;
+  pointer-events: none;
+}
+
+.service-card {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  background: var(--color-paper, var(--color-cream));
+  border-radius: var(--radius-xl);
+  overflow: hidden;
+  text-decoration: none;
+  color: inherit;
+  transition: transform 280ms ease, box-shadow 280ms ease;
+  box-shadow: var(--shadow-card, 0 4px 16px -8px rgba(0, 0, 0, 0.15));
+}
+.service-card:hover {
+  transform: translateY(-4px);
+}
+.service-card:hover .service-card-image img {
+  transform: scale(1.04);
+}
+
+.service-card-image {
+  aspect-ratio: 3 / 2;
+  overflow: hidden;
+  background: var(--color-paper-warm, var(--color-surface-secondary, var(--color-cream)));
+}
+.service-card-image img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  transition: transform 600ms ease;
+}
+
+.service-card-meta {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-xs);
+  padding: var(--spacing-md) var(--spacing-md) var(--spacing-lg);
+  flex: 1;
+}
+.service-card-name {
+  margin: 0;
+  font-family: var(--font-display);
+  font-size: 1.125rem;
+  line-height: 1.25;
+  color: var(--color-ink);
+}
+.service-card-tagline {
+  margin: 0;
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-ink-soft, var(--color-mute));
+  line-height: 1.45;
+}
+.service-card-price {
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-sm);
+  margin-top: auto;
+  padding-top: var(--spacing-sm);
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-mute);
+}
+.service-card-price span + span::before {
+  content: "·";
+  padding-right: var(--spacing-sm);
+  color: var(--color-rule);
+}
+
+/* ── Availability — week calendar ───────────────────────────────────────────── */
+.availability-calendar {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-lg);
+}
+
+.availability-week-nav {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--spacing-md);
+  padding: var(--spacing-sm) 0;
+  border-bottom: 1px solid var(--color-rule);
+}
+.availability-week-label {
+  font-family: var(--font-display);
+  font-size: 1rem;
+  color: var(--color-ink);
+  flex: 1;
+  text-align: center;
+}
+
+.availability-nav-btn {
+  padding: var(--spacing-sm) var(--spacing-md);
+  background: transparent;
+  border: 1px solid var(--color-rule);
+  border-radius: var(--radius-sm);
+  color: var(--color-ink);
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  cursor: pointer;
+  transition: background-color 150ms ease, border-color 150ms ease;
+}
+.availability-nav-btn:hover:not(:disabled) {
+  background: var(--color-paper-warm, var(--color-cream));
+  border-color: var(--color-ink);
+}
+.availability-nav-btn:disabled {
+  opacity: 0.35;
+  cursor: not-allowed;
+}
+
+/* The 7-day strip. */
+.availability-day-strip {
+  display: grid;
+  grid-template-columns: repeat(7, 1fr);
+  gap: var(--spacing-sm);
+}
+.availability-day {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 2px;
+  padding: var(--spacing-sm) 0;
+  border: 1px solid var(--color-rule);
+  border-radius: var(--radius-sm);
+  background: var(--color-paper, var(--color-cream));
+  color: var(--color-ink);
+  font-family: var(--font-body);
+  cursor: pointer;
+  transition: background-color 150ms ease, border-color 150ms ease, color 150ms ease;
+}
+.availability-day-name {
+  font-size: 0.7rem;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--color-mute);
+}
+.availability-day-num {
+  font-size: 1rem;
+  font-weight: 600;
+}
+.availability-day--has-slots:hover {
+  border-color: var(--color-accent);
+}
+.availability-day--empty {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+.availability-day--selected {
+  background: var(--color-accent);
+  border-color: var(--color-accent);
+  color: var(--color-paper);
+}
+.availability-day--selected .availability-day-name {
+  color: var(--color-paper);
+}
+
+.availability-slots {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(96px, 1fr));
+  gap: var(--spacing-sm);
+}
+.availability-loading,
+.availability-empty,
+.availability-error {
+  font-family: var(--font-body);
+  font-size: 0.9375rem;
+  color: var(--color-ink-soft, var(--color-mute));
+  padding: var(--spacing-lg) 0;
+  text-align: center;
+}
+.availability-empty {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: var(--spacing-md);
+}
+.availability-error {
+  color: var(--color-error, var(--color-accent));
+}
+
+/* ── Time-slot buttons ──────────────────────────────────────────────────────── */
+.time-slot {
+  padding: var(--spacing-sm) var(--spacing-md);
+  border: 1px solid var(--color-rule);
+  border-radius: var(--radius-sm);
+  background: var(--color-paper, var(--color-cream));
+  color: var(--color-ink);
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  text-align: center;
+  cursor: pointer;
+  transition: background-color 150ms ease, border-color 150ms ease, color 150ms ease;
+}
+.time-slot-time {
+  font-weight: 500;
+}
+.time-slot--available {
+  border-color: var(--color-ink);
+}
+.time-slot--available:hover {
+  background: var(--color-accent);
+  border-color: var(--color-accent);
+  color: var(--color-paper);
+}
+.time-slot--selected {
+  background: var(--color-accent);
+  border-color: var(--color-accent);
+  color: var(--color-paper);
+  font-weight: 600;
+}
+
+/* ── Booking form (schema-driven) ───────────────────────────────────────────── */
+.booking-form {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-lg);
+  padding: var(--spacing-xl);
+  border: 1px solid var(--color-rule);
+  border-radius: var(--radius-md);
+  background: var(--color-paper-warm, var(--color-paper, var(--color-cream)));
+}
+
+.booking-form-summary {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-xs);
+  padding-bottom: var(--spacing-md);
+  border-bottom: 1px solid var(--color-rule);
+}
+.booking-form-summary strong {
+  font-family: var(--font-display);
+  font-size: 1.125rem;
+  color: var(--color-ink);
+}
+.booking-form-summary span {
+  font-family: var(--font-body);
+  font-size: 0.9375rem;
+  color: var(--color-ink-soft, var(--color-mute));
+}
+.booking-form-change {
+  align-self: flex-start;
+  margin-top: var(--spacing-xs);
+  background: none;
+  border: none;
+  padding: 0;
+  font-family: var(--font-body);
+  font-size: 0.8125rem;
+  color: var(--color-mute);
+  text-decoration: underline;
+  cursor: pointer;
+}
+.booking-form-change:hover {
+  color: var(--color-ink);
+}
+
+.booking-field {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-xs);
+}
+.booking-label {
+  font-family: var(--font-display);
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--color-ink-soft, var(--color-mute));
+}
+.booking-required {
+  color: var(--color-accent);
+}
+
+.booking-input {
+  width: 100%;
+  padding: var(--spacing-sm) var(--spacing-md);
+  font-family: var(--font-body);
+  font-size: 0.9375rem;
+  border: 1px solid var(--color-rule);
+  border-radius: var(--radius-sm);
+  background: var(--color-paper, var(--color-cream));
+  color: var(--color-ink);
+  transition: border-color 150ms ease;
+  box-sizing: border-box;
+}
+.booking-input:focus {
+  outline: none;
+  border-color: var(--color-accent);
+}
+textarea.booking-input {
+  resize: vertical;
+  min-height: 6rem;
+}
+
+.booking-error {
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-error, var(--color-accent));
+  padding: var(--spacing-sm) var(--spacing-md);
+  border: 1px solid var(--color-error, var(--color-accent));
+  border-radius: var(--radius-sm);
+}
+
+.booking-cta {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  padding: var(--spacing-md) var(--spacing-xl);
+  font-family: var(--font-display);
+  font-size: 0.9375rem;
+  font-weight: 500;
+  background: var(--color-accent);
+  color: var(--color-paper);
+  border: 1px solid var(--color-accent);
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  transition: opacity 150ms ease;
+}
+.booking-cta:hover:not(:disabled) {
+  opacity: 0.9;
+}
+.booking-cta:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}

package/skills/wix-headless/references/astro/templates/bookings/services/[slug].astro

@@ -0,0 +1,133 @@
+---
+// src/pages/services/[slug].astro — SSR service detail + client-side booking flow.
+// Two dirs deep inside src/ → import with ../../ (not three ../).
+import Layout from "../../layouts/Layout.astro";
+import SeoTags from "../../components/SeoTags.astro";
+import ServiceBookingFlow from "../../components/ServiceBookingFlow";
+import { services } from "@wix/bookings";
+import { forms } from "@wix/forms";
+import { auth } from "@wix/essentials";
+
+const BOOKING_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
+const { slug } = Astro.params;
+
+let service: any = null;
+try {
+  // Ambient SSR via @wix/essentials. Single service by slug: the .eq() builder
+  // chain on mainSlug.name + appId (the form the @wix/bookings SDK expects).
+  const result = await auth
+    .elevate(services.queryServices)({ conditionalFields: ["STAFF_MEMBER_DETAILS"] })
+    .eq("mainSlug.name", slug)
+    .eq("appId", BOOKING_APP_ID)
+    .limit(1)
+    .find();
+  service = result.items?.[0] ?? null;
+} catch (err) {
+  console.error(`[services/${slug}] detail query failed:`, err);
+}
+
+if (!service) return Astro.redirect("/services", 302);
+
+// Booking-form SCHEMA — the form belongs to the service (service.form._id) in the
+// bookings namespace. Read it server-side and pass the field list to the island.
+// Same renderer the forms vertical uses (references/astro/forms/CONTACT_FORM.md):
+// keep the field's `target` — that is the key createBooking expects in formSubmission.
+let formFields: any[] = [];
+try {
+  const formId = service.form?._id;
+  if (formId) {
+    const res: any = await auth.elevate(forms.getForm)(formId);
+    const form = res?.form ?? res;
+    // Only render field types we can submit as a simple value. Skip complex,
+    // object-valued fields (e.g. a multi-line ADDRESS) — they carry no string
+    // `componentType`, and sending a string for them fails createBooking with
+    // "must be object". The booking enforces only the contact basics
+    // (first_name/last_name/email), so skipping optional complex fields is safe.
+    const RENDERABLE = ["TEXT_INPUT", "PHONE_INPUT", "DROPDOWN"];
+    formFields = (form?.formFields ?? [])
+      .filter(
+        (f: any) =>
+          f.fieldType === "INPUT" &&
+          !f.hidden &&
+          RENDERABLE.includes(f.inputOptions?.stringOptions?.componentType),
+      )
+      .map((f: any) => {
+        const opts = f.inputOptions;
+        const str = opts?.stringOptions;
+        const label =
+          str?.textInputOptions?.label ??
+          str?.dropdownOptions?.label ??
+          str?.phoneInputOptions?.label ??
+          "";
+        return {
+          label,
+          target: opts?.target ?? "",
+          required: opts?.required ?? false,
+          componentType: str?.componentType ?? "TEXT_INPUT",
+          identifier: f.identifier ?? "",
+          options: str?.dropdownOptions?.options?.map((o: any) => ({
+            value: o.value ?? o.label ?? "",
+            label: o.label ?? o.value ?? "",
+          })),
+        };
+      });
+  }
+} catch (err) {
+  console.error(`[services/${slug}] booking form schema failed:`, err);
+}
+
+const formatPrice = (p: any): string | undefined => {
+  if (!p || p.rateType === "NO_FEE") return undefined;
+  if (p.rateType === "FIXED" && p.fixed?.price) {
+    const { value, currency } = p.fixed.price;
+    if (!value) return undefined;
+    return new Intl.NumberFormat("en-US", { style: "currency", currency: currency ?? "USD" }).format(Number(value));
+  }
+  return undefined;
+};
+const price = formatPrice(service.payment);
+const duration = service.schedule?.availabilityConstraints?.sessionDurations?.[0] ?? 60;
+const imageUrl = service.media?.mainMedia?.image?.url ?? service.media?.items?.[0]?.image?.url;
+const serviceName = service.name ?? "Service";
+const seoTags = service.seoData?.tags ?? [];
+---
+
+<!--
+  Width: use `container-reading` (max-width: var(--container-prose) + auto margins),
+  NOT a bare `max-w-<size>` — in this Tailwind v4 setup an un-emitted max-w-<size>
+  key falls back to the spacing scale (e.g. max-w-4xl → ~7rem, one word per line).
+-->
+<Layout title={serviceName} description={service.tagLine ?? service.description}>
+  <SeoTags tags={seoTags} slot="head" />
+  <section class="container-reading px-lg py-4xl">
+    <a href="/services" class="inline-block text-sm text-mute hover:text-ink mb-xl">← All services</a>
+
+    <!-- Optional banner image — only when the service has media (image-less is the
+         common seed case; rendering a fixed placeholder collapses the layout). -->
+    {imageUrl && (
+      <img src={imageUrl} alt={serviceName} class="w-full h-64 object-cover rounded-lg mb-xl" />
+    )}
+
+    <div class="flex flex-col gap-md mb-3xl">
+      <hr class="editorial-rule w-16 ml-0" />
+      <h1 class="font-display text-4xl md:text-5xl leading-tight">{serviceName}</h1>
+      {service.tagLine && <p class="text-lg text-mute leading-relaxed max-w-prose">{service.tagLine}</p>}
+      <div class="flex items-center gap-md text-sm text-mute">
+        <span>{duration} min</span>
+        {price && <span class="text-ink font-medium">{price}</span>}
+      </div>
+      {service.description && <p class="text-ink leading-relaxed max-w-prose">{service.description}</p>}
+    </div>
+
+    <section class="border-t border-rule pt-2xl">
+      <h2 class="font-display text-3xl leading-tight mb-xl">Book this service</h2>
+      <ServiceBookingFlow
+        service={service}
+        serviceName={serviceName}
+        serviceType={service.type ?? "APPOINTMENT"}
+        fields={formFields}
+        client:only="react"
+      />
+    </section>
+  </section>
+</Layout>

package/skills/wix-headless/references/astro/templates/bookings/services/index.astro

@@ -0,0 +1,73 @@
+---
+// src/pages/services/index.astro — SSR services listing grid (APPOINTMENT or CLASS).
+// One dir deep inside src/pages → ../../ reaches src/. Adapt copy/headings to the
+// brand; keep the SSR data wiring.
+import Layout from "../../layouts/Layout.astro";
+import ServiceCard from "../../components/ServiceCard.astro";
+import { services } from "@wix/bookings";
+import { auth } from "@wix/essentials";
+
+// Wix Bookings app id — the base filter must scope queryServices to it.
+const BOOKING_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
+
+let serviceList: any[] = [];
+try {
+  // Ambient @wix/astro SSR client via @wix/essentials (same pattern as CMS pages).
+  // Do NOT build createClient({ auth: OAuthStrategy({ clientId: import.meta.env.* }) }) —
+  // that env var is client-only and undefined at server render → 500.
+  // Pass the request object (filter must include appId) + conditionalFields, then .find().
+  const result = await auth
+    .elevate(services.queryServices)({
+      query: { filter: { appId: BOOKING_APP_ID }, paging: { limit: 100 } },
+      conditionalFields: ["STAFF_MEMBER_DETAILS"],
+    })
+    .find();
+  serviceList = (result.items ?? []).filter((s: any) => !s.hidden);
+} catch (err) {
+  console.error("[services] listing query failed:", err);
+}
+
+const getSlug = (s: any): string => s.mainSlug?.name ?? s.supportedSlugs?.[0]?.name ?? s._id;
+const formatPrice = (s: any): string | undefined => {
+  const p = s.payment;
+  if (!p || p.rateType === "NO_FEE") return undefined;
+  if (p.rateType === "FIXED" && p.fixed?.price) {
+    const { value, currency } = p.fixed.price;
+    if (!value) return undefined;
+    return new Intl.NumberFormat("en-US", { style: "currency", currency: currency ?? "USD" }).format(Number(value));
+  }
+  return undefined;
+};
+const getDuration = (s: any): number => s.schedule?.availabilityConstraints?.sessionDurations?.[0] ?? 60;
+---
+
+<Layout title="Services">
+  <section class="max-w-6xl mx-auto px-lg py-4xl">
+    <header class="flex flex-col gap-md max-w-prose mb-3xl">
+      <hr class="editorial-rule w-16 ml-0" />
+      <h1 class="font-display text-4xl md:text-5xl leading-tight">Our Services</h1>
+      <!-- Optional brand tagline -->
+    </header>
+
+    {
+      serviceList.length === 0 ? (
+        <p class="text-mute">Services coming soon — check back shortly.</p>
+      ) : (
+        <div class="service-grid">
+          {serviceList.map((s) => (
+            <ServiceCard
+              id={s._id}
+              slug={getSlug(s)}
+              name={s.name ?? "Untitled"}
+              tagLine={s.tagLine ?? s.description}
+              durationMinutes={getDuration(s)}
+              price={formatPrice(s)}
+              imageUrl={s.media?.mainMedia?.image?.url ?? s.media?.items?.[0]?.image?.url}
+              type={s.type ?? "APPOINTMENT"}
+            />
+          ))}
+        </div>
+      )
+    }
+  </section>
+</Layout>

package/skills/wix-headless/references/astro/templates/global.css

@@ -1,7 +1,7 @@
 /* ── Composer skeleton: src/styles/global.css ──────────────────────────────
    The fixed bulk below is LITERAL — do not re-author it. Composer's only edit
    is to replace the {{theme}} block with the @theme palette derived from the
-   inlined designTokens (see COMPOSE.md § "1. global.css"). Everything outside
+   inlined designTokens (see compose.mjs). Everything outside
    {{theme}} references the stable token vocabulary via var(--token) / built-in
    utilities and is brand-agnostic; ship it byte-for-byte.
    ─────────────────────────────────────────────────────────────────────────── */
@@ -11,7 +11,7 @@
 @theme {
   /* {{theme}} — Composer substitutes the full palette here from designTokens:
      every --color-*, --font-*, --spacing-* (2xs..4xl), --container-*, and
-     --radius-* line. The required-token set (COMPOSE.md § "Token contract")
+     --radius-* line. The required-token set (enforced by compose.mjs)
      MUST all be present, or components render unstyled. Container scale is
      separate from spacing — never alias --container-3xl to --spacing-3xl. */
 }

package/skills/wix-headless/references/astro/templates/index.astro

@@ -1,6 +1,6 @@
 ---
 // ── Composer skeleton: src/pages/index.astro ──────────────────────────────────
-// Home shell. Substitutions (see COMPOSE.md § "6. index.astro"):
+// Home shell. Substitutions (see compose.mjs):
 //   {{shell.heroHeadline}}, {{shell.heroSub}} — brand-voice hero copy.
 //   {{shell.footerTagline}} is NOT used here.
 //   {{brand.name}} — used in the brand-story copy.

package/skills/wix-headless/references/blog/BLOG_CONTENT.md

@@ -120,9 +120,8 @@ Use these node types to build rich, varied content:
 - LIST_ITEM nodes contain PARAGRAPH nodes (not TEXT directly)
 - Mix at least 3 different node types per post for visual variety
 - Create all 3 posts in sequence (one `curl` call per post)
-- **Best practice:** include all fields (title, content, media) in the initial creation call to avoid needing a re-publish
 
-> **Re-publish after PATCH:** If you update a published post (e.g., adding a cover image via PATCH after creation), it becomes `hasUnpublishedChanges: true`. You must call `POST /blog/v3/draft-posts/{draftPostId}/publish` to re-publish. To avoid this, include media in the initial creation call.
+> **Re-publish after PATCH:** If you update a published post (e.g., the image agent adds a cover image via PATCH after creation), it becomes `hasUnpublishedChanges: true`. The agent that PATCHes must call `POST /blog/v3/draft-posts/{draftPostId}/publish` to re-publish. (This seed scope does not attach media — see Step 3.)
 
 ## Step 4: Verify
 
@@ -139,13 +138,24 @@ body: {
 
 Confirm 3 posts are returned. Report post titles to the user.
 
-### Step 5: Log Results
+## Step 5: Return Results
 
-Write a sidecar file at `.wix/logs/blog-data.md` (see `../../shared/LIFECYCLE_LOG.md` for the sidecar contract). Do **not** append to `.wix/lifecycle.log.md` directly — the orchestrator concatenates all sidecars at the end. Use a `####` heading so the entry nests under `### features-orchestrator` in the assembled log:
+Emit a structured JSON block at the end of your completion message per `../shared/RETURN_CONTRACT.md`. Do **not** write a sidecar file. Include the created posts' `id` and `title` so the image agent can attach cover images by ID:
 
-```markdown
-## blog
-- Status: complete
-- Content: {n} posts published ({post titles})
-- Images: {generated (n/n attached) | skipped (user declined) | not attempted}
+```json
+{
+  "status": "complete",
+  "phase": "blog-seed",
+  "scope": "seed",
+  "summary": "Created and published {n} on-brand blog posts",
+  "data": {
+    "blogPosts": [
+      { "id": "<uuid>", "title": "<title>" }
+    ]
+  },
+  "files": [],
+  "errors": []
+}
 ```
+
+The JSON block MUST be the last content in your message.

package/skills/wix-headless/references/blog/INSTRUCTIONS.md

@@ -5,7 +5,7 @@ description: "Implements blog vertical via Wix Blog app — @wix/blog SDK, @wix/
 
 # Blog Implementer
 
-Extends `references/shared/IMPLEMENTER.md`. Read that file first for phase routing, REST auth + doc lookups, prompt-inlined inputs (no site.json reads), return contract, style conventions, and common failure modes.
+Extends `references/shared/IMPLEMENTER.md`. Read that file first for phase routing, REST auth + doc lookups, prompt-inlined inputs (read only your `.wix/seeded.json` slice), return contract, style conventions, and common failure modes.
 
 ## Scope routing
 
@@ -13,13 +13,13 @@ Extends `references/shared/IMPLEMENTER.md`. Read that file first for phase routi
 |-------|-------|-----------|
 | `seed` | Seed (post seeding via REST with Ricos content) | `./BLOG_CONTENT.md` |
 | `components` | Components (blog service module, RicosViewer, consts, astro.config sitemap) | `../astro/blog/BLOG_SETUP.md` |
-| `pages` | Pages (listing, detail, RSS, BlogPost layout, home contribution) | `../astro/blog/BLOG_PAGES.md` |
+| `pages` | Pages (listing, detail, RSS, BlogPost layout — all under `src/pages/blog/*`; no shared-shell patch, so blog merges into one private build agent) | `../astro/blog/BLOG_PAGES.md` |
 
 Cover images are generated by the shared image agent (`image-phase-2-entity` scope) AFTER `seed` completes — not by this agent.
 
 ## Files this vertical creates / contributes
 
-See `<SKILL_ROOT>/references/verticals/blog.md` frontmatter.
+The `components` and `pages` scopes enumerate their own file lists — see `../astro/blog/BLOG_SETUP.md` (components) and `../astro/blog/BLOG_PAGES.md` (pages).
 
 ## Blog-specific failure modes