@lebtiga/sonic-agent 1.0.0

package/plugin/skills/aka-wireframe-wp/references/wordpress-deployer.md

@@ -0,0 +1,545 @@
+# AKA WordPress Deployer
+
+## Purpose
+Deploys generated and linked content to WordPress with proper parent-child hierarchy, navigation, SEO metadata, and AKA Framework Theme.
+
+## Model
+claude-opus-4
+
+## When to Use
+- After content generation and linking complete
+- To deploy individual pages or entire hubs
+- To update existing WordPress pages
+- To set up complete site structure
+
+## Capabilities
+- WordPress REST API integration
+- AKA Framework Theme installation/activation
+- Page creation with proper hierarchy
+- Parent-child relationship management
+- Navigation menu creation
+- SEO metadata insertion
+- Schema markup addition
+- Image uploading and optimization
+- Permalink configuration
+- Breadcrumb setup
+
+## Input Required
+
+**Required Files**:
+1. Generated content (after linking)
+2. `.factory/config/aka-wireframe/aka-strategy-output.json`
+3. `.factory/config/aka-wireframe/business-config.json`
+
+**WordPress Connection**:
+- `--url` WordPress site URL
+- `--username` WordPress admin username
+- `--password` WordPress app password (secure)
+- Or environment variables: `WP_URL`, `WP_USER`, `WP_PASS`
+
+**Parameters**:
+- `--hub N` - Deploy specific hub
+- `--all` - Deploy all generated content
+- `--dry-run` - Preview without deploying
+- `--skip-theme` - Don't install/activate theme
+- `--update` - Update existing pages instead of create
+
+## Output Generated
+
+**WordPress Pages Created**:
+- Authority Hub pages (parent pages)
+- Knowledge pages (children of hubs)
+- Answer pages (children of hubs)
+- Navigation menus
+- Breadcrumbs
+
+**Reports**:
+- Deployment log
+- Page URL list
+- Success/failure summary
+
+## Deployment Process
+
+### Step 1: WordPress Connection Validation
+
+**Check**:
+- WordPress site accessible
+- REST API enabled
+- Credentials valid
+- Required plugins installed (Yoast/Rank Math)
+
+**Output**:
+```
+🌐 Connecting to WordPress...
+→ URL: http://localhost:8080
+→ WordPress version: 6.4
+→ REST API: ✓ Enabled
+→ Authentication: ✓ Valid
+→ Yoast SEO: ✓ Installed
+```
+
+### Step 2: Theme Installation
+
+**If AKA Framework Theme not active**:
+
+```
+→ Installing AKA Framework Theme...
+  ✓ Theme uploaded
+  ✓ Theme activated
+  ✓ Page templates registered:
+    - page-authority-hub.php
+    - page-knowledge.php
+    - page-answer.php
+```
+
+**Theme Files Uploaded**:
+- Complete AKA Framework Theme from `/aka-framework-theme/`
+- Customized with business colors from config
+- Logo placeholder ready
+
+**Configuration Applied**:
+```javascript
+// Auto-configure theme with business info
+{
+  "siteName": "{{BUSINESS_NAME}}",
+  "tagline": "{{PRIMARY_SERVICE}} in {{LOCATION}}",
+  "phone": "{{PHONE}}",
+  "address": "{{ADDRESS}}",
+  "colors": {
+    "primary": "#custom-color",
+    "secondary": "#custom-color"
+  }
+}
+```
+
+### Step 3: Page Creation with Hierarchy
+
+**Authority Hub Creation** (Parent Page):
+```javascript
+// Create Authority page
+const authorityPage = await wpCreatePage({
+  title: "AC Repair Services in Atlanta",
+  slug: "ac-repair-services",
+  content: linkedContent, // HTML from linking phase
+  status: "publish",
+  parent: 0, // Top-level page
+  template: "page-authority-hub.php",
+  meta: {
+    yoast_title: "AC Repair Atlanta | Cool Air HVAC",
+    yoast_metadesc: "Expert AC repair in Atlanta...",
+    focus_keyword: "AC repair Atlanta",
+    schema_type: "Service"
+  }
+});
+
+console.log(`✓ Created: ${authorityPage.url}`);
+```
+
+**Knowledge Pages Creation** (Children):
+```javascript
+// Create Knowledge pages as children
+hub.knowledgePages.forEach(async (page) => {
+  const knowledgePage = await wpCreatePage({
+    title: page.title,
+    slug: page.slug,
+    content: page.linkedContent,
+    status: "publish",
+    parent: authorityPage.id, // Child of Authority
+    template: "page-knowledge.php",
+    meta: {
+      yoast_title: page.seoTitle,
+      yoast_metadesc: page.metaDescription,
+      focus_keyword: page.keyword
+    }
+  });
+  
+  console.log(`  ✓ Created: ${knowledgePage.url}`);
+});
+```
+
+**Answer Pages Creation** (Children):
+```javascript
+// Create Answer pages as children
+hub.answerPages.forEach(async (page) => {
+  const answerPage = await wpCreatePage({
+    title: page.question, // Exact question as title
+    slug: page.slug,
+    content: page.linkedContent,
+    status: "publish",
+    parent: authorityPage.id, // Child of Authority
+    template: "page-answer.php",
+    meta: {
+      yoast_title: page.seoTitle,
+      yoast_metadesc: page.metaDescription,
+      schema_type: "FAQPage"
+    }
+  });
+  
+  console.log(`  ✓ Created: ${answerPage.url}`);
+});
+```
+
+**Deployment Progress**:
+```
+🏛️ Deploying Hub 1 to WordPress...
+
+Authority Hub:
+✓ Created: /ac-repair-services/ (ID: 123)
+
+Knowledge Pages (15):
+✓ 1/15 Created: /ac-repair-services/ac-not-cooling/
+✓ 2/15 Created: /ac-repair-services/refrigerant-leak-repair/
+✓ 3/15 Created: /ac-repair-services/compressor-replacement/
+...
+✓ 15/15 Created: /ac-repair-services/emergency-ac-repair/
+
+Answer Pages (25):
+✓ 1/25 Created: /ac-repair-services/how-much-ac-repair-cost/
+✓ 2/25 Created: /ac-repair-services/why-ac-not-cooling/
+...
+✓ 25/25 Created: /ac-repair-services/can-i-diy-ac-repair/
+
+Total: 41 pages created in 3 minutes
+```
+
+### Step 4: Navigation Menu Creation
+
+**Hub Navigation Menu**:
+```javascript
+// Create menu for Hub 1
+const hubMenu = await wpCreateMenu({
+  name: "Hub 1: AC Repair",
+  location: "hub-1-sidebar",
+  items: [
+    {
+      type: "page",
+      id: authorityPage.id,
+      title: "Overview"
+    },
+    {
+      type: "custom",
+      title: "Knowledge Base",
+      url: "#",
+      children: hub.knowledgePages.map(p => ({
+        type: "page",
+        id: p.wpId,
+        title: p.title
+      }))
+    },
+    {
+      type: "custom",
+      title: "Common Questions",
+      url: "#",
+      children: hub.answerPages.slice(0, 10).map(p => ({
+        type: "page",
+        id: p.wpId,
+        title: p.question
+      }))
+    }
+  ]
+});
+```
+
+**Main Site Menu** (if deploying all hubs):
+```javascript
+const mainMenu = await wpCreateMenu({
+  name: "Primary Navigation",
+  location: "primary",
+  items: [
+    { title: "Home", url: "/" },
+    {
+      title: "Services",
+      children: strategy.hubs.map(hub => ({
+        type: "page",
+        id: hub.authorityPage.wpId,
+        title: hub.hubName
+      }))
+    },
+    { title: "About", url: "/about/" },
+    { title: "Contact", url: "/contact/" }
+  ]
+});
+```
+
+### Step 5: SEO Metadata & Schema
+
+**For Each Page**:
+
+**SEO Metadata** (via Yoast/Rank Math):
+```javascript
+await wpUpdatePageMeta(pageId, {
+  // Title tag
+  '_yoast_wpseo_title': '{{TITLE}} | {{BUSINESS_NAME}}',
+  
+  // Meta description
+  '_yoast_wpseo_metadesc': '{{META_DESCRIPTION}}',
+  
+  // Focus keyword
+  '_yoast_wpseo_focuskw': '{{PRIMARY_KEYWORD}}',
+  
+  // Canonical URL
+  '_yoast_wpseo_canonical': page.url,
+  
+  // Open Graph
+  '_yoast_wpseo_opengraph-title': page.title,
+  '_yoast_wpseo_opengraph-description': page.metaDescription,
+  
+  // Twitter Card
+  '_yoast_wpseo_twitter-title': page.title,
+  '_yoast_wpseo_twitter-description': page.metaDescription
+});
+```
+
+**Schema Markup**:
+
+**Authority Page** (Service + LocalBusiness):
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "Service",
+  "serviceType": "{{PRIMARY_SERVICE}}",
+  "provider": {
+    "@type": "LocalBusiness",
+    "name": "{{BUSINESS_NAME}}",
+    "address": {
+      "@type": "PostalAddress",
+      "streetAddress": "{{ADDRESS}}",
+      "addressLocality": "{{CITY}}",
+      "addressRegion": "{{STATE}}"
+    },
+    "telephone": "{{PHONE}}",
+    "aggregateRating": {
+      "@type": "AggregateRating",
+      "ratingValue": "4.9",
+      "reviewCount": "500"
+    }
+  }
+}
+```
+
+**Knowledge Page** (Article + HowTo):
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": "{{PAGE_TITLE}}",
+  "author": {
+    "@type": "Organization",
+    "name": "{{BUSINESS_NAME}}"
+  }
+}
+```
+
+**Answer Page** (FAQPage):
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "FAQPage",
+  "mainEntity": [{
+    "@type": "Question",
+    "name": "{{QUESTION}}",
+    "acceptedAnswer": {
+      "@type": "Answer",
+      "text": "{{ANSWER_TEXT}}"
+    }
+  }]
+}
+```
+
+### Step 6: Permalink Configuration
+
+**Set Permalink Structure**:
+```javascript
+// Ensure proper URL structure
+await wpSetPermalinks({
+  structure: '/%postname%/', // Clean URLs
+  category_base: '',
+  tag_base: ''
+});
+```
+
+**Result**:
+- `/ac-repair-services/` (Authority)
+- `/ac-repair-services/ac-not-cooling/` (Knowledge)
+- `/ac-repair-services/how-much-cost/` (Answer)
+
+### Step 7: Breadcrumb Setup
+
+**Configure Yoast Breadcrumbs**:
+```javascript
+// For Knowledge/Answer pages
+Home > AC Repair Services > AC Not Cooling Troubleshooting
+
+// Breadcrumb structure from parent-child
+await wpSetBreadcrumbs({
+  enabled: true,
+  separator: '>',
+  home_text: 'Home',
+  prefix: '',
+  archiveprefix: '',
+  searchprefix: 'Search for'
+});
+```
+
+## Dry Run Mode
+
+**When `--dry-run` specified**:
+
+```
+🏛️ DRY RUN: Previewing Hub 1 Deployment
+
+Would create:
+✓ Authority: /ac-repair-services/
+  Title: AC Repair Services in Atlanta
+  Parent: None (top-level)
+  Template: page-authority-hub.php
+  
+✓ Knowledge: /ac-repair-services/ac-not-cooling/
+  Title: AC Not Cooling Troubleshooting
+  Parent: AC Repair Services (ID would be created)
+  Template: page-knowledge.php
+  
+... [Preview all 41 pages]
+
+Would create navigation menu: "Hub 1: AC Repair"
+Would set SEO metadata for all pages
+Would add schema markup
+
+Total: 41 pages would be created
+
+→ No actual changes made
+→ Run without --dry-run to deploy
+```
+
+## Error Handling
+
+**Page Creation Failure**:
+```
+⚠️ Error creating page: AC Compressor Replacement
+
+Error: Duplicate slug detected
+Suggestion: Page may already exist
+
+Options:
+1. Run with --update to update existing page
+2. Change slug in strategy
+3. Delete existing page manually
+
+→ Continuing with remaining pages...
+```
+
+**WordPress Connection Lost**:
+```
+❌ WordPress connection lost during deployment
+
+Status:
+✓ Created: 15/41 pages
+✗ Failed: 26 pages remaining
+
+→ Safe to retry - existing pages won't duplicate
+→ Run: aka-wireframe-wp deploy --hub 1 --resume
+```
+
+## Update Mode
+
+**When `--update` specified**:
+
+```
+→ Update mode: Modifying existing pages
+
+✓ Updated: /ac-repair-services/ (ID: 123)
+✓ Updated: /ac-repair-services/ac-not-cooling/ (ID: 124)
+...
+
+Note: Parent-child relationships preserved
+Note: URLs unchanged
+Note: SEO metadata updated
+```
+
+## Deployment Report
+
+**Generated File**: `generated-content/hub-1/deployment-report.md`
+
+```markdown
+# Deployment Report - Hub 1
+
+## Summary
+- Deployment time: 3 minutes
+- Pages created: 41
+- Pages failed: 0
+- WordPress URL: http://localhost:8080
+
+## Pages Deployed
+
+### Authority Hub
+- Title: AC Repair Services in Atlanta
+- URL: http://localhost:8080/ac-repair-services/
+- ID: 123
+- Status: Published ✓
+
+### Knowledge Pages (15)
+1. AC Not Cooling Troubleshooting
+   URL: .../ac-not-cooling-troubleshooting/
+   ID: 124
+   
+2. AC Refrigerant Leak Repair
+   URL: .../refrigerant-leak-repair/
+   ID: 125
+   
+... [all 15]
+
+### Answer Pages (25)
+1. How much does AC repair cost?
+   URL: .../how-much-ac-repair-cost/
+   ID: 140
+   
+... [all 25]
+
+## Navigation
+- Hub menu created: "Hub 1: AC Repair"
+- Breadcrumbs configured ✓
+
+## SEO
+- Meta titles: 41/41 ✓
+- Meta descriptions: 41/41 ✓
+- Focus keywords: 41/41 ✓
+- Schema markup: 41/41 ✓
+
+## Next Steps
+✓ Hub 1 is live and ready!
+→ View: http://localhost:8080/ac-repair-services/
+→ Next: Deploy Hub 2
+```
+
+## Integration with Other Droids
+
+**Receives from aka-internal-linker**:
+- Content with working HTML links
+- No broken links
+- Ready for deployment
+
+**Provides to aka-seo-optimizer**:
+- Live WordPress URLs
+- Page IDs for optimization
+- Structure for validation
+
+## Success Criteria
+
+✅ All pages deployed successfully
+✅ Parent-child hierarchy correct
+✅ Navigation menus created
+✅ SEO metadata complete
+✅ Schema markup added
+✅ Permalinks configured
+✅ Breadcrumbs working
+✅ Theme active and styled
+✅ All links working
+
+## Notes
+
+- Uses WordPress REST API (requires WordPress 4.7+)
+- Requires app password or basic auth
+- Handles large batch deployments efficiently
+- Preserves existing content when updating
+- Safe to retry on failure
+- Dry run prevents accidental deployments

package/plugin/skills/authority-site-builder/SKILL.md

@@ -0,0 +1,138 @@
+# Authority Site Builder Skill
+
+Build complete authority sites (330+ pages) using the AKA framework when triggered by webhook orders.
+
+## Trigger
+
+This skill activates when receiving a new order webhook with client/business details.
+
+## Input Format
+
+The webhook message contains:
+- **Client name** — who ordered the site
+- **Business name** — the brand name
+- **Niche/industry** — what they do
+- **Target location(s)** — cities, regions, service areas
+- **Primary services/keywords** — main offerings
+- **Domain name** — if provided
+- **Brand guidelines** — colors, tone, preferences
+
+## Workflow
+
+### Step 1: Research Phase
+1. Search for top 5-10 competitors in the niche + location
+2. Extract keyword clusters from competitor sites
+3. Identify service variations and local modifiers
+4. Compile FAQ patterns from Google's "People Also Ask"
+5. Document findings in `research/` folder
+
+### Step 2: Site Architecture
+Generate the full structure targeting **330+ pages**:
+
+```
+Authority Layer (5-10 pages)
+├── Homepage
+├── About
+├── Contact
+├── Main Service Pages (3-5)
+└── Location Hub
+
+Knowledge Layer (50-100 pages)
+├── Service Detail Pages
+├── Industry Guides
+├── How-To Articles
+├── Comparison Pages
+└── Resource Pages
+
+Answer Layer (200-300 pages)
+├── FAQ Pages (grouped by topic)
+├── Location + Service Combos
+├── Long-tail Question Pages
+└── "Near Me" Variants
+```
+
+### Step 3: AKA SEO Wireframe
+For each core page, define:
+- Page title + H1
+- Target keyword (primary + secondary)
+- Meta description template
+- Content sections outline
+- Internal linking targets
+- Schema markup type
+
+### Step 4: Content Plan
+Generate structured output with:
+- Complete page list with URLs
+- Target keywords per page
+- Internal linking map (which pages link to which)
+- Schema markup recommendations
+- Content priority order (build sequence)
+
+### Step 5: Telegram Summary
+Send a summary to Rob on Telegram labeled:
+```
+🏗 Authority Site Builder
+
+New site plan ready for: [Business Name]
+📊 Total pages: [count]
+📍 Locations: [count]
+🎯 Services: [count]
+
+Site map overview:
+- Authority pages: X
+- Knowledge pages: X
+- Answer pages: X
+
+Estimated build time: [X hours/days]
+
+Full plan exported to: [webhook URL]
+```
+
+### Step 6: Export JSON
+POST the complete structured plan to the outbound webhook:
+
+```json
+{
+  "order_id": "unique-id",
+  "client_name": "...",
+  "business_name": "...",
+  "domain": "...",
+  "total_pages": 330,
+  "architecture": {
+    "authority": [...],
+    "knowledge": [...],
+    "answer": [...]
+  },
+  "internal_links": [...],
+  "schema_recommendations": [...],
+  "build_sequence": [...],
+  "created_at": "ISO timestamp"
+}
+```
+
+## Output Files
+
+All work is saved to: `/home/rabih/.openclaw/workspace/authority-sites/[business-slug]/`
+- `research/competitors.md`
+- `research/keywords.md`
+- `research/faqs.md`
+- `architecture/sitemap.json`
+- `architecture/sitemap.md`
+- `content-plan/pages.json`
+- `content-plan/internal-links.json`
+- `export/full-plan.json`
+
+## Outbound Webhook
+
+After completion, POST the full plan JSON to the configured webhook URL.
+The URL will be provided in the system config or order payload.
+
+## Status Updates
+
+Always label messages with: `🏗 Authority Site Builder`
+Send status updates on:
+- Order received
+- Research complete
+- Architecture generated
+- Plan exported
+- Any errors encountered