wp-orchestrator

WordPress Project Orchestrator

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

See Also: [WORKFLOW.md](./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
2. Use AskUserQuestion tool for project requirements
3. Document brand, pages, features needed

1. Create Todo List
2. Generate comprehensive TodoWrite list
3. Break into phases (Foundation → Content → SEO → Performance → Launch)

1. Plugin Installation Guidance
2. List plugins from recommended-plugins.md
3. Provide installation order

1. Theme Setup
2. Guide through theme installation
3. Configure initial settings

1. ASE Configuration
2. Apply security settings
3. Configure white labeling

Site Audit

When user says: "Audit this WordPress site"

1. **Run All Audits in Pa