superpowers-sage

Scaffolds a new ACF field group as a PHP class via Acorn's ACF scaffolding command.

Scaffolds a new Livewire component via the project's create-component script.

Reports Lando health, stack versions, active plan, and design tools for the current Sage project.

User prompt: "Analyze this legacy theme and give me a migration plan to Acorn."

User prompt: "My Livewire SearchBar component renders but doesn't update when I type."

User prompt: "Run the Tailwind v4 auditor on this theme."

Analyzes procedural WordPress theme code (functions.php, inc/ files, classic theme templates) and produces a phased migration plan to Acorn/Sage architecture. Detects register_post_type (migrate to Poet config/poet.php), add_action/add_filter hooks (migrate to Service Provider boot()), global $wpdb queries (migrate to Eloquent models in app/Models/), WP_Query loops (migrate to Eloquent scopes), wp_schedule_event (migrate to Laravel queue jobs via Action Scheduler), register_rest_route (migrate to Acorn Routes routes/web.php), add_shortcode (migrate to Blade component), wp_enqueue_script/style (migrate to Service Provider + Vite), get_template_part (migrate to Blade @include or Blade component). Invoke for: legacy theme migration, acorn migration, refactor WordPress theme, functions.php refactor, classic theme to Sage, Service Provider, Eloquent model, Acorn routes, convert theme to Acorn, wp-to-acorn.

Analyzes block/component content and recommends data modeling; classifies content as static ACF fields, dynamic CPT collections, global Options Pages, or relational content with Poet configuration

Extracts precise design specifications from Paper/Figma/Stitch MCPs or local reference images; produces structured spec files (typography, colors, spacing, SVGs, layout) in two modes — PANORAMIC for full-project token extraction and SURGICAL for per-component deep extraction

HTML Forms + Sage specialist — analyzes existing form implementations (Blade form view, JS validation module, block wiring, CSS hygiene, DOM event handlers) against sage-forms skill patterns, proposes concrete fixes, and applies them atomically behind a single approval gate. Also scaffolds new forms standalone outside block-scaffolding runs. Covers log1x/sage-html-forms integration, hf_get_form, x-form.* components, hf-validation module, and documented traps T1 (pattern backslash escaping), T2 (type=tel Chrome bug), T3 (ValidityState non-enumerable). Invoke for: form refactoring, form audit, form scaffold, sage-html-forms, HTML Forms plugin, contact form review, form validation review.

Diagnoses Livewire components that fail to mount, update, or emit events in Sage/Acorn projects. Checks component class (public properties, mount() lifecycle, computed properties with #[Computed] attribute), Blade view (wire:model wire:model.live wire:click wire:submit bindings, @livewireScripts @livewireStyles injection), CSRF and session middleware (VerifyCsrfToken, web middleware group, 419 errors), network responses to POST /livewire/update (403 404 500), Alpine.js x-data conflicts with wire:ignore, and Livewire v2 vs v3 API differences (emit vs dispatch, wire:model.lazy vs wire:model.live, @entangle syntax). Invoke for: livewire not updating, wire:model broken, livewire mount failed, livewire 419 CSRF error, livewire dispatch emit, alpine livewire conflict, livewire component debug, wire:model.live.

Extracts design specs from Pencil MCP (.pen files); operates in three modes — PANORAMIC for global token extraction from .lib.pen files, SURGICAL for per-section spec production, and COMPONENT_MAP for bridging the Pencil component library to suggested Blade components

Analyzes feature requirements, consults design tools, invokes content modeling, and recommends architecture for Sage/Acorn/Lando projects following stack conventions and opinionated preferences

Diagnoses issues in Sage/Acorn/Lando projects by checking logs, configs, cache, autoload, and service status with knowledge of common pitfalls like Blade cache and OPcache

Reviews Sage/Acorn code against stack conventions, checking providers, hooks, ACF patterns, Blade structure, content modeling decisions, and visual alignment with design reference

Audits Sage/Tailwind v4 projects across five categories: v3-to-v4 syntax migration (tailwind.config.js, theme() calls, @apply overuse), arbitrary value tokenization (text-[px] tracking-[px] max-w-[px] replace with @theme tokens), PHP color-prop resolution (match($tone) Tailwind class strings, tone="fg" prop drilling bypassing CSS variables), CSS variable cascade coverage (block CSS files missing --eyebrow-color --heading-color --decorator-color declarations, hardcoded color utilities on semantic elements), and WP core layer conflict (wp-block-library / global-styles unlayered CSS winning over Tailwind @layer utilities — check for dequeue strategy or @layer wp-core ordering in app.css). Outputs severity-ranked report with dark-mode readiness score. Invoke for: Tailwind audit, v3 to v4 migration, CSS variable cascade, arbitrary values, token coverage, dark mode readiness, tone prop cleanup, Gutenberg specificity conflict, wp-block-library.

Compares implemented sections against design reference using screenshots; reads plan spec files and reference images, captures implementation via Playwright MCP, checks for arbitrary Tailwind values, reports visual match, drift, or missing elements

Creates custom WordPress Abilities for the WP MCP Adapter (WP 6.9+). An Ability is a PHP class extending Roots\AcornAi\Abilities\Ability that exposes a JSON schema and execute() method — auto-discovered by the MCP Adapter and callable via Claude's execute-ability tool. Covers: lando wp acorn make:ability, AbilitiesServiceProvider registration, JSON schema definition, discover-abilities validation. Invoke for: abilities, make ability, custom mcp endpoint, discover-abilities, execute-ability, acorn ability, abilities-authoring, mcp endpoint, wp ability, make:ability.

Acorn CLI commands for WordPress automation — lando acorn make:command, artisan-style commands, Command::class, $signature, $description, handle() method, command arguments and options, output formatting, dependency injection in commands, calling other commands, AppServiceProvider registration, wp acorn schedule:run, scheduled commands, data import scripts, maintenance commands, theme automation tasks, lando acorn list

Eloquent, model, migration, relationship, hasMany, belongsTo, belongsToMany, Acorn Eloquent, custom table, wp_posts, wp_users, wp_postmeta, factory, query scope, scopePublished, global scope, make:model, make:migration, lando acorn migrate, $fillable, $casts, $timestamps, $primaryKey, HasFactory, db:seed, seeder — Eloquent ORM for custom and WordPress tables via Acorn

Livewire v3 in WordPress via Acorn: Livewire component, wire:model, wire:model.live, @livewire directive, reactive component, livewire component, make:livewire, Alpine + Livewire, wire:click, wire:submit, WithFileUploads, computed properties, mount lifecycle, hydrate, Acorn Livewire, roots/acorn-livewire, real-time UI, reactive forms — interactive server-driven UI without writing JavaScript in Sage themes

Logging in Acorn/WordPress — Log::debug(), Log::error(), Log::channel(), custom log channels, daily log files, stack channel, Slack log notifications, exception handling logging, WordPress debug.log integration, WP_DEBUG_LOG, structured logging, context arrays, monolog handlers, log levels, emergency info warning error debug, lando logs, lando ssh tail log

HTTP middleware, JWT authentication, auth middleware, custom guards, JWT guard, route middleware, request filter, middleware group, Acorn middleware, guard, rate limiting, CORS, CheckRole, throttle, bearer token, request filtering, middleware registration, HTTP Kernel — using Acorn's Laravel middleware stack inside WordPress/Sage/Bedrock

Background job processing in WordPress via Acorn: Laravel queue, dispatch, queue:work, ShouldQueue, failed jobs, Action Scheduler, as_schedule_single_action, as_schedule_recurring_action, job retries, backoff, job chaining, job batching, ShouldBeUnique, Acorn queue, Redis queue driver, database queue driver, queue worker, background tasks — using Acorn's Laravel queue stack in Sage/WordPress

Redis caching, sessions, and queue driver in WordPress via Acorn — lando redis-cli, Cache::remember(), Cache::tags(), cache invalidation, WP object cache drop-in, wp_cache_set, wp_cache_get, Redis facade, session driver redis, REDIS_HOST, REDIS_PORT, Lando Redis service, predis, phpredis, queue connection redis, cache tags group invalidation, WP transient replacement, cache hit rate, lando wp cache type, object-cache.php drop-in

Routes, controller, Acorn routes, web.php, route:list, Route::get, Route::post, Route::resource, Route::apiResource, middleware, route model binding, API endpoint, RouteServiceProvider, named routes, resource controller, single-action controller, invokable controller, route group, route prefix, JSON response, rate limiting, token auth, Accept application/json, route cache, WP rewrite conflicts — using Acorn's Laravel routing inside WordPress/Sage/Bedrock

Guided installation of the Roots AI stack (roots/acorn-ai + wordpress/mcp-adapter) in a Sage/Bedrock project via Lando. Runs detect-ai-readiness probe, identifies gaps, installs missing packages, publishes Acorn AI config, writes API key to .env, generates .mcp.json, validates MCP handshake via discover-abilities. Invoke for: ai-setup, install acorn ai, mcp adapter, install mcp, setup mcp, ai stack, discover-abilities not working, wordpress mcp, acorn-ai setup.

Define architecture for a Sage/Acorn feature — architecture decision records, component boundaries, data flow, dependency mapping, pre-implementation design, trade-off analysis, Acorn architecture patterns, ADR, design before building

Architecture discovery for Sage/Acorn projects — map existing codebase, discover post types, routes, ACF field groups, Livewire components, Service Providers, identify architectural gaps, architecture decision records, ADR, component boundary map, data flow diagram, risk register, implementation sequencing, discovery session, understanding unknown codebases, use before architecting or building new features, output contract, discover-abilities

Refactor ACF Composer blocks — evolve blocks along 4 axes: rendering model, field composition, block variants $styles, InnerBlocks adoption; legacy block migration, ACF Composer v2 to v3, block phase classification, atomic vs container, block evolution report, get_block_wrapper_attributes, $styles, $innerBlocks, refactor without breaking existing content, block refactoring report

Scaffold a new ACF Composer block: ACF block, ACF Composer, block registration, Gutenberg block, block view, Blade block, InnerBlocks, block.json, block scaffold, acf:block, custom block, block category, block icon, block supports, block variants, block styles, is-style, create-block, enqueue block, block CSS, block JS, custom element, block preview parity — full custom element architecture with scoped CSS and theme variations.

Build a feature in a Sage/Acorn project — implement from an approved plan, write code, commit, iterate; orchestrates acorn-routes, acorn-livewire, acorn-eloquent, block-scaffolding, acorn-commands; TDD in Sage, implementation phase, commit hygiene, PR creation, incremental delivery, changelog entry, lando acorn, lando yarn build, lando yarn dev

Debug issues in Sage/Acorn/Lando projects — PHP errors, Blade rendering errors, Livewire mount failures, Eloquent query errors, Acorn boot errors, queue job failures, middleware blocking, WP hook conflicts, lando logs, Query Monitor, Xdebug, lando php -r, WP_DEBUG, debug session

Design UI/UX in a Sage project — Figma to Blade, design tokens to Tailwind v4, Paper/Figma MCP integration, component design, layout design, responsive design, design-to-code workflow, visual design review, design system alignment, design approval before implementation

Install WordPress plugins in Bedrock — lando composer require, Bedrock plugin management, composer.json for WP plugins, WP packagist, wpackagist-plugin, mu-plugins vs plugins, Bedrock plugin activation, composer.json repositories, lando wp plugin list, plugin compatibility, roots/wordpress-packagist

WordPress migration to Sage/Acorn — migrate classic theme to Sage, incremental migration, 7-phase migration contract, rollback playbook, migration hard gates, functions.php to Service Providers, shortcodes to Blade, CPT registration to Poet, field groups to ACF Composer, safe migration reversible steps, migration output artifacts, legacy plugin to Acorn, wp-content to Bedrock structure, database migration, content migration

Content modeling for Sage/Bedrock — classify as CPT ACF fields Blade component Livewire component or Options Page, Poet CPT configuration, ACF Composer fields vs GUI, relational content, static vs dynamic, content architecture decisions, config/poet.php, modeling before building, content classification matrix

Onboard to a Sage/Acorn/Lando project — understand project structure, discover CPTs routes field groups Livewire components, lando start, lando info, project orientation, first session setup, read CLAUDE.md, activate skills, understand what exists before building, lando wp post-type list

Generate implementation plans from approved designs — plan-generator, phase-based plans, parallel batch execution, task dependency graph, owner skill routing, acceptance criteria, global done criteria, plan frontmatter, layout contract, interaction contract, anti-drift rules, plan format, AD-2 byte-for-byte gate, scope definition, execution plan, phases and batches, task anatomy, plan file format

Code review for Sage/Acorn projects — review PHP Blade JS CSS, review Service Providers ACF Composer blocks Livewire components, Eloquent models Acorn routes, security review, performance review, code quality, coding standards, PR review workflow, code review checklist

Design system implementation in Sage/Tailwind v4 — Figma to @theme tokens, design tokens CSS, Tailwind v4 @theme, color tokens, typography tokens, spacing scale, Blade UI components, kitchensink page, design-to-code, @layer base @layer components, CSS custom properties, resources/css/app.css, Paper MCP, Figma MCP, design file to code, SVG icons, responsive layout, design system audit, UI component library, atom design, layout components

HTML Forms + Sage integration — log1x/sage-html-forms, hf_get_form, addPostObject html-form, Blade form views, x-form.* shared components, hf-validation JS module, hf-success hf-error hf-submitted events, Constraint Validation API, form traps pattern escaping type-tel ValidityState non-enumerable — stateless contact forms with progressive JS validation on top of the HTML Forms WordPress plugin.

Sage theme with Acorn (Laravel IoC for WordPress) and Lando — lando start, lando info, lando acorn, Service Providers, View Composers, Blade components, ACF Composer blocks and fields, Poet CPT config/poet.php, AppServiceProvider, ViewServiceProvider, resources/views/, resources/css/app.css @theme Tailwind v4, resources/js/app.js, content/themes/{theme}/, lando yarn dev, lando yarn build, Blade @extends @section @include @component, Bedrock directory structure, lando wp, composer require, lando composer

Meta-skill for Sage/Acorn projects — gerund workflow ecosystem, Lando commands, architectural preferences, plan system, design tool integration, skill routing, WordPress MCP Adapter, discover-abilities, execute-ability, mcp-query-patterns, query-first workflow, Acorn, Bedrock, Sage theme, roots ecosystem, when to use which skill — read this first in any Sage/Acorn project session

Verify implemented work meets acceptance criteria — run tests, check PHPCS, validate Blade output, lando phpunit, lando phpcs, lando yarn test, Playwright tests, accessibility check, post-implementation verification, done criteria validation, checklist review, verification phase

Native Gutenberg blocks without ACF — block.json, edit.js, save.js, register_block_type, @wordpress/scripts, block attributes, InnerBlocks, useBlockProps, ServerSideRender, dynamic blocks PHP render_callback, block supports, block.json apiVersion 3, block variations, block styles, block transforms, React in block editor, wp_register_block_script_handle, Vite and WordPress blocks, native block vs ACF Composer block decision, block.json editorScript viewScript, @wordpress/block-editor

WordPress capabilities and roles — add_role, remove_role, add_cap, remove_cap, current_user_can, user_can, WP_Roles, custom capabilities, administrator editor author contributor subscriber, capability mapping, meta capabilities, map_meta_cap, register_post_type capabilities, custom post type capabilities, WP_User roles and caps, ACF field group visibility by role

WP-CLI operations via Lando — lando wp db export, lando wp db import, lando wp search-replace, lando wp search-replace --dry-run, lando wp user create, lando wp post list, lando wp plugin install, database management, maintenance mode, lando wp maintenance-mode activate, lando wp cache flush, lando wp cron event run, lando wp option update, lando wp transient delete, deploy checklist, preflight checks, destructive operations safety

WordPress hooks lifecycle — add_action, add_filter, do_action, apply_filters, remove_action, remove_filter, hook priority, plugins_loaded, init, wp_loaded, after_setup_theme, the_content filter, wp_enqueue_scripts, admin_enqueue_scripts, hook execution order, Acorn hook registration in AppServiceProvider, boot hooks, register hooks, WordPress hook reference, Tailwind CSS filter conflicts, save_post, transition_post_status, pre_get_posts, late hooks, early hooks

WordPress performance optimization: performance, slow query, N+1 query, Query Monitor, autoload audit, autoload options, object cache, Redis, wp_cache, transient, cache invalidation, Core Web Vitals, LCP, CLS, INP, FID, profiling, Xdebug, microtime, pre_get_posts, database query optimization, TTFB, page load, Vite bundle, lazy loading, critical CSS — benchmark before/after, never optimize blind.

PHPStan static analysis in Sage/Acorn projects — lando composer phpstan, phpstan.neon configuration, PHPStan level 0-9, WordPress PHP stubs, szepeviktor/phpstan-wordpress, baseline generation, CI phpstan, suppress errors, type errors, return type mismatch, nullable types, WordPress function stubs, WP_Post WP_Query WP_User types

WordPress REST API — register_rest_route, WP_REST_Controller, WP_REST_Request, REST namespace, custom endpoints, Application Passwords, JWT REST authentication, permission_callback, schema validation, WP_REST_Response, REST API versioning, rest_ensure_response, coexistence with Acorn Routes, register_rest_route vs routes/web.php decision, REST API debugging, wp rest-api namespace list, wp json discovery, CORS, REST nonce, cookie auth, REST API disable, JSON schema validation

WordPress security hardening — nonce verification, wp_nonce_field, check_admin_referer, sanitize_text_field, sanitize_email, esc_html, esc_attr, esc_url, wp_kses, SQL injection prevention, $wpdb->prepare(), capability checks, current_user_can, authentication hardening, wp-config.php secrets, security headers, file permissions, Bedrock .env secrets, disable XML-RPC, brute force wp-login.php, CSRF protection

8 hooks across 7 events