superpowers-sage:block-refactoring

Refactor ACF Composer blocks with phase-driven migration and drift detection.

13|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/codigodoleo/superpowers-sage --skill superpowers-sage-block-refactoring
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: superpowers-sage:block-refactoring
Source: https://github.com/codigodoleo/superpowers-sage/tree/main/skills/block-refactoring
Command: npx skills add https://github.com/codigodoleo/superpowers-sage --skill superpowers-sage-block-refactoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Refactor ACF Composer blocks without rebuilding from scratch by guiding a structured, phase-driven evolution, including drift detection, CSS coverage analysis, and migration planning.

Core Features & Use Cases

  • Design drift detection, CSS coverage analysis, and variation expansion to modernize blocks without breaking content.
  • Phase-driven migration guidance including design references, asset management, and localization readiness for Sage/Acorn themes.
  • Use Case: teams upgrading legacy blocks to v2 patterns or migrating from v1 to v2 with minimal downtime.

Quick Start

Provide the block's ClassName and slug to start a guided, non-destructive refactor of an existing ACF Composer block.

Frequently Asked Questions about superpowers-sage:block-refactoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is design drift detection in ACF Composer block refactoring?▼

Design drift detection identifies mismatches between current block implementations and enforced design references, reporting variations so you can modernize ACF Composer blocks without rebuilding them from scratch.

How do I start a non-destructive refactor of an existing ACF Composer block?▼

Yes, you can refactor Sage theme blocks with minimal downtime by following guided migration checks, asset management planning, and localization readiness steps that produce production-ready updates.

Can I refactor Sage theme blocks without causing production downtime?▼

Yes, you can refactor Sage theme blocks with minimal downtime by following guided migration checks, asset management planning, and localization readiness steps that produce production-ready updates.

What are the limitations of migrating mixed ACF Composer block scenarios?▼

Migrating mixed ACF Composer scenarios requires handling both legacy v1 patterns and v2 implementations concurrently, enforcing design references and CSS coverage checks to prevent content breakage during the evolution.