seo-suite

Foundation step. Scaffolds a project's SEO profile (seo/profile.json) + data dirs by inferring from the repo and interviewing the user. Re-runnable for edits. Usage /seo-init

Phase 1 — keyword research for the current project. Runs the fetchers, consolidation, clustering, intent classification, and scoring. Output to seo/reports/keywords.<YYYY-MM-DD>.json.

Phase 2 orchestrator — from scored keywords to a publication schedule. Chains seo-rubric-proposer → human gate → seo-title-proposer → human gate → seo-roadmap-builder.

Phase 3 orchestrator — AUTONOMOUS pipeline from a roadmap slug to a finished content artifact (body.md + meta.json). Profile-driven; toggled fact-check/legal/cover. Publishing is out of scope. Usage /seo-write-article <slug> [--interactive]

Step 1/9 of SEO Phase 3. Generates a brief for a specific article (slug), driven entirely by the project profile. Reads the latest roadmap + topics + keywords reports plus the profile. Output: <articlesDir>/<slug>/brief.md. First step of the writing pipeline.

SEO Phase 3 step. Runs ONLY when cover.enabled is true — otherwise exits SKIPPED. Generates ONE cover image automatically (OpenAI gpt-image-1), converts it to cover.webp in the article dir, and records the prompt into meta.json (cover.prompt). Project-agnostic; style hints from cover.style. Graceful skip when OPENAI_API_KEY is absent.

SEO Phase 3 step. Writes the full article draft from brief + outline + sources, in the project's language and voice. Output is body.md — pure article content, no framework front matter. Each hard fact carries an inline citation [^srcN]. Project-agnostic; reads seo/profile.json. Writes human-sounding prose (voice, burstiness, specifics) — not smooth AI filler.

Step 6/9 of SEO Phase 3 — fact-check gate. Extracts every hard fact / concrete claim from the draft and checks it against sources.json, driven by the project profile's contentRigor. In regulated mode it is a HARD gate (missing/off-whitelist citation = BLOCK); in standard mode it is a LIGHT gate (concrete claims need a named credible source; soft issues = WARN). Output: <articlesDir>/<slug>/fact-check.json.

SEO Phase 3 compliance gate. Runs ONLY when contentRigor === "regulated" AND regulated.legalReview is true — otherwise exits SKIPPED. Verifies the article carries the required disclaimer, grounds the expected key acts, and contains no forbidden product claims. Project-agnostic; all criteria come from the regulated.* block of seo/profile.json. Records its verdict into meta.json.

Scaffold a project's SEO profile (seo/profile.json) and data dirs by inferring from the repo and interviewing the user. Use when the user wants to "set up SEO", "initialize SEO suite", "create an SEO profile", "configure SEO for this project", or asks how to start using the SEO suite in a new project. Re-runnable for edits.

Run Phase 1 of the SEO suite — keyword research for the current project. Fetchers → consolidation → clustering → intent classification → scoring, producing seo/reports/keywords.<date>.json. Use when the user asks to "refresh keywords", "run keyword research", "rebuild the keyword report", "update SEO keywords", or starts Phase 1 of the SEO pipeline. Requires seo/profile.json (run seo-init first).

Run Phase 2 of the SEO suite — turn the scored keyword report into a publication schedule. Chains seo-rubric-proposer → human gate → seo-title-proposer → human gate → seo-roadmap-builder, producing seo/reports/roadmap.<date>.json. Use when the user asks to "plan SEO topics", "build the content roadmap", "propose pillars and spokes", "generate article titles", or starts Phase 2 of the SEO pipeline. Requires a Phase-1 keywords report (run seo-refresh first).

Run Phase 3 of the SEO suite — the AUTONOMOUS article-writing pipeline that takes a roadmap slug to a finished content artifact (body.md + meta.json). Profile-driven; toggled fact-check, legal review, and cover generation. Publishing is out of scope. Use when the user asks to "write an SEO article", "draft an article from the roadmap", "generate the article for slug X", "run Phase 3", or names a specific roadmap slug to write. Requires a Phase-2 roadmap (run seo-topics first). Accepts an optional --interactive flag to restore human gates.