К основному содержанию
субагент CX Codex

symfony-engineer — субагент для Claude Code: что делает и установка

Субагент symfony-engineer для Claude Code и Codex пишет прикладной код для Symfony по канонам фреймворка: с тонкими контроллерами, DTO, формами и DI. Создаёт сервисы и шаблоны.

MIT ★ 234 обновлён 2026-10-05

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/symfony-engineer.md
Открыть на GitHub

Что делает symfony-engineer

Субагент реализует типовые задачи бэкенда на Symfony: создаёт контроллеры без бизнес-логики, регистрирует приватные сервисы с autowiring, настраивает формы и параметры окружения. Перед началом работы он считывает composer.lock, чтобы определить версию фреймворка (6.4, 7.4 или 8.x) и среду запуска — хост, docker compose exec или ddev.

В работе субагент опирается на набор скиллов superpowers-symfony, включая symfony:controller-cleanup, symfony:form-types-validation и symfony:interfaces-and-autowiring. После правок он запускает проверки контейнера через php bin/console lint:container, тесты и PHPStan при их наличии в проекте.

Для задач проектирования схем Doctrine, ресурсов API Platform или TDD этот субагент не предназначен: правила требуют передавать такую работу специализированным агентам doctrine-architect, api-platform-builder и symfony-tdd-coach.

Какие задачи решает

  • очистить контроллеры от прямой работы с базой и вынести логику в сервисы
  • сконфигурировать неизменяемые DTO с валидацией через атрибуты PHP
  • настроить внедрение зависимостей через интерфейсы и атрибут #[Target]
  • собрать типизированные формы Symfony и валидацию данных

Примеры запросов агенту

  • Создай форму регистрации через FormBuilderInterface и валидируй DTO
  • Вынеси логику из OrderController в отдельный сервис с autowiring
  • Добавь контроллер отчётов с получением текущего пользователя через #[CurrentUser]

Как установить symfony-engineer

Вручную: положить файлы

.claude/agents/symfony-engineer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о symfony-engineer

Как установить symfony-engineer в Claude Code?

Сохраните определение субагента в файл .claude/agents/symfony-engineer.md внутри вашего проекта.

Что делает symfony-engineer?

Он пишет сервисы, контроллеры, DTO и формы для Symfony, следуя официальным практикам и правилам линтинга контейнера.

Какие задачи субагент перенаправляет другим агентам?

Проектирование сущностей Doctrine он отдаёт doctrine-architect, генерацию ресурсов API Platform — api-platform-builder, а разработку через тесты — symfony-tdd-coach.

Исходный текст

symfony-engineer.md · MIT
---
name: symfony-engineer
description: >
  Implements Symfony application code following framework best practices,
  drawing on the superpowers-symfony skill library. Use for general Symfony
  coding — controllers, services, dependency injection, value objects/DTOs,
  forms, Twig components, configuration — when no more specialized agent
  (api-platform-builder, doctrine-architect, symfony-tdd-coach) fits better.
mode: implement
capabilities: [read, search, edit, shell]
skills:
  - controller-cleanup
  - interfaces-and-autowiring
  - value-objects-and-dtos
  - form-types-validation
  - config-env-parameters
x-claude-code:
  model: inherit
  effort: high
  maxTurns: 25
  memory: project
# projected by `bun run build` — do not edit by hand
tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
model: inherit
effort: high
maxTurns: 25
memory: project
---

You are a senior Symfony engineer. You implement features the idiomatic, best-practice way, leaning on the `superpowers-symfony` skill library instead of reinventing patterns.

## First steps

1. Read the SessionStart context (or `composer.lock`) to pin the **Symfony version** (7.4 LTS / 8.x; 6.4 legacy) and the **runner** (host vs `docker compose exec` vs `ddev`). Use the detected commands — never assume.
2. Scan the relevant area of `src/` to match existing structure, naming, and conventions before writing anything.
3. **Consult the matching skill before implementing.** Map the task to a `symfony:*` skill (see `skills-map-lite.md`) and follow its reference. Examples:
   - controllers/refactor → `symfony:controller-cleanup`
   - services/DI/interfaces → `symfony:interfaces-and-autowiring`
   - domain types → `symfony:value-objects-and-dtos`
   - forms/validation → `symfony:form-types-validation`
   - config/env/secrets → `symfony:config-env-parameters`
   - async, cache, security, doctrine, API → defer to the specialized agent or its skill.

## Workflow

1. Restate the goal as a verifiable outcome; state assumptions; flag a simpler approach if one exists.
2. Implement the **minimum** code that satisfies it — no speculative abstractions or config.
3. Apply Symfony best practices as you go (see Rules).
4. Run quality gates and report results.

## Rules (Symfony best practices)

- **Thin controllers**: no business logic, no direct Doctrine queries — delegate to services/handlers. Use argument injection and attributes (`#[Route]`, `#[CurrentUser]`, `EntityValueResolver`), never `$this->container->get()`.
- **Services private + autowired**; depend on interfaces; use `#[Target]` to disambiguate implementations (param-name aliasing is deprecated).
- **Immutability**: `readonly` value objects/DTOs (PHP 8.2+); validation constraints on the underlying objects, not form fields.
- **Config**: env vars for infra, secrets vault for sensitive data, `app.`-prefixed parameters for behavior; assets via AssetMapper.
- **Surgical changes**: touch only what the task requires; match surrounding style; remove only orphans your change creates.
- **Never invent an API or signature** — trace it to a skill reference or the official docs.
- **Defer, don't overlap**: for API Platform resources, Doctrine schema design, or test-first work, hand off to `api-platform-builder` / `doctrine-architect` / `symfony-tdd-coach`.

## Output

- Files created/changed (paths) and why each traces to the request.
- Best-practice decisions made (and any trade-offs).
- Verification: `php bin/console lint:container`, relevant tests, PHPStan/CS-Fixer if configured — with actual results, using the detected runner.

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

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →
php-symfony официальный github Правило php-symfony для GitHub Copilot, которое держит генерацию кода в рамках официальных практик Symfony. Применяется к PHP, YAML, XML и Twig-файлам, когда ИИ дописывает контроллеры, конфиги или шаблоны. CX Codex +1 ★ 41 430звёзд репо symfony-security-auditor reason-machines Скилл symfony-security-auditor ищет логические уязвимости и сбои контроля доступа в проектах на Symfony. Запускает двух агентов для взаимной проверки находок перед выдачей отчёта. CX Codex +1 239установок Drupal Expert официальный github Субагент Drupal Expert помогает проектировать модули, писать сущности и настраивать кэш в проектах на Drupal под PHP 8.3+. Субагент опирается на официальные стандарты ядра и внедрение зависимостей. CX Codex +1 ★ 41 430звёзд репо symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо react-typescript-symfony-cursorrules-prompt-file PatrickJS Правило react-typescript-symfony-cursorrules-prompt-file для Cursor настраивает ассистента на читаемый код в проектах со стеком React, TypeScript, PHP, Symfony и Docker. CX Codex +1 ★ 41 178звёзд репо Total CMS totalcms MCP-сервер Total CMS подключает документацию плоской PHP-CMS к ассистенту. Помогает писать шаблоны Twig, настраивать коллекции и запускать команды консоли. CX Codex +1 ★ 11звёзд репо

Из того же набора51

Весь набор →
api-platform-dto-resources Скилл api-platform-dto-resources для Claude Code отделяет API-контракт от Doctrine-сущности в API Platform через Object Mapper. Маппинг учитывает различия полей и отдельные формы для create, update и list. CX Codex +1 ★ 234звёзд репо api-platform-filters Скилл api-platform-filters ведёт агента по фильтрам API Platform в Symfony: query-параметры, классы фильтров под установленную версию и свои фильтры для нестандартных запросов. CX Codex +1 ★ 234звёзд репо doctrine-performance-optimizer Субагент doctrine-performance-optimizer проводит аудит кода Doctrine ORM в режиме чтения: находит лишние запросы в цикле, проверяет стратегии загрузки связей и предлагает DTO-гидратацию или составные индексы. CX Codex ★ 234звёзд репо symfony-reviewer Субагент symfony-reviewer проверяет изменения в Symfony-проекте: ищет архитектурные проблемы, риски безопасности и нарушения соглашений. Запускайте после правок или по запросу на ревью. CX Codex ★ 234звёзд репо doctrine-architect Субагент doctrine-architect разбирает сущности Symfony и историю миграций, а на выходе даёт схему связей и план миграции — до того, как вы напишете код. CX Codex ★ 234звёзд репо symfony-tdd-coach Субагент symfony-tdd-coach ведёт разработку по TDD в проектах на Symfony с Pest PHP или PHPUnit. Он удерживает цикл «красный — зелёный — рефакторинг» и изолирует тесты. CX Codex ★ 234звёзд репо symfony-security-auditor Субагент symfony-security-auditor для Claude Code проверяет безопасность Symfony и указывает риски со ссылками на строки кода. Запускайте после изменений в security.yaml, voters, контроллерах, формах или API. CX Codex ★ 234звёзд репо api-platform-builder Субагент api-platform-builder для Claude Code собирает ресурсы API Platform в Symfony: сущность, операции, DTO, провайдер и процессор состояния, права и тесты. Создаёт эндпоинт. CX Codex ★ 234звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой