description: "Phase 2 (Technical): Focus diagnostic scan for code-level health — crawl site, validate redirect, sitemap, schema, robots, images, canonicals, and Core Web Vitals" version: "1.2"

/seo-technical <domain|url> [--scope homepage|priority|full] [--compare]

Purpose

Focused technical SEO audit. Activates technical sub-agents to check crawlability, indexability, sitemap health, schema markup, image optimization, international hreflang tags, redirects, security headers, and page speed. Produces a Technical Health Score (0-100) and code-centric action plan.

📎 Reference: Weight tables and output formats are adapted dynamically from seo-audit-ref.md, ignoring content-specific categories.

Scope Control

• If no --scope specified → auto-select:
  • If settings.priority_pages exists in project.json → use priority
  • If no priority pages → use homepage

Skills Activated (up to 8)

Prerequisites

• Recommended: Run /seo-onboard first for project folder initialization.
• Required: Domain must be live and reachable.
• Not compatible: phase == "greenfield" — domain must be published first.

Checkpointing

After each step completes, update project.json.workflow_checkpoint with {workflow: "seo-technical", step: N, timestamp: "..."}.

Sub-Agent Coordination

This workflow delegates to technical specialists under the coordination of @[tech-seo-director]:

• Primary Executor: @[tech-seo-director] (leads crawling, redirect validation, and score compilation)
• Sub-Agents: @[schema-engineer] (validates schema markup), @[algo-forecaster] (analyzes AI bots rules).

Steps

1. Init/load domain project (Primary Agent: @[tech-seo-director]) — Follow .agents/rules/seo-domain-project.md:

   • PROJECT_DIR = .seo/ (Workspace-scoped)
   • Load or initialize .seo/project.json
   • If phase == "greenfield" → check reachability → if live, update phase to "onboarded" and proceed; if not → STOP

2. Load project context (Primary Agent: @[tech-seo-director]) — priority_pages, primary_goal, industry

3. Determine audit scope (Primary Agent: @[tech-seo-director]) — select scope per rules above.

4. Run Parallel Technical Audit (Primary Agent: @[tech-seo-director] | Sub-Agents: @[schema-engineer], @[algo-forecaster]) — Run the parallel orchestrator with --tech-only:

   python .agents/scripts/run_plugin_script.py seo-core parallel_audit_runner.py <url> \
     --project-dir .seo/ \
     --scope <scope> \
     --max-workers 4 \
     --goal <primary_goal> \
     --industry <industry> \
     --tech-only \
     [--compare <previous_technical_json>]
   

5. Final verification (Primary Agent: @[tech-seo-director]) (.agents/rules/seo-core.md):

   • All findings tagged [FETCHED]
   • Score breakdown lists checked vs skipped
   • If CWV skipped → add: ⚠️ Performance/CWV score unavailable

6. Save outputs (Primary Agent: @[tech-seo-director]):

   • .seo/reports/technical-{date}.md
   • .seo/data/technical-{date}.json

7. Update project.json (Primary Agent: @[tech-seo-director]) — append to runs[] with "type": "technical" and category_scores (ignoring "content").

8. Suggest next step:

   • Technical Score ≥ 80: "Run /seo-audit or /seo-strategy to focus on Content & Market Authority"
   • Technical Score < 80: "⚠️ Consider /seo-execute to patch robots.txt, schema, or redirect chains"