agileflow 3.3.0 → 3.4.0

package/src/core/commands/seo/audit.md

@@ -0,0 +1,373 @@
+---
+description: Full website SEO audit with 6 parallel analyzers, business type detection, weighted health score 0-100, and prioritized action plan
+argument-hint: "URL [DEPTH=quick|deep] [MAX_PAGES=50]"
+compact_context:
+  priority: high
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:seo:audit - Full website SEO audit"
+    - "CRITICAL: Deploy 6 analyzers IN PARALLEL in ONE message with multiple Task calls"
+    - "CRITICAL: Wait for all results before running consensus (use TaskOutput with block=true)"
+    - "CRITICAL: Weighted scoring - Technical 20%, Content 20%, Schema 15%, Performance 15%, Images 15%, Sitemap 15%"
+    - "MUST parse arguments: URL (required), DEPTH (quick/deep), MAX_PAGES (default 50)"
+    - "Fetch homepage FIRST to detect business type before deploying analyzers"
+    - "Pass all analyzer outputs to seo-consensus for final report"
+  state_fields:
+    - target_url
+    - depth
+    - max_pages
+    - business_type
+    - analyzers_deployed
+    - health_score
+---
+
+# /agileflow:seo:audit
+
+Deploy 6 specialized SEO analyzers in parallel to audit a website, then synthesize results through consensus into a weighted health score (0-100) with prioritized action plan.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:seo:audit https://example.com                     # Quick audit (all 6 analyzers)
+/agileflow:seo:audit https://example.com DEPTH=deep           # Deep audit (more thorough per-analyzer)
+/agileflow:seo:audit https://example.com MAX_PAGES=100        # Audit up to 100 pages
+```
+
+---
+
+## How It Works
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                    /agileflow:seo:audit                       │
+│                                                               │
+│  1. Parse arguments (URL, depth, max_pages)                   │
+│  2. Fetch homepage → detect business type                     │
+│  3. Fetch robots.txt + sitemap.xml                            │
+│  4. Deploy 6 analyzers IN PARALLEL                            │
+│  5. Collect all results                                       │
+│  6. Run consensus → weighted health score                     │
+│  7. Generate SEO Audit Report + action plan                   │
+└──────────────────────────────────────────────────────────────┘
+
+   ┌──────────┐ ┌─────────┐ ┌────────┐
+   │Technical │ │ Content │ │ Schema │
+   └────┬─────┘ └────┬────┘ └───┬────┘
+        │            │          │
+   ┌────┴──────┐ ┌───┴────┐ ┌──┴──────┐
+   │Performance│ │ Images │ │ Sitemap │
+   └────┬──────┘ └───┬────┘ └──┬──────┘
+        │            │          │
+        └────────────┼──────────┘
+                     ▼
+          ┌─────────────────────┐
+          │  SEO Consensus      │
+          │  (weighted scoring, │
+          │   health score,     │
+          │   action plan)      │
+          └─────────────────────┘
+```
+
+---
+
+## Arguments
+
+| Argument | Values | Default | Description |
+|----------|--------|---------|-------------|
+| URL | Any valid URL | Required | Homepage URL to audit |
+| DEPTH | quick, deep | quick | quick = standard analysis, deep = comprehensive |
+| MAX_PAGES | 1-500 | 50 | Maximum pages to analyze |
+
+---
+
+## Step-by-Step Process
+
+### STEP 1: Parse Arguments
+
+```
+URL = first argument (required - ask if missing)
+DEPTH = quick (default) or deep
+MAX_PAGES = 50 (default)
+```
+
+If URL is missing, ask:
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Which website would you like to audit?",
+  "header": "Target URL",
+  "multiSelect": false,
+  "options": [
+    {"label": "Enter URL", "description": "e.g., https://example.com"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+### STEP 2: Detect Business Type
+
+Fetch the homepage with WebFetch and classify the business:
+
+| Type | Indicators |
+|------|-----------|
+| **SaaS** | Login/signup, pricing page, docs, API references, "free trial" |
+| **Local Business** | Address, phone, map, service areas, hours, "near me" |
+| **E-commerce** | Products, cart, checkout, categories, prices, reviews |
+| **Publisher** | Articles, blog, news, editorial, bylines, publication dates |
+| **Agency** | Portfolio, services list, team page, case studies, "hire us" |
+
+Also fetch:
+- `{URL}/robots.txt` - crawl rules, sitemap location
+- `{URL}/sitemap.xml` - page inventory
+
+### STEP 3: Deploy 6 Analyzers in Parallel
+
+**CRITICAL**: Deploy ALL 6 analyzers in a SINGLE message with multiple Task calls.
+
+```xml
+<invoke name="Task">
+<parameter name="description">Technical SEO analysis</parameter>
+<parameter name="prompt">TASK: Analyze technical SEO for this website.
+
+TARGET URL: {url}
+DEPTH: {quick|deep}
+BUSINESS TYPE: {detected type}
+
+Analyze: crawlability, indexability, security headers, URL structure, mobile-friendliness, and CWV indicators.
+
+Also check robots.txt and basic crawl rules.
+
+OUTPUT your findings in standard format with Technical SEO Score X/100.</parameter>
+<parameter name="subagent_type">seo-analyzer-technical</parameter>
+<parameter name="run_in_background">true</parameter>
+</invoke>
+
+<invoke name="Task">
+<parameter name="description">Content quality E-E-A-T analysis</parameter>
+<parameter name="prompt">TASK: Analyze content quality and E-E-A-T signals.
+
+TARGET URL: {url}
+DEPTH: {quick|deep}
+BUSINESS TYPE: {detected type}
+
+Assess: Trustworthiness (30%), Expertise (25%), Authoritativeness (25%), Experience (20%), plus content depth, readability, and AI citation readiness.
+
+OUTPUT your findings with Content Quality Score X/100.</parameter>
+<parameter name="subagent_type">seo-analyzer-content</parameter>
+<parameter name="run_in_background">true</parameter>
+</invoke>
+
+<invoke name="Task">
+<parameter name="description">Schema/structured data analysis</parameter>
+<parameter name="prompt">TASK: Analyze schema markup and structured data.
+
+TARGET URL: {url}
+DEPTH: {quick|deep}
+BUSINESS TYPE: {detected type}
+
+Detect: existing JSON-LD/Microdata/RDFa, validate against Google standards, flag deprecated types, identify missing schema opportunities, generate ready-to-use snippets.
+
+OUTPUT your findings with Schema Score X/100.</parameter>
+<parameter name="subagent_type">seo-analyzer-schema</parameter>
+<parameter name="run_in_background">true</parameter>
+</invoke>
+
+<invoke name="Task">
+<parameter name="description">Image optimization analysis</parameter>
+<parameter name="prompt">TASK: Analyze image optimization.
+
+TARGET URL: {url}
+DEPTH: {quick|deep}
+BUSINESS TYPE: {detected type}
+
+Check: alt text quality, image sizing (CLS), modern formats (WebP/AVIF), lazy loading, LCP image priority, responsive images.
+
+OUTPUT your findings with Image Optimization Score X/100.</parameter>
+<parameter name="subagent_type">seo-analyzer-images</parameter>
+<parameter name="run_in_background">true</parameter>
+</invoke>
+
+<invoke name="Task">
+<parameter name="description">Core Web Vitals performance analysis</parameter>
+<parameter name="prompt">TASK: Analyze performance and Core Web Vitals.
+
+TARGET URL: {url}
+DEPTH: {quick|deep}
+BUSINESS TYPE: {detected type}
+
+Assess: LCP optimization, INP indicators, CLS risk factors, resource loading, render-blocking resources, third-party impact.
+
+OUTPUT your findings with Performance Score X/100.</parameter>
+<parameter name="subagent_type">seo-analyzer-performance</parameter>
+<parameter name="run_in_background">true</parameter>
+</invoke>
+
+<invoke name="Task">
+<parameter name="description">Sitemap validation analysis</parameter>
+<parameter name="prompt">TASK: Analyze XML sitemap.
+
+TARGET URL: {url}
+DEPTH: {quick|deep}
+BUSINESS TYPE: {detected type}
+
+Validate: sitemap existence, XML structure, URL coverage, quality gates, robots.txt reference.
+
+OUTPUT your findings with Sitemap Score X/100.</parameter>
+<parameter name="subagent_type">seo-analyzer-sitemap</parameter>
+<parameter name="run_in_background">true</parameter>
+</invoke>
+```
+
+### STEP 4: Collect Results
+
+Wait for all analyzers to complete using TaskOutput with block=true. Collect all 6 outputs.
+
+### STEP 5: Run Consensus Coordinator
+
+Pass all analyzer outputs to the consensus coordinator:
+
+```xml
+<invoke name="Task">
+<parameter name="description">SEO audit consensus and scoring</parameter>
+<parameter name="prompt">You are the SEO Consensus Coordinator.
+
+TARGET URL: {url}
+BUSINESS TYPE: {detected type}
+DEPTH: {depth}
+
+## Analyzer Outputs
+
+### Technical SEO Results:
+{technical_output}
+
+### Content Quality Results:
+{content_output}
+
+### Schema Results:
+{schema_output}
+
+### Image Optimization Results:
+{images_output}
+
+### Performance Results:
+{performance_output}
+
+### Sitemap Results:
+{sitemap_output}
+
+---
+
+Follow your consensus process:
+1. Confirm business type classification
+2. Parse all findings into normalized structure
+3. Calculate category scores (each out of 100)
+4. Apply weights: Technical 20%, Content 20%, Schema 15%, Performance 15%, Images 15%, Sitemap 15%
+5. Compute overall Health Score 0-100
+6. Cross-reference findings flagged by multiple analyzers
+7. Prioritize: Critical → High → Medium → Low
+8. Generate action plan with quick wins
+9. Save report to docs/08-project/seo-audits/seo-audit-{YYYYMMDD}.md</parameter>
+<parameter name="subagent_type">seo-consensus</parameter>
+</invoke>
+```
+
+### STEP 6: Present Results
+
+After consensus completes, show summary and offer next steps:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "SEO Audit complete: Health Score {X}/100 ({rating}). Business type: {type}. {N} findings ({critical} critical, {high} high).",
+  "header": "Next steps",
+  "multiSelect": false,
+  "options": [
+    {"label": "Fix {critical} Critical issues now (Recommended)", "description": "{top_issue_summary}"},
+    {"label": "Deep-dive into {lowest_category}", "description": "Lowest score: {category} at {score}/100"},
+    {"label": "Generate schema markup for this site", "description": "Run /agileflow:seo:schema to get ready-to-use JSON-LD"},
+    {"label": "Create SEO improvement plan", "description": "Run /agileflow:seo:plan for strategic roadmap"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+## Example Output
+
+```
+SEO Audit: https://example.com
+══════════════════════════════════════════════════════════════
+
+Business Type: SaaS
+Depth: quick
+
+Deploying 6 SEO analyzers...
+✓ Technical SEO Analyzer
+✓ Content Quality Analyzer
+✓ Schema Analyzer
+✓ Image Optimization Analyzer
+✓ Performance Analyzer
+✓ Sitemap Analyzer
+
+Running consensus...
+✓ Consensus complete
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+HEALTH SCORE: 72/100 (Good)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+| Category         | Score  | Weight | Weighted |
+|-----------------|--------|--------|----------|
+| Technical SEO   | 85/100 | 20%    | 17.0     |
+| Content Quality | 68/100 | 20%    | 13.6     |
+| Schema          | 45/100 | 15%    |  6.8     |
+| Performance     | 78/100 | 15%    | 11.7     |
+| Images          | 82/100 | 15%    | 12.3     |
+| Sitemap         | 75/100 | 15%    | 11.3     |
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+CRITICAL: 1 | HIGH: 3 | MEDIUM: 5 | LOW: 2
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[Full report saved to docs/08-project/seo-audits/seo-audit-20260225.md]
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:seo:audit` - Full website SEO audit with 6 parallel analyzers
+
+**Quick Usage**:
+```
+/agileflow:seo:audit https://example.com                # Quick audit
+/agileflow:seo:audit https://example.com DEPTH=deep      # Deep audit
+```
+
+**What It Does**: Fetch homepage → Detect business type → Deploy 6 analyzers in parallel → Consensus weights scores → Health Score 0-100 → Prioritized action plan
+
+**Analyzers (all 6 deploy in parallel)**:
+- `seo-analyzer-technical` - Crawlability, indexability, security, URLs, mobile
+- `seo-analyzer-content` - E-E-A-T scoring, readability, AI citation readiness
+- `seo-analyzer-schema` - JSON-LD detection, validation, deprecated types
+- `seo-analyzer-images` - Alt text, sizing, formats, lazy loading
+- `seo-analyzer-performance` - LCP, INP, CLS, resource loading
+- `seo-analyzer-sitemap` - XML validation, coverage, quality gates
+
+**Category Weights**: Technical 20%, Content 20%, Schema 15%, Performance 15%, Images 15%, Sitemap 15%
+
+**Output**: `docs/08-project/seo-audits/seo-audit-{YYYYMMDD}.md`
+<!-- COMPACT_SUMMARY_END -->
+
+---
+
+## Related Commands
+
+- `/agileflow:seo:page` - Deep-dive into a single page
+- `/agileflow:seo:schema` - Generate schema markup
+- `/agileflow:seo:geo` - AI search optimization
+- `/agileflow:seo:plan` - Strategic SEO planning
+- `/agileflow:seo:technical` - Technical SEO deep-dive

package/src/core/commands/seo/competitor.md

@@ -0,0 +1,174 @@
+---
+description: SEO competitor comparison - analyze competing pages, generate feature matrices, and create comparison content with schema markup
+argument-hint: "YOUR_URL COMPETITOR_URL [COMPETITOR_URL_2]"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:seo:competitor - Competitor SEO comparison"
+    - "Fetch both your page and competitor page(s)"
+    - "Generate feature comparison matrix"
+    - "Produce comparison page content with Product schema"
+  state_fields:
+    - your_url
+    - competitor_urls
+    - comparison_matrix
+---
+
+# /agileflow:seo:competitor
+
+Analyze competitor pages and generate SEO-optimized comparison content with feature matrices and structured data.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:seo:competitor https://you.com https://competitor.com          # 1v1 comparison
+/agileflow:seo:competitor https://you.com https://comp1.com https://comp2.com  # Multi-competitor
+```
+
+---
+
+## Arguments
+
+| Argument | Values | Default | Description |
+|----------|--------|---------|-------------|
+| YOUR_URL | Any valid URL | Required | Your product/service page |
+| COMPETITOR_URL | Any valid URL(s) | Required | Competitor page(s) to compare (1-3) |
+
+---
+
+## Process
+
+### STEP 1: Fetch All Pages
+
+Use WebFetch to retrieve your page and each competitor page. Extract:
+- Product/service name
+- Features list
+- Pricing (if visible)
+- Key differentiators
+- Schema markup present
+- Meta title/description
+
+### STEP 2: Build Feature Matrix
+
+Create a comparison matrix:
+
+```markdown
+| Feature | Your Product | Competitor A | Competitor B |
+|---------|-------------|-------------|-------------|
+| {feature 1} | Yes/No/Value | Yes/No/Value | Yes/No/Value |
+| {feature 2} | Yes/No/Value | Yes/No/Value | Yes/No/Value |
+| Pricing | {price} | {price} | {price} |
+| Free Trial | Yes/No | Yes/No | Yes/No |
+```
+
+### STEP 3: SEO Comparison
+
+Compare SEO elements:
+
+| Element | You | Competitor |
+|---------|-----|-----------|
+| Title tag | {length, keywords} | {length, keywords} |
+| Meta description | {present, quality} | {present, quality} |
+| H1 | {text} | {text} |
+| Schema types | {types} | {types} |
+| Word count | {count} | {count} |
+| Internal links | {count} | {count} |
+| Image optimization | {score} | {score} |
+
+### STEP 4: Generate Comparison Content
+
+Produce draft comparison page content:
+
+```markdown
+# {Your Product} vs {Competitor}: {Year} Comparison
+
+## Quick Summary
+
+{2-3 sentence overview}
+
+## Feature Comparison
+
+[Feature matrix table]
+
+## {Your Product} Advantages
+
+1. {advantage with evidence}
+2. {advantage}
+
+## When to Choose {Competitor}
+
+{Fair, balanced assessment}
+
+## Pricing Comparison
+
+[Pricing table]
+
+## Verdict
+
+{Balanced recommendation}
+```
+
+### STEP 5: Generate Schema
+
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "WebPage",
+  "name": "{Your Product} vs {Competitor}",
+  "description": "Compare {Your Product} and {Competitor} features, pricing, and capabilities",
+  "mainEntity": {
+    "@type": "ItemList",
+    "itemListElement": [
+      {
+        "@type": "Product",
+        "name": "{Your Product}",
+        "url": "{your_url}"
+      },
+      {
+        "@type": "Product",
+        "name": "{Competitor}",
+        "url": "{competitor_url}"
+      }
+    ]
+  }
+}
+```
+
+### STEP 6: Output
+
+```markdown
+# Competitor Analysis: {You} vs {Competitor(s)}
+
+## SEO Comparison
+[Side-by-side SEO element comparison]
+
+## Feature Matrix
+[Feature comparison table]
+
+## Content Gaps
+[What competitor has that you're missing]
+
+## Generated Comparison Page
+[Draft content ready to publish]
+
+## Schema Markup
+[JSON-LD for the comparison page]
+
+## SEO Recommendations
+1. {Priority improvement}
+2. {Next priority}
+```
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:seo:competitor` - Competitor SEO comparison
+
+**Output**: Feature matrix, SEO comparison, draft comparison page content, schema markup
+
+**Usage**: `/agileflow:seo:competitor YOUR_URL COMPETITOR_URL [COMPETITOR_URL_2]`
+<!-- COMPACT_SUMMARY_END -->

package/src/core/commands/seo/content.md

@@ -0,0 +1,107 @@
+---
+description: E-E-A-T content quality analysis - trustworthiness, expertise, authoritativeness, experience scoring with AI content detection
+argument-hint: "URL [TYPE=homepage|service|blog|product|location]"
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:seo:content - E-E-A-T content quality analysis"
+    - "Deploy seo-analyzer-content for comprehensive E-E-A-T assessment"
+    - "Score: Trust 30%, Expertise 25%, Authoritativeness 25%, Experience 20%"
+    - "Check content minimums by page type (from quality-gates.md)"
+  state_fields:
+    - target_url
+    - page_type
+    - eeat_score
+---
+
+# /agileflow:seo:content
+
+Analyze content quality using the E-E-A-T framework (Experience, Expertise, Authoritativeness, Trustworthiness). Includes AI content detection and citation readiness assessment.
+
+---
+
+## Quick Reference
+
+```
+/agileflow:seo:content https://example.com                    # Homepage content analysis
+/agileflow:seo:content https://example.com/blog/post TYPE=blog # Blog post analysis
+/agileflow:seo:content https://example.com/services TYPE=service # Service page analysis
+```
+
+---
+
+## Arguments
+
+| Argument | Values | Default | Description |
+|----------|--------|---------|-------------|
+| URL | Any valid URL | Required | Page to analyze |
+| TYPE | homepage, service, blog, product, location | Auto-detect | Page type (affects content minimums) |
+
+---
+
+## Process
+
+### STEP 1: Deploy Content Analyzer
+
+```xml
+<invoke name="Task">
+<parameter name="description">E-E-A-T content quality analysis</parameter>
+<parameter name="prompt">TASK: Perform deep E-E-A-T content quality analysis.
+
+TARGET URL: {url}
+PAGE TYPE: {type or "auto-detect"}
+
+Score each E-E-A-T factor:
+- Trustworthiness (30%): HTTPS, contact, privacy, transparency, no deception
+- Expertise (25%): Author credentials, citations, accuracy, depth
+- Authoritativeness (25%): Brand signals, testimonials, certifications, NAP
+- Experience (20%): First-hand accounts, original media, specific data, case studies
+
+Also assess:
+- Content depth vs minimums (homepage 500w, service 800w, blog 1500w, product 300w)
+- Content uniqueness (boilerplate vs original)
+- Readability level
+- AI content red flags (generic phrasing, no insights, fabricated experience)
+- AI citation readiness (self-contained blocks, specific facts, question headers)
+
+OUTPUT: Content Quality Score X/100 with E-E-A-T breakdown.</parameter>
+<parameter name="subagent_type">seo-analyzer-content</parameter>
+</invoke>
+```
+
+### STEP 2: Present Results
+
+Show E-E-A-T breakdown with signal-level detail and remediation steps.
+
+---
+
+## E-E-A-T Scoring
+
+| Factor | Weight | Key Signals |
+|--------|--------|-------------|
+| Trustworthiness | 30% | HTTPS, contact info, privacy policy, editorial transparency |
+| Expertise | 25% | Author bylines, cited sources, technical depth |
+| Authoritativeness | 25% | Brand identity, certifications, media mentions |
+| Experience | 20% | First-person accounts, original photos, specific data |
+
+## Content Minimums (from quality-gates.md)
+
+| Page Type | Min Words | Unique % |
+|-----------|-----------|----------|
+| Homepage | 500 | 100% |
+| Service | 800 | 60% |
+| Blog | 1,500 | 100% |
+| Product | 300 | 40% |
+| Location | 500 | 40% |
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+## Compact Summary
+
+**Command**: `/agileflow:seo:content` - E-E-A-T content quality analysis
+
+**Scoring**: Trust 30%, Expertise 25%, Authority 25%, Experience 20%
+
+**Usage**: `/agileflow:seo:content URL [TYPE=page_type]`
+<!-- COMPACT_SUMMARY_END -->