@hanzlaa/rcode 4.3.3 → 4.4.1

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

@@ -67,6 +67,10 @@
           {
             "type": "command",
             "command": "node .rcode/bin/rcode-hooks.cjs cost-track"
+          },
+          {
+            "type": "command",
+            "command": "node .rcode/bin/rcode-hooks.cjs stop"
           }
         ]
       }

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:
 
@@ -317,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/execute-sprint.md

@@ -375,6 +375,22 @@ If new untracked files appeared after running scripts or tools, decide for each:
 
 </task_commit>
 
+<hook_revert_detection_gate>
+## Post-Step Hook Revert Detection Gate
+
+After each task that writes or edits files, run:
+```bash
+git diff --name-only HEAD
+```
+If a file that was supposed to be written by this step shows NO diff (i.e. git thinks it's clean), that file was reverted by a hook. STOP — do NOT mark the step done. Report:
+```
+⚠ Revert detected: <filename> was written by this step but shows no diff vs HEAD.
+  Likely cause: a linter or pre-commit hook reverted the file.
+  Action required: inspect the hook output in the last git commit attempt, fix the root cause, then re-run this task.
+```
+Do not proceed to the next task until all expected file changes survive the git diff check.
+</hook_revert_detection_gate>
+
 <post_step_revert_gate>
 ## Post-Step Revert Detection Gate
 
@@ -497,6 +513,12 @@ If user_setup exists: create `{phase}-USER-SETUP.md` using template `.rcode/temp
 </step>
 
 <step name="create_summary">
+**Overwrite guard:** If `{phase}-{plan}-SUMMARY.md` already exists at `.planning/phases/XX-name/`, delete it first before writing:
+```bash
+rm -f ".planning/phases/XX-name/{phase}-{plan}-SUMMARY.md"
+```
+Never append to or skip an existing SUMMARY.md — always overwrite with the current sprint's completion data. Silently continuing with a stale SUMMARY.md is a critical bug.
+
 Create `{phase}-{plan}-SUMMARY.md` at `.planning/phases/XX-name/`. Use `.rcode/templates/summary.md`.
 
 **Frontmatter:** phase, plan, subsystem, tags | requires/provides/affects | tech-stack.added/patterns | key-files.created/modified | key-decisions | requirements-completed (**MUST** copy `requirements` array from SPRINT.md frontmatter verbatim) | duration ($DURATION), completed ($PLAN_END_TIME date).