using-symfony-superpowers_skill

Overview

This skill guides applying production-grade Symfony architecture and execution workflows with a controlled scope and clear checkpoints. It helps teams propose minimal, safe architectural adjustments and execute them incrementally. The result is validated changes, a documented decision trail, and a short follow-up backlog.

How this skill works

It starts by mapping current boundaries, constraints, and coupling points in your Symfony project. Then it proposes the smallest coherent architectural change, breaks that change into checkpoints, and executes each checkpoint with validation steps. At completion it summarizes tradeoffs, residual risks, and recommended next tasks.

When to use it

• Refining service boundaries, context handling, or module coupling in a Symfony app.
• Planning medium-to-large changes that must be rolled out safely in production.
• Introducing new execution workflows, command pipelines, or job orchestration.
• When you need an auditable decision log and measurable validation at each step.
• Before starting any broad refactor to determine risk and minimal scope.

Best practices

• Default to existing project patterns; only deviate when the benefit clearly outweighs cost.
• Propose the smallest coherent change that delivers the required outcome.
• Split work into clear checkpoints with concrete validation criteria for each.
• Keep a concise, auditable decision log describing tradeoffs and owners.
• Avoid blanket refactors—address coupling points incrementally and measure impact.

Example use cases

• Introduce a new bounded context and safely migrate a subset of related services.
• Replace a monolithic event dispatcher with scoped message buses and validate handlers incrementally.
• Migrate long-running tasks from controllers to Symfony Messenger with checkpointed rollouts.
• Harden request context handling for multi-tenant routing with staged validation.
• Implement a new execution workflow for background jobs while preserving current behavior until cutover.