superpowers-sage:debugging

Diagnose Sage, Acorn, and Lando WordPress failures by symptom category.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging Sage/Acorn/Lando projects often gets stuck on unclear PHP, Blade, Livewire, ACF, database, and environment failures where the real root cause is hidden behind caches, container services, or misconfiguration.

Core Features & Use Cases

  • Issue triage by category: Breaks down failures into targeted areas like Blade/View cache, OPcache, Vite/HMR, Acorn boot, Livewire, ACF registration, and Lando services.
  • Targeted diagnostics and commands: Guides you through the most relevant checks per category (including flush/restart, dev server validation, ACF sync, and autoload regeneration).
  • Structured diagnosis and verification: Prompts a clear diagnosis format with root cause evidence, step-by-step fixes, and a post-fix verification pass.

Quick Start

Ask the skill to diagnose your Sage/Acorn/Lando debugging issue by providing the exact error description you’re seeing.

Frequently Asked Questions about superpowers-sage:debugging

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

FAQPage Schema
How do I debug Blade rendering and Livewire mount failures in Sage?

Debugging Sage Blade and Livewire failures requires triaging symptoms into Blade cache, OPcache, or Vite/HMR categories. You run targeted Lando commands to validate configurations, flush caches, and produce a structured diagnosis with root cause evidence and step-by-step fixes.

Why does my Acorn boot fail in a Lando environment?

Acorn boot failures in Lando often stem from environment-specific misconfigurations or WP hook conflicts. You diagnose them by running correct Lando commands to inspect container logs, validating configuration files, and checking autoload regeneration to isolate the root cause.

What is the best way to fix Vite HMR and ACF registration errors in WordPress?

The best way to fix Vite HMR and ACF registration errors in WordPress is through targeted diagnostics per category. You validate your dev server behavior, perform ACF sync checks, and regenerate autoloads to identify the exact failure point and verify the post-fix.

How do I resolve Eloquent query and queue job failures in Acorn?

Resolving Eloquent query and queue job failures in Acorn involves categorizing the symptoms and running targeted diagnostics. You validate database configurations, inspect queue job states, and apply step-by-step fixes followed by a post-fix verification pass to ensure stability.

Can I use this debugging approach for PHP errors and WP hook conflicts in Sage?

Yes, you can use this debugging approach for PHP errors and WP hook conflicts in Sage. It applies domain-aware troubleshooting procedures to categorize symptoms, validate configuration files, and produce a structured diagnosis with root cause evidence and verification steps.