Superpowers Symfony
A Claude Code plugin providing Symfony-specific guidance, skills, workflows, and specialized subagents. Enhances your development experience with TDD support, Doctrine guidance, API Platform patterns, and best practices for Symfony 6.4 LTS, 7.x, and 8.0.
Features
- Specialized Agents - 4 subagents with skill preloading and project memory
- TDD Workflows - RED-GREEN-REFACTOR with Pest PHP or PHPUnit
- Doctrine Mastery - Relations, migrations, transactions, Foundry fixtures
- API Platform - Resources, filters, serialization, versioning, DTOs
- Symfony Messenger - Async processing, handlers, retry strategies
- Security - Voters, rate limiting, form validation
- Architecture - Hexagonal/Ports & Adapters, CQRS, DI patterns
- Quality - PHP-CS-Fixer, PHPStan integration
- Docker Support - Docker Compose, Symfony Docker (FrankenPHP), DDEV
- Auto-detection - Detects Symfony version, API Platform, Docker setup, and test framework at session start
Installation
From the marketplace (recommended)
# Add the marketplace
/plugin marketplace add MakFly/superpowers-symfony
# Install the plugin
/plugin install superpowers-symfony@superpowers-symfony
For your team (project-scoped)
Add to your project's .claude/settings.json:
{
"extraKnownMarketplaces": {
"superpowers-symfony": {
"source": {
"source": "github",
"repo": "MakFly/superpowers-symfony"
}
}
},
"enabledPlugins": {
"superpowers-symfony@superpowers-symfony": true
}
}
Usage
Once installed, skills and commands are available automatically. Claude can invoke them based on task context, or you can call them explicitly.
Skills (invoke with /skill-name)
/symfony:tdd-with-pest
/symfony:doctrine-relations
/symfony:api-platform-dto-resources
Slash commands
/brainstorm
/write-plan
/execute-plan
/symfony-check
Available Skills
Onboarding & Configuration
| Skill | Description |
|---|
using-symfony-superpowers | Entry point and overview |
runner-selection | Docker vs Host environment detection |
bootstrap-check | Project verification and setup |
daily-workflow | Daily development workflow |
effective-context | Context management best practices |
Testing
| Skill | Description |
|---|
tdd-with-pest | TDD workflow with Pest PHP |
tdd-with-phpunit | TDD workflow with PHPUnit |
functional-tests | WebTestCase for HTTP testing |
api-platform-tests | API Platform test utilities |
test-doubles-mocking | Mocks, stubs, and fakes |
e2e-panther-playwright | End-to-end browser testing |
Doctrine ORM
| Skill | Description |
|---|
doctrine-relations | Entity relationships (1:1, 1:N, N:N) |
doctrine-migrations | Schema versioning |
doctrine-fixtures-foundry | Test data factories with Foundry |
doctrine-transactions | Transaction handling |
doctrine-batch-processing | Bulk operations |
doctrine-fetch-modes | Performance optimization |
API Platform
| Skill | Description |
|---|
api-platform-resources | Resource configuration |
api-platform-filters | Search and filtering |
api-platform-serialization | Serialization groups |
api-platform-state-providers | Custom State Providers & Processors |
api-platform-dto-resources | DTO-based API Resources |
api-platform-security | API security patterns |
api-platform-versioning | API versioning strategies |
Messenger & Async
| Skill | Description |
|---|
symfony-messenger | Message handling basics |
messenger-retry-failures | Error handling and retries |
symfony-scheduler | Scheduled tasks |
Security
| Skill | Description |
|---|
symfony-voters | Authorization logic |
form-types-validation | Form and validation |
rate-limiting | Rate limiter configuration |
Architecture
| Skill | Description |
|---|
interfaces-and-autowiring | Dependency injection |
ports-and-adapters | Hexagonal architecture |
strategy-pattern | Tagged services pattern |
cqrs-and-handlers | Command/Query separation |
value-objects-and-dtos | Value objects design |
config-env-parameters | Environment configuration |
Quality & Performance
| Skill | Description |
|---|
quality-checks | PHP-CS-Fixer, PHPStan |
symfony-cache | Caching strategies |
controller-cleanup | Thin controllers pattern |
twig-components | Twig component patterns |
Planning & Workflow
| Skill | Description |
|---|
brainstorming | Structured brainstorming sessions |
writing-plans | Implementation planning |
executing-plans | Plan execution with checkpoints |
Slash Commands