superpowers-symfony

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