@hanzlaa/rcode 4.3.2 → 4.4.0

package/rcode/skills/seo/technical-seo-checker/references/technical-audit-example.md

@@ -0,0 +1,169 @@
+# Technical SEO Checker — Worked Example & Checklist
+
+Referenced from [SKILL.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/SKILL.md).
+
+---
+
+## Worked Example
+
+**User**: "Check the technical SEO of cloudhosting.com"
+
+**Output**:
+
+```markdown
+# Technical SEO Audit Report
+
+**Domain**: cloudhosting.com
+**Audit Date**: 2024-09-15
+**Pages Analyzed**: 312
+
+## Crawlability Analysis
+
+### Robots.txt Review
+
+**URL**: cloudhosting.com/robots.txt
+**Status**: Found
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| File exists | ✅ | 200 response |
+| Valid syntax | ⚠️ | Wildcard pattern `Disallow: /*?` too aggressive — blocks faceted pages |
+| Sitemap declared | ❌ | No Sitemap directive in robots.txt |
+| Important pages blocked | ⚠️ | /pricing/ blocked by `Disallow: /pricing` rule |
+| Assets blocked | ✅ | CSS/JS accessible |
+
+**Issues Found**:
+- Sitemap URL not declared in robots.txt
+- `/pricing/` inadvertently blocked — high-value commercial page
+
+### XML Sitemap Review
+
+**Sitemap URL**: cloudhosting.com/sitemap.xml
+**Status**: Found (not referenced in robots.txt)
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| Sitemap exists | ✅ | Valid XML, 287 URLs |
+| Only indexable URLs | ❌ | 23 noindex URLs included |
+| Includes lastmod | ⚠️ | All dates set to 2023-01-01 — not accurate |
+
+**Crawlability Score**: 5/10
+
+## Performance Analysis
+
+### Core Web Vitals
+
+| Metric | Mobile | Desktop | Target | Status |
+|--------|--------|---------|--------|--------|
+| LCP (Largest Contentful Paint) | 4.8s | 2.1s | <2.5s | ❌ Mobile / ✅ Desktop |
+| FID (First Input Delay) | 45ms | 12ms | <100ms | ✅ / ✅ |
+| CLS (Cumulative Layout Shift) | 0.24 | 0.08 | <0.1 | ❌ Mobile / ✅ Desktop |
+| INP (Interaction to Next Paint) | 380ms | 140ms | <200ms | ❌ Mobile / ✅ Desktop |
+
+### Additional Performance Metrics
+
+| Metric | Value | Status |
+|--------|-------|--------|
+| Time to First Byte (TTFB) | 1,240ms | ❌ |
+| Page Size | 3.8MB | ❌ |
+| Requests | 94 | ⚠️ |
+
+**LCP Issues**:
+- Uncompressed hero image (2.4MB PNG): Convert to WebP, est. save 1.9MB
+- No CDN detected: TTFB 1,240ms from origin server
+
+**CLS Issues**:
+- Ad banner at top of page injects without reserved height (0.18 shift contribution)
+
+**Performance Score**: 3/10
+
+## Security Analysis
+
+### HTTPS Status
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| SSL certificate valid | ✅ | Expires: 2025-03-22 |
+| HTTPS enforced | ⚠️ | http://cloudhosting.com returns 200 instead of 301 redirect |
+| Mixed content | ❌ | 7 images loaded over HTTP on /features/ page |
+| HSTS enabled | ❌ | Header not present |
+
+**Security Score**: 5/10
+
+## Structured Data Analysis
+
+### Schema Markup Found
+
+| Schema Type | Pages | Valid | Errors |
+|-------------|-------|-------|--------|
+| Organization | 1 (homepage) | ✅ | None |
+| Article | 0 | — | Missing on 48 blog posts |
+| Product | 0 | — | Missing on 5 plan pages |
+| FAQ | 0 | — | Missing on 12 pages with FAQ content |
+
+**Structured Data Score**: 3/10
+
+## Overall Technical Health: 42/100
+
+```
+Score Breakdown:
+█████░░░░░ Crawlability: 5/10
+██████░░░░ Indexability: 6/10
+███░░░░░░░ Performance: 3/10
+██████░░░░ Mobile: 6/10
+█████░░░░░ Security: 5/10
+██████░░░░ URL Structure: 6/10
+███░░░░░░░ Structured Data: 3/10
+```
+
+## Priority Issues
+
+### 🔴 Critical (Fix Immediately)
+1. **Mobile LCP 4.8s (target <2.5s)** — Compress hero image to WebP (est. save 1.9MB) and implement a CDN to reduce TTFB from 1,240ms to <400ms.
+
+### 🟡 Important (Fix Soon)
+2. **HTTP not redirecting to HTTPS** — Add 301 redirect from http:// to https:// and enable HSTS header. 7 mixed-content images on /features/ need URL updates.
+
+### 🟢 Minor (Optimize)
+3. **No Article/FAQ schema on blog posts** — Add Article schema to 48 blog posts and FAQ schema to 12 FAQ pages for rich result eligibility.
+```
+
+---
+
+## Technical SEO Checklist
+
+```markdown
+### Crawlability
+- [ ] robots.txt is valid and not blocking important content
+- [ ] XML sitemap exists and is submitted to ~~search console
+- [ ] No crawl errors in ~~search console
+- [ ] No redirect chains or loops
+
+### Indexability
+- [ ] Important pages are indexable
+- [ ] Canonical tags are correct
+- [ ] No duplicate content issues
+- [ ] Pagination is handled correctly
+
+### Performance
+- [ ] Core Web Vitals pass
+- [ ] Page speed under 3 seconds
+- [ ] Images are optimized
+- [ ] JS/CSS are minified
+
+### Mobile
+- [ ] Mobile-friendly test passes
+- [ ] Viewport is configured
+- [ ] Touch elements are properly sized
+
+### Security
+- [ ] HTTPS is enforced
+- [ ] SSL certificate is valid
+- [ ] No mixed content
+- [ ] Security headers present
+
+### Structure
+- [ ] URLs are clean and descriptive
+- [ ] Site architecture is logical
+- [ ] Internal linking is strong
+```

package/rcode/skills/seo/technical-seo-checker/references/technical-audit-templates.md

@@ -0,0 +1,436 @@
+# Technical SEO Checker — Output Templates
+
+Detailed output templates for technical-seo-checker steps 1-9. Referenced from [SKILL.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/SKILL.md).
+
+---
+
+## Step 1: Audit Crawlability
+
+```markdown
+## Crawlability Analysis
+
+### Robots.txt Review
+
+**URL**: [domain]/robots.txt
+**Status**: [Found/Not Found/Error]
+
+**Current Content**:
+```
+[robots.txt content]
+```
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| File exists | ✅/❌ | [notes] |
+| Valid syntax | ✅/⚠️/❌ | [errors found] |
+| Sitemap declared | ✅/❌ | [sitemap URL] |
+| Important pages blocked | ✅/⚠️/❌ | [blocked paths] |
+| Assets blocked | ✅/⚠️/❌ | [CSS/JS blocked?] |
+| Correct user-agents | ✅/⚠️/❌ | [notes] |
+
+**Issues Found**:
+- [Issue 1]
+- [Issue 2]
+
+**Recommended robots.txt**:
+```
+User-agent: *
+Allow: /
+Disallow: /admin/
+Disallow: /private/
+
+Sitemap: https://example.com/sitemap.xml
+```
+
+---
+
+### XML Sitemap Review
+
+**Sitemap URL**: [URL]
+**Status**: [Found/Not Found/Error]
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| Sitemap exists | ✅/❌ | [notes] |
+| Valid XML format | ✅/⚠️/❌ | [errors] |
+| In robots.txt | ✅/❌ | [notes] |
+| Submitted to ~~search console | ✅/⚠️/❌ | [notes] |
+| URLs count | [X] | [appropriate?] |
+| Only indexable URLs | ✅/⚠️/❌ | [notes] |
+| Includes priority | ✅/⚠️ | [notes] |
+| Includes lastmod | ✅/⚠️ | [accurate?] |
+
+**Issues Found**:
+- [Issue 1]
+
+---
+
+### Crawl Budget Analysis
+
+| Factor | Status | Impact |
+|--------|--------|--------|
+| Crawl errors | [X] errors | [Low/Med/High] |
+| Duplicate content | [X] pages | [Low/Med/High] |
+| Thin content | [X] pages | [Low/Med/High] |
+| Redirect chains | [X] found | [Low/Med/High] |
+| Orphan pages | [X] found | [Low/Med/High] |
+
+**Crawlability Score**: [X]/10
+```
+
+---
+
+## Step 2: Audit Indexability
+
+```markdown
+## Indexability Analysis
+
+### Index Status Overview
+
+| Metric | Count | Notes |
+|--------|-------|-------|
+| Pages in sitemap | [X] | |
+| Pages indexed | [X] | [source: site: search] |
+| Index coverage ratio | [X]% | [good if >90%] |
+
+### Index Blockers Check
+
+| Blocker Type | Found | Pages Affected |
+|--------------|-------|----------------|
+| noindex meta tag | [X] | [list or "none"] |
+| noindex X-Robots | [X] | [list or "none"] |
+| Robots.txt blocked | [X] | [list or "none"] |
+| Canonical to other | [X] | [list or "none"] |
+| 4xx/5xx errors | [X] | [list or "none"] |
+| Redirect loops | [X] | [list or "none"] |
+
+### Canonical Tags Audit
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| Canonicals present | ✅/⚠️/❌ | [X]% of pages |
+| Self-referencing | ✅/⚠️/❌ | [notes] |
+| Consistent (HTTP/HTTPS) | ✅/⚠️/❌ | [notes] |
+| Consistent (www/non-www) | ✅/⚠️/❌ | [notes] |
+| No conflicting signals | ✅/⚠️/❌ | [notes] |
+
+### Duplicate Content Issues
+
+| Issue Type | Count | Examples |
+|------------|-------|----------|
+| Exact duplicates | [X] | [URLs] |
+| Near duplicates | [X] | [URLs] |
+| Parameter duplicates | [X] | [URLs] |
+| WWW/non-WWW | [X] | [notes] |
+| HTTP/HTTPS | [X] | [notes] |
+
+**Indexability Score**: [X]/10
+```
+
+---
+
+## Step 3: Audit Site Speed & Core Web Vitals
+
+```markdown
+## Performance Analysis
+
+### Core Web Vitals
+
+| Metric | Mobile | Desktop | Target | Status |
+|--------|--------|---------|--------|--------|
+| LCP (Largest Contentful Paint) | [X]s | [X]s | <2.5s | ✅/⚠️/❌ |
+| FID (First Input Delay) | [X]ms | [X]ms | <100ms | ✅/⚠️/❌ |
+| CLS (Cumulative Layout Shift) | [X] | [X] | <0.1 | ✅/⚠️/❌ |
+| INP (Interaction to Next Paint) | [X]ms | [X]ms | <200ms | ✅/⚠️/❌ |
+
+### Additional Performance Metrics
+
+| Metric | Value | Status |
+|--------|-------|--------|
+| Time to First Byte (TTFB) | [X]ms | ✅/⚠️/❌ |
+| First Contentful Paint (FCP) | [X]s | ✅/⚠️/❌ |
+| Speed Index | [X] | ✅/⚠️/❌ |
+| Total Blocking Time | [X]ms | ✅/⚠️/❌ |
+| Page Size | [X]MB | ✅/⚠️/❌ |
+| Requests | [X] | ✅/⚠️/❌ |
+
+### Performance Issues
+
+**LCP Issues**:
+- [Issue]: [Impact] - [Solution]
+- [Issue]: [Impact] - [Solution]
+
+**CLS Issues**:
+- [Issue]: [Impact] - [Solution]
+
+**Resource Loading**:
+| Resource Type | Count | Size | Issues |
+|---------------|-------|------|--------|
+| Images | [X] | [X]MB | [notes] |
+| JavaScript | [X] | [X]MB | [notes] |
+| CSS | [X] | [X]KB | [notes] |
+| Fonts | [X] | [X]KB | [notes] |
+
+### Optimization Recommendations
+
+**High Impact**:
+1. [Recommendation] - Est. improvement: [X]s
+2. [Recommendation] - Est. improvement: [X]s
+
+**Medium Impact**:
+1. [Recommendation]
+2. [Recommendation]
+
+**Performance Score**: [X]/10
+```
+
+---
+
+## Step 4: Audit Mobile-Friendliness
+
+```markdown
+## Mobile Optimization Analysis
+
+### Mobile-Friendly Test
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| Mobile-friendly overall | ✅/❌ | [notes] |
+| Viewport configured | ✅/❌ | [viewport tag] |
+| Text readable | ✅/⚠️/❌ | Font size: [X]px |
+| Tap targets sized | ✅/⚠️/❌ | [notes] |
+| Content fits viewport | ✅/❌ | [notes] |
+| No horizontal scroll | ✅/❌ | [notes] |
+
+### Responsive Design Check
+
+| Element | Desktop | Mobile | Issues |
+|---------|---------|--------|--------|
+| Navigation | [status] | [status] | [notes] |
+| Images | [status] | [status] | [notes] |
+| Forms | [status] | [status] | [notes] |
+| Tables | [status] | [status] | [notes] |
+| Videos | [status] | [status] | [notes] |
+
+### Mobile-First Indexing
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| Mobile version has all content | ✅/⚠️/❌ | [notes] |
+| Mobile has same structured data | ✅/⚠️/❌ | [notes] |
+| Mobile has same meta tags | ✅/⚠️/❌ | [notes] |
+| Mobile images have alt text | ✅/⚠️/❌ | [notes] |
+
+**Mobile Score**: [X]/10
+```
+
+---
+
+## Step 5: Audit Security & HTTPS
+
+```markdown
+## Security Analysis
+
+### HTTPS Status
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| SSL certificate valid | ✅/❌ | Expires: [date] |
+| HTTPS enforced | ✅/❌ | [redirects properly?] |
+| Mixed content | ✅/⚠️/❌ | [X] issues |
+| HSTS enabled | ✅/⚠️ | [notes] |
+| Certificate chain | ✅/⚠️/❌ | [notes] |
+
+### Security Headers
+
+| Header | Present | Value | Recommended |
+|--------|---------|-------|-------------|
+| Content-Security-Policy | ✅/❌ | [value] | [recommendation] |
+| X-Frame-Options | ✅/❌ | [value] | DENY or SAMEORIGIN |
+| X-Content-Type-Options | ✅/❌ | [value] | nosniff |
+| X-XSS-Protection | ✅/❌ | [value] | 1; mode=block |
+| Referrer-Policy | ✅/❌ | [value] | [recommendation] |
+
+**Security Score**: [X]/10
+```
+
+---
+
+## Step 6: Audit URL Structure
+
+```markdown
+## URL Structure Analysis
+
+### URL Pattern Review
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| HTTPS URLs | ✅/⚠️/❌ | [X]% HTTPS |
+| Lowercase URLs | ✅/⚠️/❌ | [notes] |
+| No special characters | ✅/⚠️/❌ | [notes] |
+| Readable/descriptive | ✅/⚠️/❌ | [notes] |
+| Appropriate length | ✅/⚠️/❌ | Avg: [X] chars |
+| Keywords in URLs | ✅/⚠️/❌ | [notes] |
+| Consistent structure | ✅/⚠️/❌ | [notes] |
+
+### URL Issues Found
+
+| Issue Type | Count | Examples |
+|------------|-------|----------|
+| Dynamic parameters | [X] | [URLs] |
+| Session IDs in URLs | [X] | [URLs] |
+| Uppercase characters | [X] | [URLs] |
+| Special characters | [X] | [URLs] |
+| Very long URLs (>100) | [X] | [URLs] |
+
+### Redirect Analysis
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| Redirect chains | [X] found | [max chain length] |
+| Redirect loops | [X] found | [URLs] |
+| 302 → 301 needed | [X] found | [URLs] |
+| Broken redirects | [X] found | [URLs] |
+
+**URL Score**: [X]/10
+```
+
+---
+
+## Step 7: Audit Structured Data
+
+> **CORE-EEAT alignment**: Schema markup quality maps to O05 (Schema Markup) in the CORE-EEAT benchmark. See [content-quality-auditor](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/content-quality-auditor/SKILL.md) for full content quality audit.
+
+```markdown
+## Structured Data Analysis
+
+### Schema Markup Found
+
+| Schema Type | Pages | Valid | Errors |
+|-------------|-------|-------|--------|
+| [Type 1] | [X] | ✅/❌ | [errors] |
+| [Type 2] | [X] | ✅/❌ | [errors] |
+
+### Validation Results
+
+**Errors**:
+- [Error 1]: [affected pages] - [solution]
+- [Error 2]: [affected pages] - [solution]
+
+**Warnings**:
+- [Warning 1]: [notes]
+
+### Missing Schema Opportunities
+
+| Page Type | Current Schema | Recommended |
+|-----------|----------------|-------------|
+| Blog posts | [current] | Article + FAQ |
+| Products | [current] | Product + Review |
+| Homepage | [current] | Organization |
+
+**Structured Data Score**: [X]/10
+```
+
+---
+
+## Step 8: Audit International SEO (if applicable)
+
+```markdown
+## International SEO Analysis
+
+### Hreflang Implementation
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| Hreflang tags present | ✅/❌ | [notes] |
+| Self-referencing | ✅/⚠️/❌ | [notes] |
+| Return tags present | ✅/⚠️/❌ | [notes] |
+| Valid language codes | ✅/⚠️/❌ | [notes] |
+| x-default tag | ✅/⚠️ | [notes] |
+
+### Language/Region Targeting
+
+| Language | URL | Hreflang | Status |
+|----------|-----|----------|--------|
+| [en-US] | [URL] | [tag] | ✅/⚠️/❌ |
+| [es-ES] | [URL] | [tag] | ✅/⚠️/❌ |
+
+**International Score**: [X]/10
+```
+
+---
+
+## Step 9: Generate Technical Audit Summary
+
+```markdown
+# Technical SEO Audit Report
+
+**Domain**: [domain]
+**Audit Date**: [date]
+**Pages Analyzed**: [X]
+
+## Overall Technical Health: [X]/100
+
+```
+Score Breakdown:
+████████░░ Crawlability: 8/10
+███████░░░ Indexability: 7/10
+█████░░░░░ Performance: 5/10
+████████░░ Mobile: 8/10
+█████████░ Security: 9/10
+██████░░░░ URL Structure: 6/10
+█████░░░░░ Structured Data: 5/10
+```
+
+## Critical Issues (Fix Immediately)
+
+1. **[Issue]**: [Impact]
+   - Affected: [pages/scope]
+   - Solution: [specific fix]
+   - Priority: 🔴 Critical
+
+2. **[Issue]**: [Impact]
+   - Affected: [pages/scope]
+   - Solution: [specific fix]
+   - Priority: 🔴 Critical
+
+## High Priority Issues
+
+1. **[Issue]**: [Solution]
+2. **[Issue]**: [Solution]
+
+## Medium Priority Issues
+
+1. **[Issue]**: [Solution]
+2. **[Issue]**: [Solution]
+
+## Quick Wins
+
+These can be fixed quickly for immediate improvement:
+
+1. [Quick fix 1]
+2. [Quick fix 2]
+3. [Quick fix 3]
+
+## Implementation Roadmap
+
+### Week 1: Critical Fixes
+- [ ] [Task 1]
+- [ ] [Task 2]
+
+### Week 2-3: High Priority
+- [ ] [Task 1]
+- [ ] [Task 2]
+
+### Week 4+: Optimization
+- [ ] [Task 1]
+- [ ] [Task 2]
+
+## Monitoring Recommendations
+
+Set up alerts for:
+- Core Web Vitals drops
+- Crawl error spikes
+- Index coverage changes
+- Security issues
+```

package/rcode/templates/settings-hooks.json

@@ -1,5 +1,5 @@
 {
-  "_comment": "pre-edit hook is currently advisory (logs warning, does not block). Full session-read tracking requires PostToolUse Read hook to write state file. Implemented in follow-up.",
+  "_comment": "pre-edit hook is currently advisory (logs warning, does not block). Full session-read tracking requires PostToolUse Read hook to write state file. Implemented in follow-up. prompt-router (UserPromptSubmit) is advisory — emits additionalContext to nudge toward the right rcode command; never blocks.",
   "hooks": {
     "PreToolUse": [
       {
@@ -67,6 +67,21 @@
           {
             "type": "command",
             "command": "node .rcode/bin/rcode-hooks.cjs cost-track"
+          },
+          {
+            "type": "command",
+            "command": "node .rcode/bin/rcode-hooks.cjs stop"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .rcode/bin/rcode-hooks.cjs prompt-router"
           }
         ]
       }

package/rcode/workflows/do.md

@@ -156,6 +156,7 @@ Apply this guard BEFORE the routing table below:
 | "sprint planning", "plan the sprint" | `HAS_EPICS=false` | `/rcode-create-epics-and-stories` first | Sprints draw stories from epics. No epics = no stories to schedule. |
 | "create stories", "epics" | `HAS_PRD=false` | `/rcode-create-prd` first | Epics decompose a milestone. Milestone needs PRD. |
 | "create milestones", "roadmap" | `HAS_PRD=false` | `/rcode-create-prd` first | Roadmap is derived from PRD success metrics. |
+| "run the content factory", "cluster keywords", "brief location pages", "audit my SEO" | `HAS_PRD=false` | `/rcode-new-project` | SEO work requires project context — keyword strategy and content architecture are anchored to a specific domain/PROJECT.md |
 
 When the guard fires, print a clear message:
 
@@ -290,6 +291,7 @@ Evaluate `$QUESTION` against these routing rules. Apply the **first matching** r
 | Validate an idea, "working backwards", "press release", "PRFAQ", "is this worth building" | `/rcode-prfaq` | Stress-test concept before committing sprint capacity |
 | Brainstorm, generate ideas, "explore options", "what could we do" | `/rcode-brainstorm` | Structured ideation before planning |
 | Audit code quality, "review changes", "karpathy", "check my diff", "too complex" | `/rcode-review --karpathy` | 4-principle code audit against recent diff |
+| Make it simpler, "be lazy", "lazy mode", "simplest solution", "yagni", "over-engineered", "kam code likho" | `/rcode-lazy` | Generative simplicity lens — YAGNI before code is written (rcode-trim removes bloat after the fact) |
 | Walk through a change, "checkpoint", "explain this diff", "human review" | `/rcode-checkpoint-preview` | Human-in-the-loop diff walkthrough |
 | Exploring, researching, comparing, or "how does X work" | `/rcode-research-phase` | Domain research before planning |
 | Scope unclear, conflicting UIs/options, "which one", "better UX", "still have confusion", "how should X look", brainstorming vision | `/rcode-discuss-phase` | Decisions not yet locked — gather before planning |
@@ -316,6 +318,21 @@ Evaluate `$QUESTION` against these routing rules. Apply the **first matching** r
 | Completing a milestone, shipping, releasing | `/rcode-complete-milestone` | Milestone lifecycle |
 | Drift / out-of-date / "verify docs vs code" / "audit feature docs" / "fill out existing PRD/epics/stories" | `/rcode-feature-drift` | Detects PRD↔epics↔stories↔code drift; --fix patches trivial items |
 | General audit / re-audit / extend / fill out / expand an existing artifact | `/rcode-audit` | Unified audit entry — picks artifact type and re-runs |
+> **SEO route guard:** Skills in this block assume a project context exists (`.planning/PROJECT.md`). If absent, the `HAS_PRD` check in `<step name="check_project">` redirects to `/rcode-new-project`.
+
+| **— SEO / Content intent —** | | |
+| "audit my SEO", "why am I not ranking", "traffic dropped", "ranking dropped", "seo recovery", "crawl errors" | `/rcode-do` → `seo-audit` | Full technical + on-page + content audit across the site |
+| "per-page audit", "audit this page", "score this URL", "on-page audit" | `/rcode-do` → `on-page-seo-auditor` | Single-page scored report with fix priorities |
+| "core web vitals", "cwv fix", "technical seo", "crawl budget", "indexation", "mobile usability", "site speed" | `/rcode-do` → `technical-seo-checker` | Technical SEO: CWV, crawl, indexing, mobile, speed, architecture, redirects |
+| "keyword research", "cluster keywords", "topic map", "keyword clustering", "find keywords" | `/rcode-do` → `seo-growth-orchestrator` (delegates to `claude-seo:seo-cluster`) | Strategy orchestrator produces cluster map from seed keywords |
+| "content brief", "write SEO content", "blog post", "seo article", "content with E-E-A-T" | `/rcode-do` → `seo-content-writer` | E-E-A-T-aware prose generation with brief adherence checks |
+| "content factory", "programmatic pages", "scale content", "brief location pages", "brief service pages", "run the content factory" | `/rcode-do` → `seo-content-factory` | 10-agent pipeline: competitor research → expansion → clustering → briefs → writing → interlinking → programmatic gen → schema → refresh |
+| "build seo site", "build affiliate site", "niche site", "build content site", "seo site scaffold" | `/rcode-do` → `seo-site-builder` | End-to-end site scaffold with SEO architecture baked in |
+| "local seo", "google business profile", "gbp", "citations", "nap audit", "rank-and-rent" | `/rcode-do` → `rank-and-rent-local-seo` (delegates to `claude-seo:seo-local`) | Local niche selection, city×service matrix, GBP signals, NAP, citations |
+| "schema markup", "structured data", "rich results", "json-ld", "faq schema" | `/rcode-do` → `claude-seo:seo-schema` | Schema generation and validation for all supported types |
+| "ai search", "geo seo", "llms.txt", "ai overviews", "perplexity", "chatgpt visibility", "aeo" | `/rcode-do` → `claude-seo:seo-geo` | GEO/AEO optimization: entity disambiguation, AI answer targeting, llms.txt |
+| "backlinks", "link building", "guest posts", "link acquisition", "digital pr" | `/rcode-do` → `seo-growth-orchestrator` | Backlink acquisition play within the 5-play growth strategy |
+| **— end SEO block —** | | |
 | A specific, actionable, small task (add feature, fix typo, update config) | `/rcode-quick` | Self-contained, single executor |
 | Market/discovery/greenfield question (from classify) | `/rcode-council` | Needs multi-perspective discovery |
 

package/rcode/workflows/enable-hooks.md

@@ -1,7 +1,7 @@
 # Workflow: rcode-enable-hooks
 
 <purpose>
-Merge rcode opt-in hooks from settings-hooks.json into .claude/settings.json. Creates settings.json if missing. Enables all 8 guardrails: pre-edit (read-before-edit check), pre-workflow (command hint), post-commit (format validation), bash-guard (blocks dangerous commands), pre-compact (refreshes HANDOFF.json before context compaction), stop-verify (syntax-checks files changed during the response), cost-track (logs measured token usage to .rcode/telemetry/cost.jsonl), and compact-nudge (advises /rcode-trim or /clear after many edits).
+Merge rcode opt-in hooks from settings-hooks.json into .claude/settings.json. Creates settings.json if missing. Enables all 9 guardrails: pre-edit (read-before-edit check), pre-workflow (command hint), post-commit (format validation), bash-guard (blocks dangerous commands), pre-compact (refreshes HANDOFF.json before context compaction), stop-verify (syntax-checks files changed during the response), cost-track (logs measured token usage to .rcode/telemetry/cost.jsonl), compact-nudge (advises /rcode-trim or /clear after many edits), and prompt-router (proactive nudge toward the right rcode command for long-term memory consistency).
 </purpose>
 
 
@@ -44,7 +44,7 @@ If `.claude/` directory does not exist, create it first.
 
 ## Step 3 — Merge hooks
 
-For each hook type (`PreToolUse`, `PostToolUse`):
+For each hook type (`PreToolUse`, `PostToolUse`, `PreCompact`, `Stop`, `UserPromptSubmit`):
 
 - If the hook type does not exist in the current settings.json, add it.
 - If it exists, append the new matchers and hook commands (avoid duplicates by checking for exact command matches).
@@ -86,6 +86,7 @@ Enabled guardrails:
   • stop-verify: Syntax-checks files changed during the response
   • cost-track: Logs measured token usage to .rcode/telemetry/cost.jsonl
   • compact-nudge: Advises /rcode-trim or /clear after many edits
+  • prompt-router: Nudges toward the matching /rcode-* command and /rcode-memory-update so work lands in .rcode/state.json (toggle via prompt_nudge in .rcode/config.yaml: every|once-per-intent|when-stale|off)
 
 To disable, remove the hooks section from .claude/settings.json or edit .rcode/templates/settings-hooks.json and re-run.
 ```