wp-orchestrator

name	wp-orchestrator
description	Master WordPress project orchestrator - coordinates all WordPress skills for complete site setup, audit, and optimization. Use for new project setup, site audits, or comprehensive reviews. Runs interview phases and manages todo lists.
allowed-tools	Read, Write, Edit, Bash, Task, Glob, Grep, WebFetch, AskUserQuestion, TodoWrite

WordPress Project Orchestrator

Master skill that coordinates all WordPress development skills for comprehensive project management.

See Also: WORKFLOW.md - Complete end-to-end development workflow documentation

Quick Start Slash Commands

Command	Purpose
/wp-setup	Set up a new WordPress site with Docker, plugins, white-labeling
/wp-audit	Run comprehensive site audit (SEO, visual, performance, security)
/wp-launch	Pre-launch checklist and handoff documentation

Complete Development Lifecycle

1. Discovery & Branding → 2. Environment Setup → 3. Theme Development
       ↓                        ↓                       ↓
   brand-guide              wp-docker              wordpress-dev
                                                   gsap-animations
       ↓                        ↓                       ↓
4. Content & SEO → 5. Testing & QA → 6. Packaging & Deploy
       ↓                 ↓                    ↓
  wordpress-admin    visual-qa           GitHub + WP Pusher
  seo-optimizer      form-testing        demo-content.json
                     E2E tests           theme zip
       ↓                 ↓                    ↓
7. White-Label → 8. Client Handoff
       ↓                 ↓
  white-label       Documentation
  ASE + Branda      Training

Environment Detection

The orchestrator automatically detects your WordPress environment:

Docker Environment

# Check for docker-compose.yml with WordPress
if [ -f docker-compose.yml ] && grep -q wordpress docker-compose.yml; then
    echo "Docker WordPress detected"
fi

# Check running containers
docker ps | grep wordpress

WordPress Playground

# Check for Playground blueprints
if [ -f blueprint.json ] || [ -d blueprints/ ]; then
    echo "Playground environment detected"
fi

# Run Playground with blueprint
npx @wp-playground/cli server --blueprint=./blueprint.json

Standard WordPress

# Check for wp-config.php
if [ -f wp-config.php ]; then
    echo "Standard WordPress installation detected"
fi

Available Skills

Skill	Purpose	Use When
wordpress-dev	Coding standards, CPT, security, performance	Writing WordPress code
wordpress-admin	Site management, WP-CLI, REST API	Managing content, settings
seo-optimizer	Yoast/Rank Math audit, keywords, meta	SEO review and fixes
visual-qa	Screenshot testing, responsive QA	After CSS/template changes
brand-guide	Brand documentation	Starting new project
white-label	Admin branding with ASE + Branda	Client site setup
gsap-animations	GSAP best practices, accessibility	Implementing animations
wp-performance	Speed optimization, Core Web Vitals	Performance issues
wp-docker	Docker Compose environment	Local development
wp-playground	WordPress Playground blueprints	Testing and demos

---

Project Phases

Phase 1: Discovery Interview

Ask the user these questions to understand the project:

## Project Discovery

1. **Project Type**
   - New site build?
   - Existing site optimization?
   - Site audit?
   - Specific feature implementation?

2. **Site Information**
   - URL (staging/production)
   - WordPress version
   - Theme (custom, child, builder?)
   - Hosting environment (Docker local, shared, VPS, managed?)

3. **Requirements**
   - What pages are needed?
   - Custom post types?
   - Forms (contact, inquiry)?
   - E-commerce?
   - Multilingual?

4. **Brand**
   - Do you have brand guidelines?
   - Logo files available?
   - Color palette defined?
   - Typography chosen?

5. **SEO Requirements**
   - Focus keywords identified?
   - Existing content to optimize?
   - Google Analytics/Search Console connected?

6. **Performance Goals**
   - Target PageSpeed score?
   - Core Web Vitals requirements?
   - CDN preferences?

7. **Client Handoff**
   - Need white-labeled admin?
   - Training documentation needed?
   - Which admin features to expose?

Phase 2: Initial Audit

Run these checks on existing sites:

Plugin Check

# Via WP-CLI in Docker
docker exec wordpress-container wp plugin list --format=table

# Check for required plugins
REQUIRED="admin-site-enhancements litespeed-cache wordpress-seo ewww-image-optimizer"

SEO Audit

# Run SEO optimizer
python3 /root/.claude/skills/seo-optimizer/audit.py --base-url https://site.com --json

Visual QA

# Take screenshots of all pages
python3 /root/.claude/skills/visual-qa/screenshot.py --all --base-url https://site.com

Performance Check

# Check PageSpeed (requires API key or use web tool)
curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://site.com&strategy=mobile"

Phase 3: Todo List Generation

Based on audit results, generate comprehensive todo list:

## Site Setup Checklist

### Foundation
- [ ] WordPress core updated
- [ ] Theme installed and configured
- [ ] Child theme created (if needed)
- [ ] Required plugins installed

### Plugins to Install
- [ ] Admin and Site Enhancements (ASE) - Admin cleanup, security
- [ ] Branda - White labeling, login customization
- [ ] LiteSpeed Cache - Performance
- [ ] Yoast SEO - SEO optimization
- [ ] WP Mail SMTP - Email delivery
- [ ] Solid Security - Additional security
- [ ] EWWW Image Optimizer - Image compression
- [ ] WP Activity Log - Audit logging
- [ ] Site Kit by Google - Analytics integration
- [ ] ManageWP Worker - Remote management
- [ ] Instant Images - Stock photos
- [ ] Admin Menu Editor - Menu organization (optional)

### Pages to Create
- [ ] Home
- [ ] About
- [ ] Services/Portfolio
- [ ] Contact
- [ ] Privacy Policy
- [ ] Terms of Service

### SEO Setup
- [ ] Focus keyword for each page
- [ ] Meta descriptions (120-160 chars)
- [ ] Featured images with ALT text
- [ ] XML sitemap generated
- [ ] Robots.txt configured
- [ ] Google Search Console connected

### Performance
- [ ] Image optimization configured
- [ ] Caching enabled
- [ ] CDN configured
- [ ] Lazy loading enabled
- [ ] Minification enabled
- [ ] PageSpeed score >80

### Security
- [ ] Login URL changed
- [ ] XML-RPC disabled
- [ ] 2FA enabled for admins
- [ ] Automatic updates configured
- [ ] Backup solution in place

### White Label (Client Sites) - Using white-label skill
- [ ] Login page customized (Branda: logo, colors, background)
- [ ] Admin bar branded (Branda: hide WP logo, custom logo)
- [ ] "Howdy" replaced (Branda: custom greeting)
- [ ] Admin footer customized (ASE or Branda)
- [ ] Dashboard widgets hidden (ASE)
- [ ] Admin menu organized (Admin Menu Editor)
- [ ] Custom login URL set (ASE: /client-login)
- [ ] XML-RPC disabled (ASE)
- [ ] Author slugs obfuscated (ASE)

### Visual QA
- [ ] Desktop screenshots reviewed
- [ ] Tablet screenshots reviewed
- [ ] Mobile screenshots reviewed
- [ ] Animations working
- [ ] No layout issues
- [ ] Forms functional

### Pre-Launch
- [ ] All pages have content
- [ ] Forms tested
- [ ] 404 page configured
- [ ] Favicon uploaded
- [ ] Social sharing images set
- [ ] Analytics tracking verified

---

Orchestration Commands

New Project Setup

When user says: "Set up a new WordPress project"

1. Run Discovery Interview

   • Use AskUserQuestion tool for project requirements
   • Document brand, pages, features needed

2. Create Todo List

   • Generate comprehensive TodoWrite list
   • Break into phases (Foundation → Content → SEO → Performance → Launch)

3. Plugin Installation Guidance

   • List plugins from recommended-plugins.md
   • Provide installation order

4. Theme Setup

   • Guide through theme installation
   • Configure initial settings

5. ASE Configuration

   • Apply security settings
   • Configure white labeling

Site Audit

When user says: "Audit this WordPress site"

1. Run All Audits in Parallel (using Task tool with Haiku agents)

   • SEO audit agent
   • Visual QA agent
   • Performance check agent
   • Security review agent

2. Compile Results

   • Aggregate findings
   • Prioritize issues

3. Generate Action Plan

   • Create TodoWrite list of fixes
   • Estimate effort (simple/moderate/complex)

Performance Optimization

When user says: "Optimize site performance"

1. Baseline Measurement

   • Run PageSpeed test
   • Record current scores

2. Image Audit

   • Check image sizes
   • Identify unoptimized images

3. Caching Configuration

   • Configure LiteSpeed Cache
   • Set up browser caching

4. Asset Optimization

   • Review CSS/JS loading
   • Implement deferring

5. Re-test

   • Run PageSpeed again
   • Compare results

---

Parallel Agent Patterns

Multi-Page Audit

# Launch parallel Haiku agents for page audits
agents = [
    Task(subagent_type="Explore", prompt="Audit home page SEO and visual state"),
    Task(subagent_type="Explore", prompt="Audit about page SEO and visual state"),
    Task(subagent_type="Explore", prompt="Audit portfolio page SEO and visual state"),
    Task(subagent_type="Explore", prompt="Audit contact page SEO and visual state"),
]
# Run all in parallel using model="haiku"

Full Site Review

# Parallel skill execution
agents = [
    Task(prompt="Run SEO audit using seo-optimizer skill", model="haiku"),
    Task(prompt="Take visual QA screenshots using visual-qa skill", model="haiku"),
    Task(prompt="Check performance using wp-performance skill", model="haiku"),
    Task(prompt="Review security using ase-config skill", model="haiku"),
]

---

Interview Templates

Client Kickoff Interview

# Project Kickoff Questions

## Business Understanding
1. What does your business do?
2. Who is your target audience?
3. What are your main competitors?
4. What makes you different?

## Website Goals
1. What is the primary goal of this website?
   - Lead generation
   - E-commerce sales
   - Information/portfolio
   - Brand awareness

2. What actions should visitors take?
3. How will you measure success?

## Content
1. Do you have existing content to migrate?
2. Will you provide content or need copywriting?
3. Do you have professional photos?
4. What pages do you need?

## Design Preferences
1. Any websites you like the look of?
2. Brand colors and fonts established?
3. Logo files available?
4. Design style preference?
   - Minimal
   - Bold
   - Corporate
   - Creative

## Technical Requirements
1. Need any integrations?
   - CRM
   - Email marketing
   - Booking system
   - Payment processing

2. Expected traffic volume?
3. Need multilingual support?
4. Special functionality needed?

## Timeline & Budget
1. Deadline for launch?
2. Ongoing maintenance needed?
3. Budget constraints?

Site Audit Interview

# Site Audit Questions

1. What issues are you experiencing?
2. When did you last update WordPress/plugins?
3. Have you noticed performance problems?
4. Any specific pages with issues?
5. Are you tracking analytics currently?
6. What is your current hosting?
7. Do you have backups configured?
8. Who has admin access?

---

Reporting Templates

Audit Report

# WordPress Site Audit Report

**Site**: [URL]
**Date**: [Date]
**Auditor**: Claude Code

## Executive Summary
[2-3 sentence overview]

## Scores
| Category | Score | Target |
|----------|-------|--------|
| SEO | X/100 | 80+ |
| Performance | X/100 | 80+ |
| Accessibility | X/100 | 90+ |
| Security | X/10 | 10/10 |

## Critical Issues
1. [Issue 1]
2. [Issue 2]

## Recommendations

### High Priority
- [ ] Fix [issue]
- [ ] Implement [feature]

### Medium Priority
- [ ] Optimize [aspect]
- [ ] Configure [setting]

### Low Priority
- [ ] Consider [improvement]

## Next Steps
1. [Action 1]
2. [Action 2]

Handoff Documentation

# Website Handoff Documentation

## Login Information
- **Admin URL**: [URL]/secure-login
- **Username**: [provided separately]
- **Password**: [provided separately]

## How to Edit Content

### Editing Pages
1. Log in to the admin area
2. Click "Pages" in the left menu
3. Find the page you want to edit
4. Click "Edit"
5. Make your changes
6. Click "Update" to save

### Adding Blog Posts
1. Click "Posts" → "Add New"
2. Enter title and content
3. Set featured image
4. Add categories/tags
5. Click "Publish"

### Uploading Images
1. Click "Media" → "Add New"
2. Drop files or click to upload
3. Images are automatically optimized

## SEO Guidelines
- Each page should have a focus keyword
- Meta descriptions should be 120-160 characters
- Featured images should have ALT text

## Support
Contact [Your Agency] at [email] for assistance.

---

Workflow Integration

With Hooks

The orchestrator can trigger other skills automatically:

# Example workflow configuration
on_new_project:
  - run: discovery_interview
  - run: wordpress-dev/scaffold_theme
  - run: ase-config/apply_defaults
  - run: seo-optimizer/initial_setup

on_pre_launch:
  - run: seo-optimizer/audit
  - run: visual-qa/full_site
  - run: wp-performance/speed_test
  - run: generate_report

With Claude Code Slash Commands

# Register as skill
/wp-setup       # Start new project setup
/wp-audit       # Run comprehensive audit
/wp-optimize    # Performance optimization
/wp-seo         # SEO review and fixes
/wp-visual      # Visual QA screenshots

---

Theme Packaging & Distribution

Create Theme Zip

cd /path/to/project

# Remove old zips
rm -f theme-name-*.zip

# Create versioned zip (exclude dev files)
zip -r theme-name-1.0.0.zip theme-name \
  -x "*.git*" \
  -x "*node_modules*" \
  -x "*.DS_Store" \
  -x "*tests/*" \
  -x "*.env*"

Export Demo Content

Before packaging, export current content:

1. WordPress Admin → Theme Settings → Demo Content
2. Click "Export Demo Content"
3. Verify demo-content.json is updated in theme folder

GitHub Repository Setup

cd /path/to/theme

# Initialize and push
git init
git add .
git commit -m "Initial theme release v1.0.0"
gh repo create theme-name --public --source=. --push

# Push updates
git add .
git commit -m "feat: description of changes v1.0.1"
git push origin main

WP Pusher Deployment (Production)

Install WP Pusher on production site:

1. Plugins → Add New → "WP Pusher" → Install & Activate
2. WP Pusher → Install Theme
3. Enter repository: username/theme-name
4. Branch: main
5. Click "Install Theme"

Pull Updates:

• WP Pusher → Themes → Click "Update Theme"

Auto-Deploy (Optional):

1. WP Pusher → Themes → Theme Settings
2. Enable "Push-to-Deploy"
3. Copy webhook URL
4. GitHub repo → Settings → Webhooks → Add webhook
5. Paste URL, select "push" events

---

Demo Content System

What Gets Exported

Data	Source
Pages	Title, content, template, slug
Properties (CPT)	All fields and meta
Yoast SEO	Focus keyword, meta desc, SEO title
Featured Images	URLs for re-download
Theme Options	Custom settings
Reading Settings	Front page config

Import on Fresh Install

1. Activate theme
2. Setup Wizard Step 2: "Import Demo Content"
3. Or: Theme Settings → Demo Content → Import

WP-CLI Export/Import

# Export
docker exec wordpress wp eval "print_r(csr_export_demo_content());" --allow-root

# Trigger import
docker exec wordpress wp eval "csr_import_demo_content();" --allow-root

---

Quick Reference

Common Orchestrator Commands

User Says	Orchestrator Does
"Set up a new WordPress site"	/wp-setup → Discovery interview → Docker/Playground → Install plugins
"Audit this site"	/wp-audit → Run all audit skills in parallel → Compile report
"Optimize performance"	Run wp-performance → Apply fixes
"Check SEO"	Run seo-optimizer → Show issues
"Take screenshots"	Run visual-qa → Analyze results
"White label admin"	Run white-label → Apply ASE + Branda settings
"Prepare for launch"	/wp-launch → Run all checks → Generate handoff docs
"Start Docker WordPress"	Copy wp-docker templates → docker-compose up
"Test in Playground"	Run wp-playground blueprint → Open browser
"Package theme for distribution"	Export demo content → Create zip → Push to GitHub
"Deploy to production"	Setup WP Pusher → Connect GitHub → Pull updates

---

Related Skills

All skills are documented at:

• /root/.claude/skills/wordpress-dev/ - Development best practices
• /root/.claude/skills/wordpress-admin/ - Site management
• /root/.claude/skills/seo-optimizer/ - SEO auditing
• /root/.claude/skills/visual-qa/ - Visual testing
• /root/.claude/skills/brand-guide/ - Brand documentation
• /root/.claude/skills/white-label/ - Admin white-labeling (ASE + Branda)
• /root/.claude/skills/gsap-animations/ - Animation best practices
• /root/.claude/skills/wp-performance/ - Performance optimization
• /root/.claude/skills/wp-docker/ - Docker environment
• /root/.claude/skills/wp-playground/ - WordPress Playground

Slash commands at:

• /root/.claude/commands/wp-setup.md
• /root/.claude/commands/wp-audit.md
• /root/.claude/commands/wp-launch.md

Plugin bundle at:

• /root/.claude/plugins/wordpress-dev-skills/