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.