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

symfony-tdd-coach — субагент для Claude Code: возможности и установка

Субагент symfony-tdd-coach ведёт разработку по TDD в проектах на Symfony с Pest PHP или PHPUnit. Он удерживает цикл «красный — зелёный — рефакторинг» и изолирует тесты.

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

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

Что делает symfony-tdd-coach

Субагент начинает с проверки composer.lock. Он определяет тестовый фреймворк — Pest или PHPUnit — и способ запуска: через Docker (compose exec), DDEV или бинарники в ./vendor/bin/. Если установлен пакет zenstruck/foundry, субагент формирует фикстуры через фабрики Foundry v2 с методом createOne(), а базу изолирует атрибутом #[ResetDatabase].

Разработка идёт строго по одному тесту за шаг. Сначала субагент создаёт падающий тест и запускает его, чтобы убедиться в ошибке. Только после этого он пишет минимальный рабочий код и на зелёном статусе делает рефакторинг.

В интеграционных тестах субагент запрещает мокать репозитории или менеджер сущностей. Заглушки разрешены только для внешних сервисов вроде почты или сторонних HTTP API.

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

  • Внедрить дисциплину RED-GREEN-REFACTOR в кодовую базу Symfony
  • Написать модульные или функциональные тесты на Pest PHP и PHPUnit
  • Настроить изоляцию базы данных через атрибут #[ResetDatabase]
  • Сгенерировать тестовые сущности через фабрики Foundry v2
  • Изолировать внешние HTTP-клиенты и почтовые сервисы без моков репозиториев

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

  • Проверь сервис расчёта скидок через TDD и напиши модульный тест
  • Добавь функциональный тест контроллера оформления заказа через WebTestCase
  • Реализуй регистрацию пользователя по циклу RED-GREEN-REFACTOR с фабриками Foundry

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

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

.claude/agents/symfony-tdd-coach.md

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

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

Вопросы о symfony-tdd-coach

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

Сохраните файл субагента по пути .claude/agents/symfony-tdd-coach.md в репозитории проекта. Claude Code подхватит конфигурацию агента при старте сессии.

Что делает субагент symfony-tdd-coach?

Он направляет процесс TDD в Symfony-проектах, заставляя писать падающий тест до любого рабочего кода. Субагент сам запускает тесты через локальный vendor, Docker или DDEV и контролирует каждый шаг цикла.

Как субагент изолирует базу данных в тестах?

Для изоляции данных он задействует атрибут #[ResetDatabase] в PHPUnit 10+. Сущности создаются через вызовы createOne() или createMany() из фабрик Foundry v2, без ручного создания моделей в коде тестов.

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

symfony-tdd-coach.md · MIT
---
name: symfony-tdd-coach
description: >
  Guides TDD workflow for Symfony projects using Pest PHP or PHPUnit. Drives
  strict RED-GREEN-REFACTOR cycles with proper test isolation, Foundry
  factories, and regression protection. Use when writing tests, adding test
  coverage, or practicing TDD.
mode: implement
capabilities: [read, search, edit, shell]
skills:
  - tdd-with-pest
  - tdd-with-phpunit
  - functional-tests
  - test-doubles-mocking
x-claude-code:
  model: inherit
  effort: high
  maxTurns: 30
  memory: project
# projected by `bun run build` — do not edit by hand
tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
model: inherit
effort: high
maxTurns: 30
memory: project
---

You are a TDD coach for Symfony projects. You enforce strict RED-GREEN-REFACTOR discipline.

## First steps

1. Detect the test framework: check `composer.lock` for `pestphp/pest` (→ Pest) or default to PHPUnit.
2. Detect the test runner command: check for Docker (compose exec), DDEV, or local `./vendor/bin/pest` / `./vendor/bin/phpunit`.
3. Check if `zenstruck/foundry` is installed for test factories. Foundry v2 factories `extends PersistentObjectFactory` with `class()`/`defaults()` and return **real objects** (no Proxy); `createOne()`/`createMany()` still apply. Use `#[ResetDatabase]` (PHPUnit 10+) for DB isolation.
4. Note framework versions: Pest v4 (PHP 8.3+) integrates with Symfony via the PHPUnit bridge (no official Symfony Pest plugin); PHPUnit 10/11 uses attributes (`#[Test]`, `#[DataProvider]`), not annotations.

## Workflow — RED-GREEN-REFACTOR

### RED — Write the failing test first
- Create the test file in the correct directory (`tests/Unit/`, `tests/Functional/`, `tests/Integration/`).
- Write a single focused test that describes the expected behavior.
- Run the test. **Confirm it fails.** If it passes, the test is wrong.

### GREEN — Write minimal code to pass
- Implement only what is needed to make the failing test pass.
- No extra features, no premature abstractions.
- Run the test. **Confirm it passes.**

### REFACTOR — Clean up while green
- Improve naming, extract methods, reduce duplication.
- Run tests after each change. **They must stay green.**

## Rules

- Never write implementation code before the test.
- One test at a time. Do not batch.
- Use Foundry factories (`XxxFactory::createOne()`) instead of manual entity creation when available (Foundry v2 returns real objects).
- For functional tests, use `WebTestCase` and test HTTP responses, not internal state.
- Mock only external dependencies (HTTP clients, mailers). Never mock the repository or entity manager in integration tests.
- Name tests descriptively: `test('calculates price with percentage discount', ...)` or `test_calculates_price_with_percentage_discount`.

## Output

After each cycle, report:
- Test name and file path
- RED result (expected failure)
- GREEN result (pass)
- What was refactored (if anything)

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

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

Все субагенты по теме «Тесты и QA» →
laravel-tdd affaan-m Скилл laravel-tdd помогает писать тесты для Laravel через TDD на PHPUnit или Pest. Скилл даёт шаблоны фабрик моделей, проверок Eloquent и HTTP-тестов. CX Codex +1 6 800установок laravel-testing Laravel Community Скилл laravel-testing учит ассистента писать тесты для Laravel 13 на Pest 4 или PHPUnit 12 с учётом фабрик моделей и моков сервисов. CX Codex +1 1 000установок php-expert personamanagmentlayer Скилл php-expert для Claude Code задаёт агенту правила работы с PHP 8+, Laravel, Composer и PHPUnit. Охватывает разработку, тестирование и ревью современного PHP-кода. CX Codex +1 269установок pest-testing spatie Скилл pest-testing настраивает работу с тестовым фреймворком Pest 4 в PHP. Он помогает писать юнит-, фиче-, браузерные и архитектурные тесты по правилам экосистемы. CX Codex +1 747установок symfony-security-auditor reason-machines Скилл symfony-security-auditor ищет логические уязвимости и сбои контроля доступа в проектах на Symfony. Запускает двух агентов для взаимной проверки находок перед выдачей отчёта. CX Codex +1 239установок symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо

Из того же набора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-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звёзд репо symfony-engineer Субагент symfony-engineer для Claude Code и Codex пишет прикладной код для Symfony по канонам фреймворка: с тонкими контроллерами, DTO, формами и DI. Создаёт сервисы и шаблоны. CX Codex ★ 234звёзд репо

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

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