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

Symfony AI development superpowers for Claude Code. 44 expert skills, 4 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 - 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

Testing

Doctrine ORM

API Platform

Messenger & Async

Security

Architecture

Quality & Performance

Planning & Workflow

Slash Commands

Agents

Specialized subagents that Claude auto-delegates to based on task context. Each agent has skill preloading and project-scoped memory that persists across sessions.

Claude invokes agents automatically based on your task. You can also reference them explicitly:

@agent-symfony-reviewer look at my recent changes
@agent-symfony-tdd-coach help me write tests for UserService
@agent-doctrine-architect design entities for an e-commerce app
@agent-api-platform-builder create a Product API resource

Supported Versions

Docker Support

The plugin automatically detects your Docker setup at session start:

Commands (bin/console, composer, tests) are automatically prefixed with the correct Docker exec wrapper.

Project Structure

superpowers-symfony/
├── .claude-plugin/
│   ├── marketplace.json      # Marketplace catalog
│   └── plugin.json           # Plugin manifest
├── agents/                   # 4 specialized subagents
│   ├── symfony-reviewer.md
│   ├── symfony-tdd-coach.md
│   ├── doctrine-architect.md
│   └── api-platform-builder.md
├── skills/                   # 44 skill definitions
│   ├── tdd-with-pest/
│   │   └── SKILL.md
│   ├── doctrine-relations/
│   │   ├── SKILL.md
│   │   └── reference.md
│   └── ...
├── commands/                 # 13 slash commands
│   ├── brainstorm.md
│   ├── write-plan.md
│   └── ...
├── hooks/
│   ├── hooks.json            # SessionStart hook config
│   └── session-start.sh      # Auto-detection script
├── docs/                     # Additional documentation
├── scripts/                  # Validation scripts
├── LICENSE
└── README.md

Contributing

1. Fork the repository
2. Create a feature branch
3. Add/modify skills in skills/ directory
4. Validate: claude plugin validate .
5. Submit a pull request

Skill format

Each skill is a directory with a SKILL.md file:

---
name: symfony:skill-name
description: Brief description of the skill
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - Glob
  - Grep
---

# Skill content with code examples, best practices, etc.

License

MIT License - see LICENSE for details.

Acknowledgments

Inspired by superpowers-laravel by JP Caparas.

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

_{Keywords: Symfony, Claude Code plugin, Claude Code skills, AI coding agent, Anthropic, API Platform, Doctrine ORM, PHP 8, TDD, Pest, PHPUnit, Symfony Messenger, Scheduler, CQRS, hexagonal architecture, ports and adapters, DDD, value objects, DTO, voters, rate limiting, Twig components, Foundry, Panther, FrankenPHP, Symfony Docker, DDEV.}