claude-flow-novice 2.14.29 → 2.14.31

package/claude-assets/cfn-agents-ignore/cfn-seo-team/DELEGATION_MATRIX.md.backup

@@ -0,0 +1,371 @@
+# SEO Agent Delegation Matrix
+
+This document provides clear guidance on which SEO specialist agent to use for specific tasks.
+
+## Quick Reference Table
+
+| Task Type | Primary Agent | Secondary Agent | Tools Used |
+|-----------|---------------|-----------------|------------|
+| Site audit, performance optimization | technical-seo-specialist | - | Read, Write, Edit, Bash, Grep, Glob, TodoWrite |
+| Keyword research, content strategy | content-seo-strategist | - | Read, Write, Edit, TodoWrite |
+| Template-based page generation | programmatic-seo-engineer | - | Read, Write, Edit, Bash, Grep, Glob, TodoWrite |
+| AI search optimization, citations | geo-optimization-expert | - | Read, Write, Edit, TodoWrite |
+| Backlink prospecting, outreach | link-building-specialist | - | Read, Write, Edit, TodoWrite |
+| Local SEO, GBP optimization | local-seo-optimizer | - | Read, Write, Edit, TodoWrite |
+| Traffic analysis, ranking tracking | seo-analytics-specialist | - | Read, Write, Edit, Bash, TodoWrite |
+| Content quality, E-E-A-T audit | eeat-content-auditor | - | Read, Write, Edit, Grep, Glob, TodoWrite |
+| Competitor analysis, gap identification | competitive-seo-analyst | - | Read, Write, Edit, TodoWrite |
+| Schema markup, structured data | schema-markup-engineer | - | Read, Write, Edit, Bash, TodoWrite |
+
+## Detailed Delegation Guide
+
+### Technical SEO Tasks
+
+**Use: technical-seo-specialist**
+
+Trigger phrases:
+- "conduct technical audit"
+- "fix crawl errors"
+- "optimize Core Web Vitals"
+- "improve page speed"
+- "generate sitemap"
+- "configure robots.txt"
+- "fix broken links"
+- "optimize site architecture"
+
+Delegates to:
+- content-seo-strategist (content optimization)
+- programmatic-seo-engineer (programmatic page generation)
+- schema-markup-engineer (complex schema design)
+
+---
+
+### Content Strategy & Keyword Research
+
+**Use: content-seo-strategist**
+
+Trigger phrases:
+- "keyword research"
+- "content strategy"
+- "create content brief"
+- "topic clustering"
+- "SERP analysis"
+- "search intent mapping"
+- "pillar content strategy"
+- "keyword clustering"
+
+Delegates to:
+- technical-seo-specialist (technical issues)
+- programmatic-seo-engineer (programmatic content)
+- link-building-specialist (link building)
+
+---
+
+### Programmatic SEO & Template Generation
+
+**Use: programmatic-seo-engineer**
+
+Trigger phrases:
+- "generate 1000 pages"
+- "template-based pages"
+- "database-driven content"
+- "programmatic SEO"
+- "quality validation at scale"
+- "duplicate content detection"
+- "automated internal linking"
+
+Delegates to:
+- content-seo-strategist (keyword research)
+- technical-seo-specialist (technical SEO)
+- schema-markup-engineer (schema complexity)
+
+---
+
+### AI Search & GEO Optimization
+
+**Use: geo-optimization-expert**
+
+Trigger phrases:
+- "AI search optimization"
+- "GEO strategy"
+- "ChatGPT visibility"
+- "track AI citations"
+- "entity optimization"
+- "Perplexity citations"
+- "multi-modal content"
+
+Delegates to:
+- technical-seo-specialist (traditional SEO)
+- content-seo-strategist (content creation)
+- schema-markup-engineer (schema for AI)
+
+---
+
+### Link Building & Outreach
+
+**Use: link-building-specialist**
+
+Trigger phrases:
+- "backlink prospecting"
+- "link building campaign"
+- "outreach strategy"
+- "broken link building"
+- "resource page targeting"
+- "guest posting"
+- "competitor backlinks"
+
+Delegates to:
+- technical-seo-specialist (technical issues)
+- content-seo-strategist (content for guest posts)
+- local-seo-optimizer (local citations)
+
+---
+
+### Local SEO & Google Business Profile
+
+**Use: local-seo-optimizer**
+
+Trigger phrases:
+- "GBP optimization"
+- "local SEO"
+- "local citations"
+- "NAP consistency"
+- "local pack rankings"
+- "geographic content"
+- "location schema"
+
+Delegates to:
+- technical-seo-specialist (technical SEO)
+- content-seo-strategist (location content)
+- link-building-specialist (non-citation links)
+
+---
+
+### SEO Analytics & Reporting
+
+**Use: seo-analytics-specialist**
+
+Trigger phrases:
+- "traffic analysis"
+- "ranking tracking"
+- "conversion optimization"
+- "SEO ROI calculation"
+- "reporting dashboard"
+- "A/B testing"
+- "performance monitoring"
+
+Delegates to:
+- technical-seo-specialist (technical fixes)
+- content-seo-strategist (content optimization)
+- link-building-specialist (link building)
+
+---
+
+### Content Quality & E-E-A-T Audits
+
+**Use: eeat-content-auditor**
+
+Trigger phrases:
+- "E-E-A-T audit"
+- "content quality assessment"
+- "author verification"
+- "citation validation"
+- "trust signals"
+- "YMYL content review"
+- "quality scoring"
+
+Delegates to:
+- technical-seo-specialist (technical issues)
+- content-seo-strategist (content optimization)
+- link-building-specialist (link building)
+
+---
+
+### Competitive Analysis
+
+**Use: competitive-seo-analyst**
+
+Trigger phrases:
+- "competitor analysis"
+- "keyword gaps"
+- "backlink gaps"
+- "content gap analysis"
+- "SERP feature tracking"
+- "market share calculation"
+- "competitive intelligence"
+
+Delegates to:
+- content-seo-strategist (keyword research)
+- link-building-specialist (link building execution)
+- technical-seo-specialist (technical implementation)
+
+---
+
+### Schema Markup & Structured Data
+
+**Use: schema-markup-engineer**
+
+Trigger phrases:
+- "schema markup"
+- "JSON-LD generation"
+- "structured data"
+- "rich snippet optimization"
+- "VideoObject schema"
+- "HowTo schema"
+- "FAQ schema"
+- "schema validation"
+
+Delegates to:
+- technical-seo-specialist (technical SEO)
+- content-seo-strategist (content optimization)
+- programmatic-seo-engineer (programmatic schema)
+
+---
+
+## Multi-Agent Workflows
+
+### Complete SEO Audit (All Agents)
+1. **technical-seo-specialist**: Site audit, performance optimization
+2. **eeat-content-auditor**: Content quality assessment
+3. **schema-markup-engineer**: Schema validation
+4. **seo-analytics-specialist**: Traffic and ranking analysis
+5. **competitive-seo-analyst**: Competitor benchmarking
+
+### Content Launch Workflow
+1. **content-seo-strategist**: Keyword research, content brief
+2. **eeat-content-auditor**: Quality review, E-E-A-T compliance
+3. **schema-markup-engineer**: Implement schema markup
+4. **technical-seo-specialist**: Technical optimization
+5. **link-building-specialist**: Outreach for backlinks
+
+### Programmatic SEO Project
+1. **programmatic-seo-engineer**: Template development, page generation
+2. **content-seo-strategist**: Keyword clustering, topic mapping
+3. **schema-markup-engineer**: Programmatic schema implementation
+4. **technical-seo-specialist**: Crawl budget optimization
+5. **seo-analytics-specialist**: Monitor indexation and rankings
+
+### Local SEO Campaign
+1. **local-seo-optimizer**: GBP optimization, citation building
+2. **content-seo-strategist**: Location-based content strategy
+3. **schema-markup-engineer**: LocalBusiness schema
+4. **link-building-specialist**: Local link building
+5. **seo-analytics-specialist**: Local ranking tracking
+
+---
+
+## Integration Requirements by Agent
+
+### API Access Required
+- **technical-seo-specialist**: PageSpeed Insights, Google Search Console
+- **content-seo-strategist**: SE Ranking, Ahrefs
+- **geo-optimization-expert**: Perplexity, OpenAI, Knowledge Graph
+- **link-building-specialist**: Ahrefs, SE Ranking, Hunter.io
+- **local-seo-optimizer**: Google Business Profile, BrightLocal
+- **seo-analytics-specialist**: Google Analytics 4, Google Search Console, SE Ranking
+- **competitive-seo-analyst**: SE Ranking, Ahrefs, SEMrush
+- **schema-markup-engineer**: Google Rich Results Test
+
+### Service Dependencies
+- **All agents**: PostgreSQL (data storage), n8n (workflow automation)
+- **technical-seo-specialist**: Performance metrics caching
+- **programmatic-seo-engineer**: Template caching for performance
+
+---
+
+## Agent Selection Decision Tree
+
+```
+START: What is the primary goal?
+
+├─ Site Performance/Technical Issues?
+│  └─ Use: technical-seo-specialist
+│
+├─ Content Strategy/Keywords?
+│  └─ Use: content-seo-strategist
+│
+├─ Generate Many Pages at Scale?
+│  └─ Use: programmatic-seo-engineer
+│
+├─ AI Search Visibility?
+│  └─ Use: geo-optimization-expert
+│
+├─ Build Backlinks?
+│  └─ Use: link-building-specialist
+│
+├─ Local/Geographic SEO?
+│  └─ Use: local-seo-optimizer
+│
+├─ Track Performance/Analytics?
+│  └─ Use: seo-analytics-specialist
+│
+├─ Content Quality/E-E-A-T?
+│  └─ Use: eeat-content-auditor
+│
+├─ Competitor Research?
+│  └─ Use: competitive-seo-analyst
+│
+└─ Schema/Structured Data?
+   └─ Use: schema-markup-engineer
+```
+
+---
+
+## Common Multi-Agent Scenarios
+
+### Scenario 1: New Website Launch
+**Agents Required:** 6
+1. technical-seo-specialist (site audit)
+2. content-seo-strategist (keyword research)
+3. schema-markup-engineer (implement schema)
+4. local-seo-optimizer (GBP setup, if applicable)
+5. eeat-content-auditor (content quality check)
+6. seo-analytics-specialist (setup tracking)
+
+### Scenario 2: Traffic Drop Investigation
+**Agents Required:** 3-4
+1. seo-analytics-specialist (diagnose traffic drop)
+2. technical-seo-specialist (check for technical issues)
+3. competitive-seo-analyst (check competitor changes)
+4. eeat-content-auditor (content quality assessment, if needed)
+
+### Scenario 3: Content Scaling Initiative
+**Agents Required:** 4
+1. content-seo-strategist (keyword research, strategy)
+2. programmatic-seo-engineer (template development)
+3. schema-markup-engineer (programmatic schema)
+4. seo-analytics-specialist (monitor performance)
+
+### Scenario 4: Competitor Overtake Strategy
+**Agents Required:** 5
+1. competitive-seo-analyst (identify gaps)
+2. content-seo-strategist (content strategy)
+3. link-building-specialist (backlink acquisition)
+4. schema-markup-engineer (capture SERP features)
+5. seo-analytics-specialist (track progress)
+
+---
+
+## Agent Communication Patterns
+
+### Sequential Workflows
+- **Technical audit → Content strategy → Implementation**
+  - technical-seo-specialist → content-seo-strategist → programmatic-seo-engineer
+
+- **Research → Creation → Validation**
+  - content-seo-strategist → (content creation) → eeat-content-auditor
+
+### Parallel Workflows
+- **Comprehensive Audit (All at once)**
+  - technical-seo-specialist + eeat-content-auditor + schema-markup-engineer + seo-analytics-specialist
+
+- **Content Launch (Simultaneous optimization)**
+  - schema-markup-engineer + technical-seo-specialist + link-building-specialist
+
+---
+
+## Notes
+- All agents support CFN Loop completion protocols
+- Agents report confidence scores (0.0-1.0) for quality assurance
+- Use multiple agents in parallel for comprehensive SEO initiatives
+- Agents delegate out-of-scope work to appropriate specialists

package/claude-assets/cfn-agents-ignore/cfn-seo-team/INTEGRATION_REQUIREMENTS.md

@@ -265,16 +265,15 @@ This document outlines the API integrations, service dependencies, and external
 
 ---
 
-### Redis
+### Caching System
 **Required by:**
 - technical-seo-specialist (cache performance metrics)
 - programmatic-seo-engineer (cache rendered templates)
-- All agents (CFN Loop coordination)
 
 **Use cases:**
 - Cache API responses (reduce API costs)
-- Store temporary data during CFN Loop execution
-- Agent coordination via pub/sub
+- Store temporary data during execution
+- Performance optimization for repeated operations
 
 ---
 
@@ -397,7 +396,7 @@ BRIGHTLOCAL_API_KEY=your_key_here
 
 ### Best Practices
 - Implement exponential backoff for rate limit errors
-- Cache API responses in Redis (TTL: 24 hours)
+- Cache API responses in caching system (TTL: 24 hours)
 - Batch API requests when possible
 
 ---
@@ -487,17 +486,13 @@ CREATE TABLE schema_validation (
 );
 ```
 
-### 4. Redis Setup
-```bash
-# Install Redis
-sudo apt-get install redis-server
-
-# Start Redis
-redis-server
+### 4. Caching System Setup
+Set up your preferred caching system for performance optimization and temporary data storage.
 
-# Test connection
-redis-cli ping  # Should return PONG
-```
+**Recommended Options:**
+- High-performance caching system for large-scale operations
+- Simple key-value caching for basic use cases
+- Application-level caching for minimal dependencies
 
 ### 5. n8n Setup (Optional)
 ```bash
@@ -531,10 +526,8 @@ curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.ahrefs.com/v3/site-exp
 psql -h localhost -U postgres -d seo_agent_db -c "SELECT 1;"
 ```
 
-### Redis Connection Test
-```bash
-redis-cli ping
-```
+### Caching System Connection Test
+Test your chosen caching system to ensure it's working properly for agent operations.
 
 ---
 
@@ -548,7 +541,7 @@ redis-cli ping
 - Ensure service account has correct permissions
 
 **2. SE Ranking rate limits**
-- Implement caching (Redis TTL: 24 hours)
+- Implement caching (TTL: 24 hours)
 - Batch requests when possible
 - Upgrade to higher plan if needed
 
@@ -557,10 +550,11 @@ redis-cli ping
 - Verify database credentials in .env
 - Ensure database exists and tables are created
 
-**4. Redis connection errors**
-- Check Redis service is running (`redis-cli ping`)
-- Verify Redis host and port in configuration
-- Check firewall rules if using remote Redis
+**4. Caching system connection errors**
+- Check caching service is running and accessible
+- Verify caching system host and port in configuration
+- Check firewall rules if using remote caching system
+- Validate authentication credentials if required
 
 ---
 
@@ -593,7 +587,7 @@ redis-cli ping
 
 ### technical-seo-specialist
 - Primary APIs: PageSpeed Insights, Google Search Console
-- Heavy user of Redis caching (performance metrics)
+- Heavy user of caching systems (performance metrics)
 - Requires Screaming Frog export data
 
 ### content-seo-strategist
@@ -603,7 +597,7 @@ redis-cli ping
 
 ### programmatic-seo-engineer
 - Primary service: PostgreSQL (source data)
-- Heavy Redis usage (template caching)
+- Heavy caching usage (template caching)
 - Requires Copyscape for duplicate detection
 
 ### geo-optimization-expert