0084-laravel-systematic-debugging

What problem does it solve?

It solves the problem of wasting time on random patches by enforcing a disciplined approach to diagnosing Laravel issues until the root cause is identified.

Core Features & Use Cases

• Four-phase debugging workflow: Root cause investigation, pattern analysis, hypothesis testing, and implementation with verification.
• Laravel-specific evidence gathering: Systematic use of logs, debug mode, Telescope, Tinker, and query tracing to confirm what is happening.
• Guardrails against symptom-fixing: Red-flag stop conditions and guidance for when repeated failed fixes indicate an architectural issue.

Use it for test failures, Eloquent/relationship problems, authentication/authorization bugs, queue/job errors, route issues, validation failures, migration problems, N+1 performance issues, and general unexpected behavior in Laravel.

Quick Start

Use the 0084-laravel-systematic-debugging skill to debug a Laravel failure by first reading the full error message, checking logs, and reproducing the issue before attempting any code changes.