superpowers-symfony

Superpowers Symfony — Claude Code plugin for Symfony 7.4 LTS & 8.x

Symfony AI development superpowers for Claude Code. 44 expert skills, 7 specialized subagents, and 13 slash commands covering API Platform v4, Doctrine ORM 3, TDD with Pest & PHPUnit, Symfony Messenger, security/voters, and DDD / hexagonal architecture.

Superpowers Symfony is a Claude Code plugin that gives AI coding agents deep, version-accurate Symfony expertise — from Doctrine schema design and API Platform REST/GraphQL APIs to test-driven development, async Messenger workflows, caching, rate limiting, and clean architecture. It targets Symfony 7.4 LTS and 8.x (6.4 LTS supported as legacy), API Platform v4 (v3 legacy), and Doctrine ORM 3 — so the guidance, signatures, and code examples match the framework you actually run.

Features

• Specialized Agents - 7 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