{"meta":{"schema_version":1,"version":"1.0.0","generated_at":"2026-06-04T16:46:10Z","generated_from_repo_sha":"cd8f012","maintainer":"Sphere web team","notes":"v1.0.0 — initial release. Converts SphereIQ \"Sphere Quarterly\" mockups into site-styled /blogs articles: a Payload `posts` record (listing/SEO) plus a code-owned bespoke layout, restyled from the mockups' warm/per-issue palette to our brand. Encodes the pipeline (scope generator → register → shared overrides → seed), the brand conversion (DM Sans / Lora / Geist Mono, neutral gray scale, brand blue #1677ff, brand green #3bac52, brand purple #7F71FB held in reserve), the canonical repo files, and the regeneration-safety caveats. Validated by porting the first batch: agent-ready-sites, self-rewriting-site, compliance-as-runtime."},"online":{"manifest_url":"https://www.sphereinc.com/dev/skills/sphereiq-to-sphere-blog/manifest.json","version_url":"https://www.sphereinc.com/dev/skills/sphereiq-to-sphere-blog/version.json","changelog_url":"https://www.sphereinc.com/dev/skills/sphereiq-to-sphere-blog/changelog.md","self_update":"On skill activation, fetch version_url (5-min cache) and compare its `version` to this manifest's meta.version. If the remote is newer, re-fetch manifest_url + changelog_url, replace the local snapshot, and surface the changelog before acting."},"project":{"repo":"SITE/sphereinc-com","stack":"Next.js 16 App Router + Payload + Tailwind v4 + Neon Postgres","run_from":"repo root (so node resolves the project's postcss)","trigger":"porting/converting a SphereIQ \"Sphere Quarterly\" mockup (or any standalone bespoke editorial HTML + sphere.css) into a sphereinc.com /blogs article"},"why":["Mockups are full standalone microsites (own fonts, ~45KB sphere.css, canvas particle hero, heavy inline JS) — they cannot go through the Lexical blog renderer, so the layout lives in code keyed by slug.","They are articles, not microsites — each is a Payload `posts` record (lists in /blogs, sitemap, SEO), rendered at /blogs/ inside the real site Header/Footer; the mockup's own topbar/footer are dropped.","sphere.css is scoped under `.quarterly-scope` so it can't leak into the site chrome; overrides.css recolors the warm/per-issue palette to our brand."],"architecture":{"render_route":"src/app/(frontend)/blogs/[slug]/page.tsx — `if (isQuarterly(slug)) return ` (no change needed for new slugs)","component":"src/components/QuarterlyArticle — loads fonts, imports scoped CSS + overrides, injects BODY + STYLE + SCRIPT","content_module":"src/content/quarterly/.ts — generated { meta, STYLE, BODY, SCRIPT } per article","registry":"src/content/quarterly/index.ts — QUARTERLY map + isQuarterly(slug)","scoped_css":"src/content/quarterly/sphere.scoped.css — the mockups' shared sphere.css scoped under .quarterly-scope (generated once per batch)","overrides":"src/content/quarterly/overrides.css — the brand conversion (regeneration-safe; imported AFTER the scoped css)","seed":"src/scripts/seed-quarterly-articles.ts — creates/updates the posts records","generator":".claude/skills/sphereiq-to-sphere-blog/scripts/gen-quarterly.mjs"},"pipeline":[{"n":1,"name":"Get inputs","do":"Pull the mockup HTML(s) + sphere.css (usually Monday assets via get_assets → signed S3 URLs; the protected_static links 404). Save to a temp dir."},{"n":2,"name":"Scope sphere.css (once per batch)","cmd":"node .claude/skills/sphereiq-to-sphere-blog/scripts/gen-quarterly.mjs --scope-css src/content/quarterly/sphere.scoped.css","note":"Only when the batch's sphere.css changed; all issues in a batch share it."},{"n":3,"name":"Generate the content module (per article)","cmd":"node .claude/skills/sphereiq-to-sphere-blog/scripts/gen-quarterly.mjs .html src/content/quarterly/.ts ","note":"Extracts inline