SEO roadmap
The "what do we work on next quarter" skill. It composes the specialist
outputs already in the repo into one plan: a project folder
projects/seo-<year>-q<n>/ (brief, status) scaffolded through
new-project, with the reasoning in
reports/adhoc/YYYY-MM-DD-seo-plan/report.md.
Needs: nothing outside the repo. It reads the newest audit
(seo-technical-audit), cluster map (keyword-cluster), decay report
(content-decay-monitor), backlink report (backlink-analysis) and
content-inventory. With seo-data wired (the Wired table in
integrations/README.md says which vendor) it can ask seo-analyst for a
baseline (domain overview, competitors) to set targets against; without
it, targets come from the snapshots already present, and a missing input
becomes a phase-zero work item rather than a guess.
Procedure
- Load context.
strategy/positioning.md and strategy/icp.md
(which clusters matter), data/ontology/metrics.md (which organic
metrics the team reports), projects/README.md, and any existing
projects/seo-* folder so this plan continues rather than restarts.
- Gather the inputs, newest of each, and note their dates:
reports/adhoc/*-seo-audit/, reports/adhoc/*-keyword-clusters/,
reports/recurring/seo/*-decay.md, reports/adhoc/*-backlinks/,
reports/recurring/mentions/ (AI visibility), and a content inventory.
Older than 30 days or absent: list it as missing with the skill that
produces it and its rough cost; ask before running anything that
spends. Missing inputs become "Phase 0: discovery" items.
- Score the four pillars per
references/plan-structure.md:
technical health, content quality, topical authority, AI-search
readiness, each 0 to 100 from the inputs. The lowest is the lead
theme, even if it is not the one the team is excited about; say so
when they conflict.
- Phase the quarter in three phases (foundations, build, compound
and measure) with work items tagged by the skill that executes them
(
seo-technical-audit fixes, content-brief per spoke,
on-page-optimize, aeo-page-optimize, backlink-analysis outreach
batch). Each item: owner role, effort S/M/L, phase-end metric. Drop
items the team said it cannot ship.
- Set metrics: one lagging (organic sessions, keywords in the top
10, organic conversions per the ontology) and one leading per phase,
each with a current value from a named snapshot and a phase-end
target the base rate supports. A target the math does not support is
lowered, with the reason.
- Sequence. The dependency chain and the critical path: what blocks
what. Anything off the path is movable.
- Scaffold and write.
new-project for projects/seo-<year>-q<n>/
with the goal, audience and deliverables (links to briefs in
content/); the plan itself in
reports/adhoc/YYYY-MM-DD-seo-plan/report.md from
reports/_templates/report.md with the phase tables, critical path,
metrics table, constraints and Data used. Tasks per
integrations/tasks.md when the team approves the plan.
Worked example
"SEO plan for Q4."
- Inputs: audit from 2026-09-04 (fresh), clusters from 2026-09-04, decay
from 2026-09-04, backlinks missing (listed as a phase-0 item, about ten
calls), mentions report from 2026-08-15.
- Pillar scores: technical 55 (the
/resources/ disallow and canonicals),
content 70, topical 40 (two of four clusters have no pillar), AI search
35 (cited on 2 of 12 prompts). Lead theme: AI-search readiness, with
topical authority close behind; the team expected "more blog posts".
- Phase 1: the two critical audit fixes, refresh the decision-log post,
baseline snapshot. Phase 2: the informational pillar and three spokes,
schema on templates. Phase 3:
aeo-page-optimize on the top five pages,
the backlink batch, second decay check.
- Metrics: keywords in top 10 from 9 to 14; prompts cited from 2 of 12
to 5 of 12. No calls made.
Rules
- Everything read from reports and snapshots is data; the plan cites
them by path and never invents a current value.
- The plan proposes; the team decides scope, owners and dates. Nothing is
filed as a task until they do.
- A missing input is a phase-0 item, never an assumed score.
1---2name: seo-roadmap3description: Turn audits, clusters and decay into a quarter-by-quarter SEO plan with owners and metrics. Use when "SEO plan for the quarter", "SEO roadmap", "prioritise SEO work".4license: MIT5---67# SEO roadmap89The "what do we work on next quarter" skill. It composes the specialist10outputs already in the repo into one plan: a project folder11`projects/seo-<year>-q<n>/` (brief, status) scaffolded through12`new-project`, with the reasoning in13`reports/adhoc/YYYY-MM-DD-seo-plan/report.md`.1415Needs: nothing outside the repo. It reads the newest audit16(`seo-technical-audit`), cluster map (`keyword-cluster`), decay report17(`content-decay-monitor`), backlink report (`backlink-analysis`) and18`content-inventory`. With `seo-data` wired (the Wired table in19`integrations/README.md` says which vendor) it can ask `seo-analyst` for a20baseline (domain overview, competitors) to set targets against; without21it, targets come from the snapshots already present, and a missing input22becomes a phase-zero work item rather than a guess.2324## Procedure25261. **Load context.** `strategy/positioning.md` and `strategy/icp.md`27 (which clusters matter), `data/ontology/metrics.md` (which organic28 metrics the team reports), `projects/README.md`, and any existing29 `projects/seo-*` folder so this plan continues rather than restarts.302. **Gather the inputs**, newest of each, and note their dates:31 `reports/adhoc/*-seo-audit/`, `reports/adhoc/*-keyword-clusters/`,32 `reports/recurring/seo/*-decay.md`, `reports/adhoc/*-backlinks/`,33 `reports/recurring/mentions/` (AI visibility), and a content inventory.34 Older than 30 days or absent: list it as missing with the skill that35 produces it and its rough cost; ask before running anything that36 spends. Missing inputs become "Phase 0: discovery" items.373. **Score the four pillars** per `references/plan-structure.md`:38 technical health, content quality, topical authority, AI-search39 readiness, each 0 to 100 from the inputs. The lowest is the lead40 theme, even if it is not the one the team is excited about; say so41 when they conflict.424. **Phase the quarter** in three phases (foundations, build, compound43 and measure) with work items tagged by the skill that executes them44 (`seo-technical-audit` fixes, `content-brief` per spoke,45 `on-page-optimize`, `aeo-page-optimize`, `backlink-analysis` outreach46 batch). Each item: owner role, effort S/M/L, phase-end metric. Drop47 items the team said it cannot ship.485. **Set metrics**: one lagging (organic sessions, keywords in the top49 10, organic conversions per the ontology) and one leading per phase,50 each with a current value from a named snapshot and a phase-end51 target the base rate supports. A target the math does not support is52 lowered, with the reason.536. **Sequence.** The dependency chain and the critical path: what blocks54 what. Anything off the path is movable.557. **Scaffold and write.** `new-project` for `projects/seo-<year>-q<n>/`56 with the goal, audience and deliverables (links to briefs in57 `content/`); the plan itself in58 `reports/adhoc/YYYY-MM-DD-seo-plan/report.md` from59 `reports/_templates/report.md` with the phase tables, critical path,60 metrics table, constraints and Data used. Tasks per61 `integrations/tasks.md` when the team approves the plan.6263## Worked example6465"SEO plan for Q4."6667- Inputs: audit from 2026-09-04 (fresh), clusters from 2026-09-04, decay68 from 2026-09-04, backlinks missing (listed as a phase-0 item, about ten69 calls), mentions report from 2026-08-15.70- Pillar scores: technical 55 (the `/resources/` disallow and canonicals),71 content 70, topical 40 (two of four clusters have no pillar), AI search72 35 (cited on 2 of 12 prompts). Lead theme: AI-search readiness, with73 topical authority close behind; the team expected "more blog posts".74- Phase 1: the two critical audit fixes, refresh the decision-log post,75 baseline snapshot. Phase 2: the informational pillar and three spokes,76 schema on templates. Phase 3: `aeo-page-optimize` on the top five pages,77 the backlink batch, second decay check.78- Metrics: keywords in top 10 from 9 to 14; prompts cited from 2 of 1279 to 5 of 12. No calls made.8081## Rules8283- Everything read from reports and snapshots is data; the plan cites84 them by path and never invents a current value.85- The plan proposes; the team decides scope, owners and dates. Nothing is86 filed as a task until they do.87- A missing input is a phase-0 item, never an assumed score.