@lebtiga/sonic-agent 1.0.0

package/plugin/sops/SOP-WORDPRESS-330-PAGE-SITES.md

@@ -0,0 +1,926 @@
+# SOP: Building 330+ Page WordPress Sites with AI
+
+**Version:** 1.0  
+**Created:** February 3, 2026  
+**Author:** Rabih's Team  
+**Delivery Time:** 1-2 weeks  
+**Price Point:** $750
+
+---
+
+## Overview
+
+This SOP guides you through building a 330+ page WordPress website for any local service business using AI-powered content generation. The system creates:
+
+| Page Type | Typical Count | Purpose |
+|-----------|---------------|---------|
+| Programmatic SEO Pages | ~130 | Location pages, service+city pages, FAQs, comparisons |
+| AKA Authority Pages | ~200 | Treatment/service guides with knowledge + Q&A content |
+| **Total** | **~330** | Comprehensive topical authority |
+
+---
+
+## What You Need From the Client
+
+### Required (Minimum)
+1. **Google My Business (GMB) Link** - This gives you:
+   - Business name
+   - Address/location
+   - Service area
+   - Business category
+   - Phone number
+   - Hours
+
+### Nice to Have
+- Logo (or we generate one)
+- Brand colors (or we choose elegant defaults)
+- List of services with prices
+- Competitor names
+- Any specific content/messaging preferences
+
+---
+
+## Phase 1: Server Setup (First Time Only)
+
+### Option A: Virtual Private Server (VPS) - RECOMMENDED
+Recommended: DigitalOcean, Linode, or Vultr ($6-12/month)
+
+```bash
+# Connect to your VPS
+ssh root@your-server-ip
+
+# Update system
+apt update && apt upgrade -y
+
+# Install Docker
+apt install docker.io docker-compose -y
+
+# Install Node.js
+curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
+apt install nodejs -y
+
+# Install OpenClaw
+npm install -g openclaw
+
+# Configure OpenClaw (follow prompts - you'll need Anthropic API key)
+openclaw configure
+
+# Install tmux for persistent sessions
+apt install tmux -y
+```
+
+### Option B: Local Machine (Mac/Linux)
+Same commands, but use `sudo` where needed.
+
+---
+
+## Phase 1.5: Working with OpenClaw TUI (Your AI Editor)
+
+The OpenClaw TUI (Terminal UI) is your AI-powered editor. It's how you'll build everything.
+
+### Connecting to Work
+```bash
+# SSH into your server
+ssh user@your-server-ip
+
+# Start a tmux session (keeps running if you disconnect)
+tmux new -s wordpress-builds
+
+# Navigate to project folder
+cd ~/projects/clientname
+
+# Launch OpenClaw TUI
+openclaw tui
+```
+
+### Using the TUI
+Once inside OpenClaw TUI:
+- **Type naturally** - "Create a WordPress theme for a dental practice with blue and white colors"
+- **It can read/edit files** - "Read the functions.php and add a custom post type for locations"
+- **It can run commands** - "Start the Docker containers"
+- **It remembers context** - Keep chatting, it knows what you're working on
+
+### Example Workflow in TUI
+```
+You: "I'm building a site for Johnson Dental in Chicago. 
+      They do cleanings ($150), whitening ($400), implants ($3000), 
+      crowns ($1200), and emergency visits ($250).
+      Service area is 20 miles around Chicago."
+
+AI: [Creates brand config, sets up theme, generates pages...]
+
+You: "Generate the 130 SEO pages"
+
+AI: [Runs the generator, creates all location + service pages...]
+
+You: "Now create the AKA authority pages for each service"
+
+AI: [Generates 200 educational pages...]
+```
+
+### Reconnecting to Work
+```bash
+# If you disconnected, reconnect to your session
+ssh user@your-server-ip
+tmux attach -t wordpress-builds
+
+# You're back where you left off!
+```
+
+### Multiple Projects
+```bash
+# Create separate tmux sessions per client
+tmux new -s client-johnson-dental
+tmux new -s client-smith-hvac
+
+# Switch between them
+tmux switch -t client-johnson-dental
+
+# List all sessions
+tmux ls
+```
+
+### Keyboard Shortcuts (tmux)
+| Keys | Action |
+|------|--------|
+| `Ctrl+B, D` | Detach (leave session running) |
+| `Ctrl+B, C` | New window |
+| `Ctrl+B, N` | Next window |
+| `Ctrl+B, P` | Previous window |
+| `Ctrl+B, [` | Scroll mode (q to exit) |
+
+---
+
+## Phase 2: Project Setup
+
+### Step 2.1: Create Project Directory
+```bash
+# Replace CLIENT_NAME with actual client name (lowercase, no spaces)
+CLIENT_NAME="clientname"
+PROJECT_DIR="$HOME/projects/$CLIENT_NAME"
+
+mkdir -p $PROJECT_DIR
+cd $PROJECT_DIR
+```
+
+### Step 2.2: Create Docker Configuration
+
+Create `docker-compose.yml`:
+```yaml
+version: '3.8'
+
+services:
+  wordpress:
+    image: wordpress:latest
+    container_name: ${CLIENT_NAME}-wordpress
+    ports:
+      - "8080:80"
+    environment:
+      WORDPRESS_DB_HOST: db
+      WORDPRESS_DB_USER: wordpress
+      WORDPRESS_DB_PASSWORD: wordpress
+      WORDPRESS_DB_NAME: wordpress
+    volumes:
+      - ./wp-content:/var/www/html/wp-content
+      - ./.htaccess:/var/www/html/.htaccess
+    depends_on:
+      - db
+
+  db:
+    image: mariadb:latest
+    container_name: ${CLIENT_NAME}-db
+    environment:
+      MYSQL_ROOT_PASSWORD: rootpassword
+      MYSQL_DATABASE: wordpress
+      MYSQL_USER: wordpress
+      MYSQL_PASSWORD: wordpress
+    volumes:
+      - db_data:/var/lib/mysql
+
+  phpmyadmin:
+    image: phpmyadmin:latest
+    container_name: ${CLIENT_NAME}-phpmyadmin
+    ports:
+      - "8081:80"
+    environment:
+      PMA_HOST: db
+      MYSQL_ROOT_PASSWORD: rootpassword
+
+volumes:
+  db_data:
+```
+
+Create `.htaccess`:
+```apache
+# BEGIN WordPress
+<IfModule mod_rewrite.c>
+RewriteEngine On
+RewriteBase /
+RewriteRule ^index\.php$ - [L]
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule . /index.php [L]
+</IfModule>
+# END WordPress
+```
+
+### Step 2.3: Start WordPress
+```bash
+docker compose up -d
+
+# Wait 30 seconds for startup
+sleep 30
+
+# Verify running
+docker ps
+```
+
+Access points:
+- WordPress: http://localhost:8080 (or http://YOUR_SERVER_IP:8080)
+- phpMyAdmin: http://localhost:8081
+
+### Step 2.4: Complete WordPress Install
+1. Go to WordPress URL
+2. Select language
+3. Fill in:
+   - Site Title: [Client Business Name]
+   - Username: admin
+   - Password: (generate strong password, save it)
+   - Email: (your email)
+4. Click "Install WordPress"
+5. Log in
+
+### Step 2.5: Configure Permalinks
+1. Go to Settings → Permalinks
+2. Select "Post name" (`/%postname%/`)
+3. Save Changes
+
+---
+
+## Phase 3: Gather Business Information
+
+### Step 3.1: Extract from GMB
+Visit the client's GMB profile and note:
+
+```
+Business Name: ________________________
+Address: ________________________
+City: ________________________
+State: ________________________
+Zip: ________________________
+Phone: ________________________
+Category: ________________________
+Service Area Cities: ________________________
+```
+
+### Step 3.2: Research Services
+From GMB, website (if exists), or client:
+
+| # | Service Name | Price | Duration |
+|---|--------------|-------|----------|
+| 1 | | $ | |
+| 2 | | $ | |
+| 3 | | $ | |
+| 4 | | $ | |
+| 5 | | $ | |
+
+**Tip:** 5 core services is ideal. More is fine but keep it focused.
+
+### Step 3.3: Identify Target Cities
+List all cities within the service area (typically 15-25 mile radius):
+
+```
+1. [Main City - HQ]
+2. 
+3. 
+4. 
+5. 
+... (aim for 15-20 cities)
+```
+
+**Tip:** Use Google Maps to find nearby cities. Include suburbs and neighboring towns.
+
+### Step 3.4: Create Brand Configuration
+
+Create `BRAND.md` in project folder:
+```markdown
+# Brand Configuration
+
+## Business Info
+- **Name:** [Business Name]
+- **Tagline:** [Create compelling tagline]
+- **Location:** [City, State]
+- **Phone:** [Phone]
+- **Email:** [Email]
+
+## Services
+1. [Service 1] - $[Price]
+2. [Service 2] - $[Price]
+3. [Service 3] - $[Price]
+4. [Service 4] - $[Price]
+5. [Service 5] - $[Price]
+
+## Target Cities (within [X] mile radius)
+[City 1], [City 2], [City 3], ...
+
+## Brand Colors
+- Primary: #[hex] (accent color)
+- Secondary: #[hex] (background)
+- Dark: #1a1a1a (text)
+- White: #ffffff
+
+## Fonts
+- Headings: [Font Name]
+- Body: [Font Name]
+
+## Competitors
+1. [Competitor 1]
+2. [Competitor 2]
+3. [Competitor 3]
+
+## Unique Value Proposition
+[What makes this business different?]
+```
+
+---
+
+## Phase 4: Theme Development
+
+### Step 4.1: Create Theme Structure
+```bash
+cd $PROJECT_DIR/wp-content/themes
+mkdir -p clientname-theme/{assets/{css,js,images},inc,template-parts,seo-data}
+cd clientname-theme
+```
+
+### Step 4.2: Create style.css
+```css
+/*
+Theme Name: [Client Name] Theme
+Theme URI: https://[domain].com
+Author: Your Agency
+Description: Custom theme with programmatic SEO
+Version: 1.0.0
+Text Domain: clientname
+*/
+
+:root {
+    --primary: #[primary-color];
+    --secondary: #[secondary-color];
+    --dark: #1a1a1a;
+    --light: #f8f8f8;
+    --white: #ffffff;
+}
+
+/* Base styles here */
+```
+
+### Step 4.3: Use AI to Build Theme
+
+With OpenClaw or your AI assistant, provide:
+1. The BRAND.md content
+2. Request: "Build a complete WordPress theme with this brand"
+
+The AI should create:
+- functions.php (post types, menus, scripts)
+- header.php (navigation, logo)
+- footer.php (links, contact info)
+- front-page.php (homepage sections)
+- page.php (standard pages)
+- Template parts for homepage sections
+- Custom CSS with brand colors
+- JavaScript for animations (optional GSAP)
+
+### Step 4.4: Create SEO Data Files
+
+**seo-data/locations.json:**
+```json
+{
+  "locations": [
+    {
+      "city": "Main City",
+      "slug": "main-city",
+      "state": "State",
+      "zip": "12345",
+      "distance": "0 miles",
+      "description": "Our headquarters in Main City..."
+    },
+    {
+      "city": "Nearby Town",
+      "slug": "nearby-town",
+      "state": "State", 
+      "zip": "12346",
+      "distance": "5 miles",
+      "description": "Serving Nearby Town residents..."
+    }
+  ]
+}
+```
+
+**seo-data/services.json:**
+```json
+{
+  "services": [
+    {
+      "name": "Service Name",
+      "slug": "service-name",
+      "price": 100,
+      "duration": "60 minutes",
+      "short_description": "Brief description...",
+      "full_description": "Detailed description...",
+      "benefits": [
+        "Benefit 1",
+        "Benefit 2",
+        "Benefit 3"
+      ]
+    }
+  ]
+}
+```
+
+**seo-data/faqs.json:**
+```json
+{
+  "faqs": [
+    {
+      "question": "What is [service]?",
+      "slug": "what-is-service",
+      "answer": "Detailed answer...",
+      "category": "general"
+    }
+  ]
+}
+```
+
+**seo-data/competitors.json:**
+```json
+{
+  "competitors": [
+    {
+      "name": "Competitor Name",
+      "slug": "competitor-name",
+      "description": "Brief description of competitor"
+    }
+  ]
+}
+```
+
+---
+
+## Phase 5: Programmatic SEO Pages (130 pages)
+
+### Step 5.1: Register Custom Post Types
+
+Add to `functions.php` or `inc/programmatic-seo.php`:
+
+```php
+<?php
+// Location Pages
+register_post_type('location_page', [
+    'labels' => ['name' => 'Location Pages'],
+    'public' => true,
+    'has_archive' => true,
+    'rewrite' => ['slug' => 'locations'],
+    'supports' => ['title', 'editor', 'thumbnail'],
+    'show_in_menu' => true,
+]);
+
+// Service + Location Pages
+register_post_type('service_location', [
+    'labels' => ['name' => 'Service Locations'],
+    'public' => true,
+    'has_archive' => false,
+    'rewrite' => ['slug' => '/', 'with_front' => false],
+    'supports' => ['title', 'editor', 'thumbnail'],
+]);
+
+// FAQ Pages
+register_post_type('faq_page', [
+    'labels' => ['name' => 'FAQ Pages'],
+    'public' => true,
+    'has_archive' => true,
+    'rewrite' => ['slug' => 'learn'],
+    'supports' => ['title', 'editor'],
+]);
+
+// Comparison Pages
+register_post_type('comparison_page', [
+    'labels' => ['name' => 'Comparisons'],
+    'public' => true,
+    'has_archive' => true,
+    'rewrite' => ['slug' => 'compare'],
+    'supports' => ['title', 'editor'],
+]);
+```
+
+### Step 5.2: Create Page Generator
+
+Create `generate-seo.php` in theme root:
+
+```php
+<?php
+/**
+ * SEO Page Generator
+ * Access: /wp-content/themes/[theme]/generate-seo.php
+ */
+require_once($_SERVER['DOCUMENT_ROOT'] . '/wp-load.php');
+
+// Load data
+$locations = json_decode(file_get_contents(__DIR__ . '/seo-data/locations.json'), true)['locations'];
+$services = json_decode(file_get_contents(__DIR__ . '/seo-data/services.json'), true)['services'];
+$faqs = json_decode(file_get_contents(__DIR__ . '/seo-data/faqs.json'), true)['faqs'];
+$competitors = json_decode(file_get_contents(__DIR__ . '/seo-data/competitors.json'), true)['competitors'];
+
+$created = 0;
+
+// Generate Location Pages
+foreach ($locations as $loc) {
+    if (!get_page_by_path($loc['slug'], OBJECT, 'location_page')) {
+        wp_insert_post([
+            'post_title' => BUSINESS_NAME . ' in ' . $loc['city'],
+            'post_name' => $loc['slug'],
+            'post_content' => generate_location_content($loc),
+            'post_status' => 'publish',
+            'post_type' => 'location_page',
+        ]);
+        $created++;
+    }
+}
+
+// Generate Service + Location Pages
+foreach ($services as $svc) {
+    foreach ($locations as $loc) {
+        $slug = $svc['slug'] . '-' . $loc['slug'];
+        if (!get_page_by_path($slug, OBJECT, 'service_location')) {
+            wp_insert_post([
+                'post_title' => $svc['name'] . ' in ' . $loc['city'],
+                'post_name' => $slug,
+                'post_content' => generate_service_location_content($svc, $loc),
+                'post_status' => 'publish',
+                'post_type' => 'service_location',
+            ]);
+            $created++;
+        }
+    }
+}
+
+// Generate FAQ Pages
+foreach ($faqs as $faq) {
+    if (!get_page_by_path($faq['slug'], OBJECT, 'faq_page')) {
+        wp_insert_post([
+            'post_title' => $faq['question'],
+            'post_name' => $faq['slug'],
+            'post_content' => generate_faq_content($faq),
+            'post_status' => 'publish',
+            'post_type' => 'faq_page',
+        ]);
+        $created++;
+    }
+}
+
+// Generate Comparison Pages
+foreach ($competitors as $comp) {
+    $slug = 'vs-' . $comp['slug'];
+    if (!get_page_by_path($slug, OBJECT, 'comparison_page')) {
+        wp_insert_post([
+            'post_title' => BUSINESS_NAME . ' vs ' . $comp['name'],
+            'post_name' => $slug,
+            'post_content' => generate_comparison_content($comp),
+            'post_status' => 'publish',
+            'post_type' => 'comparison_page',
+        ]);
+        $created++;
+    }
+}
+
+echo "Created $created SEO pages!";
+flush_rewrite_rules();
+```
+
+### Step 5.3: Run Generator
+```bash
+# Access in browser:
+http://localhost:8080/wp-content/themes/[theme]/generate-seo.php
+```
+
+### Step 5.4: Create Hub Pages
+
+In WordPress Admin, create these pages:
+1. **Areas We Serve** (slug: `areas-we-serve`) - links to all location pages
+2. **All Services** (slug: `all-services`) - links to all service pages
+3. **Learn** (slug: `learn`) - links to all FAQ pages
+4. **Compare** (slug: `compare`) - links to all comparison pages
+
+---
+
+## Phase 6: AKA Framework Pages (200 pages)
+
+### What is AKA?
+- **A**uthority Pages (5): Main pillar content / treatment guides
+- **K**nowledge Pages (75): Educational supporting content
+- **A**nswer Pages (120+): Specific Q&A targeting long-tail keywords
+
+### Step 6.1: Plan Authority Hubs
+
+For each main service, create an Authority Hub:
+
+| Service | Authority Hub URL | Knowledge Topics | Answer Questions |
+|---------|-------------------|------------------|------------------|
+| Service 1 | /service-1-guide/ | 15 topics | ~25 questions |
+| Service 2 | /service-2-guide/ | 15 topics | ~25 questions |
+| Service 3 | /service-3-guide/ | 15 topics | ~25 questions |
+| Service 4 | /service-4-guide/ | 15 topics | ~25 questions |
+| Service 5 | /service-5-guide/ | 15 topics | ~25 questions |
+
+### Step 6.2: Create AKA Strategy
+
+Use AI to generate content strategy. Provide:
+- Business info from BRAND.md
+- Request 15 knowledge topics per service
+- Request 20-25 answer questions per knowledge topic area
+
+### Step 6.3: Generate AKA Pages
+
+Create `generate-aka.php`:
+
+```php
+<?php
+/**
+ * AKA Framework Page Generator
+ */
+require_once($_SERVER['DOCUMENT_ROOT'] . '/wp-load.php');
+
+$aka_strategy = json_decode(file_get_contents(__DIR__ . '/aka-config/aka-strategy.json'), true);
+
+foreach ($aka_strategy['authority_hubs'] as $hub) {
+    // Create Authority (parent) page
+    $authority_id = wp_insert_post([
+        'post_title' => $hub['title'],
+        'post_name' => $hub['slug'],
+        'post_content' => $hub['content'],
+        'post_status' => 'publish',
+        'post_type' => 'page',
+    ]);
+    
+    // Create Knowledge (child) pages
+    foreach ($hub['knowledge_pages'] as $knowledge) {
+        $knowledge_id = wp_insert_post([
+            'post_title' => $knowledge['title'],
+            'post_name' => $knowledge['slug'],
+            'post_content' => $knowledge['content'],
+            'post_status' => 'publish',
+            'post_type' => 'page',
+            'post_parent' => $authority_id,
+        ]);
+        
+        // Create Answer (grandchild) pages
+        foreach ($knowledge['answer_pages'] as $answer) {
+            wp_insert_post([
+                'post_title' => $answer['title'],
+                'post_name' => $answer['slug'],
+                'post_content' => $answer['content'],
+                'post_status' => 'publish',
+                'post_type' => 'page',
+                'post_parent' => $knowledge_id,
+            ]);
+        }
+    }
+}
+
+echo "AKA pages generated!";
+flush_rewrite_rules();
+```
+
+### Step 6.4: Run Generator
+```bash
+http://localhost:8080/wp-content/themes/[theme]/generate-aka.php
+```
+
+---
+
+## Phase 7: Internal Linking & Navigation
+
+### Step 7.1: Update Header Navigation
+```
+[Logo] [Services ▼] [Guides ▼] [Locations] [Learn] [Contact]
+           |             |
+           |             +-- Guide 1
+           |             +-- Guide 2
+           |             +-- Guide 3
+           |             +-- Guide 4
+           |             +-- Guide 5
+           |
+           +-- Service 1
+           +-- Service 2
+           +-- Service 3
+           +-- Service 4
+           +-- Service 5
+```
+
+### Step 7.2: Update Footer
+Include sections for:
+- Service links
+- Location links (popular cities)
+- Guide links
+- Company info
+- Contact info
+
+### Step 7.3: Verify Internal Linking
+Check that:
+- Every page is reachable within 3 clicks from homepage
+- Hub pages link to all child pages
+- Child pages link back to hubs
+- Related content links exist
+
+---
+
+## Phase 8: Quality Checks
+
+### Step 8.1: Page Count Verification
+```
+Target:
+- Location Pages: ~18
+- Service+Location: ~90 (services × locations)
+- FAQ Pages: ~17
+- Comparison Pages: ~5
+- AKA Authority: 5
+- AKA Knowledge: ~75
+- AKA Answer: ~120
+
+Total: ~330 pages
+```
+
+### Step 8.2: Test Key Pages
+- [ ] Homepage loads correctly
+- [ ] All navigation links work
+- [ ] Hub pages display child links
+- [ ] Individual pages have proper content
+- [ ] Mobile responsive
+- [ ] Images load (or placeholders)
+
+### Step 8.3: SEO Verification
+- [ ] Each page has unique title
+- [ ] Meta descriptions present
+- [ ] H1 tags correct
+- [ ] Internal links functioning
+- [ ] No 404 errors
+
+---
+
+## Phase 9: Export & Delivery
+
+### Step 9.1: Export Database
+```bash
+docker exec ${CLIENT_NAME}-db mysqldump -u wordpress -pwordpress wordpress > ${CLIENT_NAME}-database.sql
+```
+
+### Step 9.2: Create URL-Replaced Database
+```bash
+# Replace localhost with client domain
+sed 's|http://localhost:8080|https://clientdomain.com|g' ${CLIENT_NAME}-database.sql > ${CLIENT_NAME}-database-production.sql
+```
+
+### Step 9.3: Zip Theme
+```bash
+cd wp-content/themes
+zip -r ${CLIENT_NAME}-theme.zip ${CLIENT_NAME}-theme/
+```
+
+### Step 9.4: Create Delivery Package
+```
+delivery/
+├── ${CLIENT_NAME}-database-production.sql
+├── ${CLIENT_NAME}-theme.zip
+├── INSTALL-INSTRUCTIONS.md
+└── login-credentials.txt
+```
+
+### Step 9.5: Installation Instructions
+```markdown
+# Installation Instructions
+
+## 1. Upload Theme
+1. Go to wp-admin → Appearance → Themes
+2. Click "Add New" → "Upload Theme"
+3. Upload ${CLIENT_NAME}-theme.zip
+4. Activate the theme
+
+## 2. Import Database
+Option A: phpMyAdmin
+1. Go to phpMyAdmin
+2. Select your database
+3. Click Import
+4. Upload ${CLIENT_NAME}-database-production.sql
+
+Option B: Command Line
+```bash
+mysql -u username -p database_name < ${CLIENT_NAME}-database-production.sql
+```
+
+## 3. Update wp-config.php
+Make sure database credentials match your hosting.
+
+## 4. Flush Permalinks
+1. Go to Settings → Permalinks
+2. Don't change anything, just click Save
+
+## 5. Verify
+- Visit homepage
+- Check a few pages
+- Test navigation
+```
+
+---
+
+## Phase 10: Hosting Setup (If Managing)
+
+### Option A: Client's Existing Hosting
+Provide the delivery package and instructions.
+
+### Option B: We Set Up Hosting (SiteGround Recommended)
+1. Purchase hosting plan for client
+2. Point domain to SiteGround
+3. Install WordPress via Site Tools
+4. Upload theme
+5. Import database
+6. Configure SSL
+7. Test thoroughly
+
+---
+
+## Checklist Summary
+
+### Pre-Build
+- [ ] GMB link received
+- [ ] Business info extracted
+- [ ] Services and prices confirmed
+- [ ] Target cities identified
+- [ ] Brand colors/fonts decided
+
+### Build
+- [ ] Docker environment running
+- [ ] WordPress installed
+- [ ] Theme created with brand
+- [ ] SEO data files created
+- [ ] 130 programmatic SEO pages generated
+- [ ] 200 AKA pages generated
+- [ ] Navigation updated
+- [ ] Footer updated
+- [ ] All links verified
+
+### Delivery
+- [ ] Database exported with production URLs
+- [ ] Theme zipped
+- [ ] Installation instructions created
+- [ ] Client credentials documented
+- [ ] Delivery package sent
+
+---
+
+## Time Estimates
+
+| Phase | Time |
+|-------|------|
+| Server/Project Setup | 30 min |
+| Gather Info & Research | 1-2 hrs |
+| Theme Development | 2-3 hrs |
+| SEO Data Creation | 1-2 hrs |
+| Page Generation | 30 min |
+| QA & Testing | 1-2 hrs |
+| Export & Package | 30 min |
+| **Total** | **6-10 hours** |
+
+With practice, this can be done in **4-6 hours**.
+
+---
+
+## Common Issues & Solutions
+
+### Pages Show 404
+→ Flush permalinks: Settings → Permalinks → Save
+
+### Docker Won't Start
+→ Check if port 8080 is in use: `lsof -i :8080`
+
+### Database Import Fails
+→ Increase max upload in php.ini or split SQL file
+
+### Images Missing
+→ Check image paths in database, use placeholder service
+
+### Slow Site
+→ Install caching plugin, optimize images
+
+---
+
+## Notes
+
+- Always test on staging before production
+- Keep backups of everything
+- Document any customizations
+- Client communication is key
+
+---
+
+*Created for [Your Agency Name]*  
+*Version 1.0 - February 2026*