@lebtiga/sonic-agent 1.0.0

package/plugin/skills/aka-wireframe-wp/references/strategy-planner.md

@@ -0,0 +1,317 @@
+# AKA Strategy Planner
+
+## Purpose
+Generates complete Authority-Knowledge-Answer (AKA) content wireframe by analyzing business requirements and creating comprehensive content architecture.
+
+## Model
+claude-opus-4
+
+## When to Use
+- After initial setup is complete
+- When business config exists
+- To generate complete content strategy
+- To plan 150-300 page site structure
+- Before content generation begins
+
+## Capabilities
+- Industry analysis and pattern recognition
+- Competitor content gap identification
+- Authority Hub topic generation (5-7 hubs)
+- Knowledge page clustering (12-15 per hub)
+- Answer question generation (20-30 per hub)
+- URL structure planning
+- Keyword mapping
+- Implementation priority ranking
+
+## Input Required
+
+**Primary Input**: `.factory/config/aka-wireframe/business-config.json`
+
+Contains all business variables:
+- businessName, industry, location
+- primaryService, secondaryServices
+- targetAudience, painPoints
+- brandVoice, uniqueValue
+- Contact and trust signals
+
+## Output Generated
+
+**Primary Output**: `.factory/config/aka-wireframe/aka-strategy-output.json`
+
+Complete AKA wireframe structure:
+```json
+{
+  "business": {
+    "name": "Cool Air HVAC",
+    "industry": "Home Services (HVAC)",
+    "location": "Atlanta, GA"
+  },
+  "summary": {
+    "totalPages": 247,
+    "authorityHubs": 5,
+    "knowledgePages": 75,
+    "answerPages": 125,
+    "locationPages": 42
+  },
+  "hubs": [
+    {
+      "hubId": 1,
+      "hubName": "AC Repair Services",
+      "slug": "ac-repair-services",
+      "url": "/ac-repair-services/",
+      "primaryKeyword": "AC repair Atlanta",
+      "searchVolume": 2400,
+      "description": "Comprehensive guide to AC repair services in Atlanta",
+      "wordCount": 4000,
+      "knowledgePages": [
+        {
+          "pageId": "k1-1",
+          "title": "AC Not Cooling Troubleshooting",
+          "slug": "ac-not-cooling-troubleshooting",
+          "url": "/ac-repair-services/ac-not-cooling-troubleshooting/",
+          "keyword": "AC not cooling",
+          "wordCount": 2000,
+          "description": "Diagnose and fix AC not cooling issues"
+        },
+        // ... 14 more Knowledge pages
+      ],
+      "answerPages": [
+        {
+          "pageId": "a1-1",
+          "question": "How much does AC repair cost in Atlanta?",
+          "slug": "how-much-ac-repair-cost-atlanta",
+          "url": "/ac-repair-services/how-much-ac-repair-cost-atlanta/",
+          "keyword": "AC repair cost Atlanta",
+          "wordCount": 1000,
+          "questionType": "cost"
+        },
+        // ... 24 more Answer pages
+      ]
+    },
+    // ... 4 more hubs
+  ],
+  "urlStructure": {
+    "pattern": "domain.com/[hub-slug]/[page-slug]/",
+    "totalUrls": 247,
+    "hierarchy": "Authority → Knowledge/Answer (parent-child)"
+  },
+  "keywordStrategy": {
+    "headKeywords": 5,
+    "midTailKeywords": 75,
+    "longTailKeywords": 167
+  },
+  "implementationPriority": [
+    {"hub": 1, "reason": "Highest search volume", "order": 1},
+    {"hub": 2, "reason": "Secondary service", "order": 2},
+    // ...
+  ]
+}
+```
+
+**Secondary Output**: `generated-content/aka-wireframe-roadmap.md`
+
+Human-readable roadmap with:
+- Executive summary
+- Hub-by-hub breakdown
+- Implementation timeline
+- Success metrics
+
+## Strategy Generation Process
+
+### Step 1: Industry Analysis
+Analyze the business industry to understand:
+- Common service types
+- Customer pain points
+- Search behavior patterns
+- Competitor content approaches
+- Topical authority opportunities
+
+### Step 2: Authority Hub Identification
+Identify 5-7 Authority Hub topics based on:
+- Primary and secondary services
+- Customer journey stages
+- Problem-based hubs (what customers need to solve)
+- Process-based hubs (how things work)
+- Location-based considerations
+
+**Hub Identification Rules**:
+- Each hub should support 12-15 Knowledge pages
+- Each hub should support 20-30 Answer questions
+- Hubs should have search volume and intent
+- Hubs should align with business services
+
+### Step 3: Knowledge Page Clustering
+For each Authority Hub, generate 12-15 Knowledge pages:
+
+**Categories**:
+- Specific problems (5-7 pages)
+- Service types (3-5 pages)
+- Process details (2-3 pages)
+- Cost/pricing guides (1-2 pages)
+- Comparison topics (1-2 pages)
+
+**Example for HVAC AC Repair Hub**:
+1. AC Not Cooling Troubleshooting (problem)
+2. AC Refrigerant Leak Repair (problem)
+3. AC Compressor Replacement (service type)
+4. AC Fan Motor Repair (service type)
+5. Emergency AC Repair Services (service type)
+6. AC Repair Cost Guide Atlanta (pricing)
+7. AC Repair vs Replacement Decision (comparison)
+8. ... [5-8 more]
+
+### Step 4: Answer Question Generation
+For each Authority Hub, generate 20-30 questions:
+
+**Question Types Distribution**:
+- How questions (5): Process/instructions
+- What questions (5): Definitions/explanations
+- Why questions (4): Reasoning/importance
+- When questions (3): Timing/urgency
+- Cost questions (4): Pricing/value
+- Comparison questions (3): This vs that
+- Emergency/urgent questions (3): Immediate needs
+
+**Question Generation Method**:
+- Research "People Also Ask" for hub topic
+- Analyze common customer questions
+- Consider objections and concerns
+- Target featured snippet opportunities
+- Use natural language as people search
+
+### Step 5: URL Structure Planning
+Create complete URL hierarchy:
+
+**Pattern**: `domain.com/[hub-slug]/[page-slug]/`
+
+**WordPress Hierarchy**:
+- Authority Hub = Parent page
+- Knowledge Pages = Children of hub
+- Answer Pages = Children of hub
+
+**Example**:
+```
+/ac-repair-services/ (Authority Hub)
+├── /ac-repair-services/ac-not-cooling/ (Knowledge)
+├── /ac-repair-services/refrigerant-leak/ (Knowledge)
+├── /ac-repair-services/how-much-cost/ (Answer)
+└── /ac-repair-services/diy-vs-professional/ (Answer)
+```
+
+### Step 6: Keyword Mapping
+Map keywords to pages:
+
+**Authority Pages**: Head keywords (1,000+ searches/month)
+**Knowledge Pages**: Mid-tail keywords (100-1,000 searches/month)
+**Answer Pages**: Long-tail questions (10-100 searches/month)
+
+Include:
+- Primary keyword per page
+- Secondary keywords (3-5)
+- LSI keywords (related terms)
+- Local modifiers where applicable
+
+### Step 7: Priority Ranking
+Rank implementation order based on:
+- Search volume and opportunity
+- Business priority (main services first)
+- Competitive difficulty
+- Customer journey alignment
+
+## Industry-Specific Adaptations
+
+### Law Firms
+**Hubs**: Practice areas (car accidents, truck accidents, etc.)
+**Knowledge**: Accident types, injury types, legal processes
+**Answers**: Cost, process, timing, fault questions
+
+### Home Services (HVAC, Plumbing, etc.)
+**Hubs**: Service types (repair, installation, maintenance)
+**Knowledge**: Specific problems, equipment types, processes
+**Answers**: Cost, DIY vs pro, emergency, timing
+
+### Financial Services
+**Hubs**: Product types, processes, requirements
+**Knowledge**: Specific scenarios, eligibility, regulations
+**Answers**: Cost, qualification, timing, alternatives
+
+### Healthcare
+**Hubs**: Conditions treated, services offered
+**Knowledge**: Specific conditions, treatments, processes
+**Answers**: Insurance, cost, preparation, expectations
+
+## Validation Rules
+
+Before outputting strategy, validate:
+
+✅ **Hub Count**: 5-7 hubs (not too few, not too many)
+✅ **Knowledge per Hub**: 12-15 pages (proper depth)
+✅ **Answers per Hub**: 20-30 questions (comprehensive coverage)
+✅ **Total Pages**: 150-300 (reasonable scope)
+✅ **URL Structure**: Proper hierarchy with no duplicates
+✅ **Keywords**: Mapped to every page
+✅ **Searchable Topics**: Every hub has search volume
+✅ **Business Alignment**: Matches business services
+
+## Example Strategy for Different Industries
+
+### HVAC Company Strategy
+```json
+{
+  "hubs": [
+    {"hubName": "AC Repair Services", "knowledgeCount": 15, "answerCount": 25},
+    {"hubName": "Heating System Repair", "knowledgeCount": 15, "answerCount": 25},
+    {"hubName": "HVAC Installation Guide", "knowledgeCount": 12, "answerCount": 20},
+    {"hubName": "Preventative Maintenance", "knowledgeCount": 13, "answerCount": 22},
+    {"hubName": "Emergency HVAC Services", "knowledgeCount": 12, "answerCount": 23}
+  ],
+  "totalPages": 205
+}
+```
+
+### Law Firm Strategy
+```json
+{
+  "hubs": [
+    {"hubName": "Car Accident Lawyer", "knowledgeCount": 15, "answerCount": 25},
+    {"hubName": "Truck Accident Attorney", "knowledgeCount": 12, "answerCount": 18},
+    {"hubName": "Motorcycle Accident Lawyer", "knowledgeCount": 12, "answerCount": 20},
+    {"hubName": "Wrongful Death Attorney", "knowledgeCount": 13, "answerCount": 16},
+    {"hubName": "Auto Injury Compensation", "knowledgeCount": 17, "answerCount": 25}
+  ],
+  "totalPages": 227
+}
+```
+
+## Output Format
+
+**Strategy JSON** (complete machine-readable structure)
+**Roadmap Markdown** (human-readable implementation plan)
+**Progress Tracker** (initialized for first hub)
+
+## User Guidance
+
+After generation, provide:
+- Summary of strategy created
+- Total page count and breakdown
+- Recommended start point (usually Hub 1)
+- Next command to run
+- Estimated time to complete
+
+## Success Criteria
+
+✅ Strategy generated in under 2 minutes
+✅ Proper AKA structure (Authority → Knowledge → Answer)
+✅ Realistic page count (150-300)
+✅ Every page has keyword target
+✅ URL structure follows best practices
+✅ Implementation priority clear
+✅ Ready for content generation
+
+## Notes
+
+- Strategy should be industry-agnostic (works for any vertical)
+- Use business config to inform strategy
+- Consider local SEO for location-based businesses
+- Balance comprehensiveness with feasibility
+- Prioritize actionability over perfection