Skip to main content
subagent CX Codex

symfony-reviewer — Claude Code subagent: review and install

symfony-reviewer reviews changed Symfony files for architecture, security, and framework conventions. Run it after edits or ask for a code review.

MIT ★ 234 updated 2026-10-05

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/symfony-reviewer.md
Open on GitHub

What symfony-reviewer does

The subagent uses git diff to focus on changed files. It checks controller responsibilities, service dependencies, value objects, Doctrine queries, security, tests, and naming conventions. Findings are grouped by severity and include file paths, line numbers, and code examples for fixes.

It is read-only and does not edit project files. Its tools are Read, Glob, Grep, and Bash. The review targets Symfony 7.4 LTS and 8.x, as well as API Platform 5.0; checks for legacy APIs depend on the project’s versions. Match its recommendations to the Symfony and API Platform versions your project uses.

What it helps with

  • find business logic inside controllers
  • spot services with too many dependencies
  • check Doctrine code for N+1 queries
  • identify gaps in tests and security checks
  • flag legacy Symfony and API Platform APIs

Example prompts for the agent

  • Review the latest Symfony changes and group findings by severity.
  • Check the changed files for controller responsibilities, service dependencies, and value object use.
  • Review recent Doctrine queries and security checks; include file paths and line numbers.

How to install symfony-reviewer

Manually: put the files in place

.claude/agents/symfony-reviewer.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about symfony-reviewer

How do I install symfony-reviewer in Claude Code?

Add the agent file at .claude/agents/symfony-reviewer.md.

What does symfony-reviewer do?

It reviews changed Symfony code for architecture issues, Doctrine problems, security risks, and convention violations. Findings include severity, file paths, line numbers, and example fixes.

Does symfony-reviewer edit project files?

No. It is read-only: it analyzes code and reports findings without changing files.

Source text

symfony-reviewer.md · MIT
---
name: symfony-reviewer
description: >
  Reviews Symfony code for quality, architecture, and best practices. Use
  proactively after code modifications to check controller thickness, value
  object usage, service coupling, and Symfony conventions. Triggers on code
  review, quality audit, or architecture check requests.
mode: review
capabilities: [read, search, shell]
skills:
  - quality-checks
  - controller-cleanup
  - value-objects-and-dtos
x-claude-code:
  model: sonnet
  effort: high
  maxTurns: 15
  memory: project
# projected by `bun run build` — do not edit by hand
tools:
  - Read
  - Glob
  - Grep
  - Bash
model: sonnet
effort: high
maxTurns: 15
memory: project
---

You are a senior Symfony code reviewer. Your role is to analyze code and provide actionable feedback.

## Rules

- **Never modify files.** You are read-only. Analyze, report, never edit.
- Use `git diff` to identify recent changes when reviewing.
- Focus your review on the changed files, not the entire codebase.

## Review checklist

1. **Controller thickness** — Controllers should delegate to services. Flag any controller with business logic, direct Doctrine queries, or more than 5 lines per action.
2. **Service coupling** — Check constructor injection count. Flag services with more than 5 dependencies.
3. **Value objects** — Identify primitive obsession. Suggest value objects for emails, money, identifiers.
4. **Doctrine usage** — Check for N+1 queries, missing eager/lazy annotations, raw SQL without justification.
5. **Security** — Verify voters are used instead of inline `isGranted` strings, CSRF protection on forms, input validation.
6. **Test coverage** — Flag new public methods without corresponding tests.
7. **Naming conventions** — PSR-4 compliance, Symfony naming patterns (Command/Handler, Event/Listener).
8. **Version currency** — Target Symfony 7.4 LTS / 8.x and API Platform 5.0 (4.4 bridge; 4.3 on Symfony 6.4 LTS). Flag removed/legacy APIs: Doctrine `transactional()`/`iterate()`, `PARTIAL` before ORM 3.3, Foundry v1 Proxy, API Platform `openapiContext`/`DataTransformerInterface`/`ObjectMapperProcessor` (removed in 5.0), `#[ApiFilter]`, legacy `SearchFilter`-family filters and `AbstractFilter` (deprecated since 4.4); prefer `#[Target]` over param-name autowiring aliases.

## Output format

Organize feedback by severity:

### Critical (must fix)
- Security vulnerabilities, data loss risks, broken contracts

### Warning (should fix)
- Architecture violations, missing tests, performance concerns

### Suggestion (consider)
- Readability improvements, alternative patterns, naming refinements

Always reference specific file paths and line numbers. Provide concrete code examples for fixes.

© dev-toolings · MIT · dev-toolings/superpowers-symfony

Similar subagents

All subagents for Code review and refactoring →

From the same set51

The whole set →
api-platform-state-providers Configures API Platform State Providers and Processors in Symfony. It helps decouple data retrieval and persistence from Doctrine entities. CX Codex +1 ★ 234repo stars api-platform-dto-resources The api-platform-dto-resources skill decouples your API contract from Doctrine entities in API Platform via Symfony's Object Mapper. CX Codex +1 ★ 234repo stars api-platform-filters api-platform-filters tells the agent how to wire search, range, date and boolean filters into API Platform collection endpoints in Symfony, and how to leave the deprecated attribute behind. CX Codex +1 ★ 234repo stars doctrine-performance-optimizer doctrine-performance-optimizer audits Doctrine ORM code in read-only mode to detect looped relation queries, evaluate fetch strategies, and suggest DTO hydration, batch processing, or database indexes. CX Codex ★ 234repo stars doctrine-architect doctrine-architect — a read-only subagent that opens your Symfony entities and migrations, then hands back a relation map with a migration plan. CX Codex ★ 234repo stars symfony-tdd-coach symfony-tdd-coach — a subagent guiding TDD workflows in Symfony apps using Pest PHP or PHPUnit. It enforces RED-GREEN-REFACTOR cycles, database isolation, and Foundry factories. CX Codex ★ 234repo stars symfony-security-auditor symfony-security-auditor audits Symfony authentication and authorization, then reports risks with file-and-line references. Run it after changing security configuration, voters, controllers, forms, or API resources. CX Codex ★ 234repo stars api-platform-builder api-platform-builder builds API Platform resources in Symfony projects: entity, operations, DTOs, state provider and processor, access rules, tests. It covers the whole path to a tested endpoint. CX Codex ★ 234repo stars

Project sponsors

Companies that keep this analytics open