Symfony Superpowers

This plugin delivers Symfony-specific guidance while remaining environment-agnostic, functioning in any Symfony application whether using Docker Compose, Symfony Docker (FrankenPHP), or host tools directly.

Runner Selection

Prefer Docker if configured, otherwise fall back to host:

Essential Workflows

1. TDD - symfony:tdd-with-pest or symfony:tdd-with-phpunit
2. Doctrine - symfony:doctrine-migrations, symfony:doctrine-fixtures-foundry
3. Quality - symfony:quality-checks (PHP-CS-Fixer, PHPStan)
4. Async - symfony:symfony-messenger, symfony:symfony-scheduler
5. Architecture - symfony:ports-and-adapters, symfony:cqrs-and-handlers
6. API - symfony:api-platform-resources, symfony:api-platform-filters

Philosophy

• Lean controllers: max 5-10 lines, delegate to services
• DTOs & Value Objects: typed data structures with Serializer
• Voters: granular authorization, not controller logic
• Foundry factories: realistic test data, not fixtures soup
• Messenger: async by default, sync for debugging

Interactive Commands

• /superpowers-symfony:brainstorm - structured ideation
• /superpowers-symfony:write-plan - implementation planning
• /superpowers-symfony:execute-plan - methodical execution
• /superpowers-symfony:symfony-check - quality validation
• /superpowers-symfony:symfony-tdd-pest - TDD workflow

Version Support

Quick Reference

Console Commands

# Clear cache
bin/console cache:clear

# Database
bin/console doctrine:migrations:migrate
bin/console doctrine:fixtures:load

# Messenger
bin/console messenger:consume async -vv

# Debug
bin/console debug:router
bin/console debug:container
bin/console debug:autowiring

Test Commands

# PHPUnit
./vendor/bin/phpunit

# Pest
./vendor/bin/pest --parallel

# With coverage
./vendor/bin/pest --coverage --min=80

Quality Commands

# PHP-CS-Fixer
./vendor/bin/php-cs-fixer fix

# PHPStan
./vendor/bin/phpstan analyse

# All checks
composer run-script check