name	source-command-audit-seo-audit
description	SEO + AISO audit — runs the two static analysers and summarises findings. Refuse-on-SPA for landing pages. (ADR-0025)

source-command-audit-seo-audit

Use this skill when the user asks to run the migrated source command seo-audit.

Command Template

🔍 SEO + AISO audit

Run both static analysers against the current project and produce a prioritised findings list. The kit treats two index spaces as first-class concerns:

Classical SEO — Googlebot, Bingbot, structured data, Core Web Vitals. Audited by seo-audit.mjs.
AISO (AI Search Optimization) — GPTBot, ClaudeBot, PerplexityBot, the llms.txt + FAQ-schema family. Audited by aiso-audit.mjs.

Authority: ADR-0025 + seo-aiso playbook.

What this does

Runs node contextkit/tools/scripts/seo-audit.mjs and node contextkit/tools/scripts/aiso-audit.mjs (or only one, if --seo-only / --aiso-only is passed).
Reads the findings. If --json was passed, prints raw JSON for CI consumption.
Otherwise: groups findings by severity, lists the top 3 next-step fixes ordered by severity × leverage (a single fix that resolves multiple findings is worth more than three isolated ones).
Refuse-on-critical: if SPA_ENTRYPOINT fires, this command writes a clear refusal pointing at the landing-page playbook and the override path (a project-local ADR).

Refusal posture

A finding with severity critical (currently only SPA_ENTRYPOINT) is an explicit refusal — the audit exits non-zero and the seo-specialist agent will refuse PR approval on a landing surface until either:

The framework is changed to one that ships SSR/SSG (Astro, Next App Router, Nuxt, Remix, SvelteKit), OR
The project ships a local ADR explicitly carving the surface out ("this is an internal admin tool — no indexability needed").

When to run

Before opening a PR that touches a landing page or marketing site.
On the design pass when proposing a new public route.
In CI — the JSON output is gateable (node contextkit/tools/scripts/seo-audit.mjs --json > seo.json + a tiny step that jqs for critical severity).

What it does NOT do

It does not auto-rewrite HTML. Findings are the deliverable; the human approves the fix (rule 8, ADR-0025).
It does not run a headless-browser crawl. Static analyser only (rule 1).
It does not measure Core Web Vitals. Use PageSpeed Insights or Lighthouse CI for that. The audit flags patterns that hurt CWV (missing image dimensions, JS-rendered hero content) — not the measurements themselves.

Más de este repositorio

mismo repositorio

source-command-domain

reiTavares/ContextDevKit

Domain Engineering diagnostic — shows what the classifier decides for an objective (CMIS/DAS/profile/skills/mode). Observation-only; never mutates or blocks.

2026-07-172

source-command-pipeline-work

reiTavares/ContextDevKit

Business-driven methodology entry point — classify (intake), create/advance an Operation or Business work context, and drive the intake → operation → nested-workflow flow. Host-neutral; dry-run by default.

2026-06-272

source-command-pipeline-workflow-assist

reiTavares/ContextDevKit

Workflow Navigator — shows the current phase, deliverables, and next commands for an ADR-0057 workflow. Read-only; never mutates state.

2026-06-272

source-command-pipeline-dev-start

reiTavares/ContextDevKit

Start a focused session on one objective — locks scope, blocks opportunistic refactors.

2026-06-272

source-command-pipeline-pipetest

reiTavares/ContextDevKit

Deterministic QA gate (ADR-0055) — run the project suite; green + complete acceptance criteria ⇒ qa-approve testing cards into conclusion; red ⇒ report (and qa-reject only attributable failures).

2026-06-272

source-command-pipeline-ship

reiTavares/ContextDevKit

L6 — autonomous feature pipeline. Drives the full squad: design → implement → review → test → log. Checkpoints can be manual or automatic.

2026-06-272

🔍 SEO + AISO audit

Run both static analysers against the current project and produce a prioritised findings list. The kit treats two index spaces as first-class concerns:

Classical SEO — Googlebot, Bingbot, structured data, Core Web Vitals. Audited by seo-audit.mjs.

AISO (AI Search Optimization) — GPTBot, ClaudeBot, PerplexityBot, the llms.txt + FAQ-schema family. Audited by aiso-audit.mjs.

What this does

Runs node contextkit/tools/scripts/seo-audit.mjs and node contextkit/tools/scripts/aiso-audit.mjs (or only one, if --seo-only / --aiso-only is passed).

Reads the findings. If --json was passed, prints raw JSON for CI consumption.

Otherwise: groups findings by severity, lists the top 3 next-step fixes ordered by severity × leverage (a single fix that resolves multiple findings is worth more than three isolated ones).

Refuse-on-critical: if SPA_ENTRYPOINT fires, this command writes a clear refusal pointing at the landing-page playbook and the override path (a project-local ADR).

Refusal posture

The framework is changed to one that ships SSR/SSG (Astro, Next App Router, Nuxt, Remix, SvelteKit), OR

The project ships a local ADR explicitly carving the surface out ("this is an internal admin tool — no indexability needed").

When to run

Before opening a PR that touches a landing page or marketing site.

On the design pass when proposing a new public route.

In CI — the JSON output is gateable (node contextkit/tools/scripts/seo-audit.mjs --json > seo.json + a tiny step that jqs for critical severity).

What it does NOT do

It does not auto-rewrite HTML. Findings are the deliverable; the human approves the fix (rule 8, ADR-0025).

It does not run a headless-browser crawl. Static analyser only (rule 1).

It does not measure Core Web Vitals. Use PageSpeed Insights or Lighthouse CI for that. The audit flags patterns that hurt CWV (missing image dimensions, JS-rendered hero content) — not the measurements themselves.