phpunit-migration-test-reviewing

Analyze Shopware PHPUnit migration tests against MIGRATION-001 to MIGRATION-008 conventions.

41|5|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/shopwareLabs/ai-coding-tools --skill phpunit-migration-test-reviewing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phpunit-migration-test-reviewing
Source: https://github.com/shopwareLabs/ai-coding-tools/tree/main/plugins/test-writing/skills/phpunit-migration-test-reviewing
Command: npx skills add https://github.com/shopwareLabs/ai-coding-tools --skill phpunit-migration-test-reviewing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews Shopware PHPUnit migration tests to ensure they comply with migration testing conventions, including idempotency checks, cleanup expectations, assertion patterns, and correct usage of the MigrationStep framework.

Core Features & Use Cases

  • Rule-driven review: Analyzes a test file against MIGRATION-001 to MIGRATION-008 conventions.
  • Source-context aware: Reads the source migration class to determine applicability and impact.
  • Structured reporting: Produces a standardized report aligned with the repository's output format.

Quick Start

Run the migration test review on a Shopware tests/migration file to generate a compliance report.

Frequently Asked Questions about phpunit-migration-test-reviewing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review Shopware PHPUnit migration tests for convention compliance?

You can review Shopware PHPUnit migration tests for convention compliance by running an automated analysis that validates test structure, source class applicability, and rule conformance across MIGRATION-001 to MIGRATION-008. The review reads the source migration class and generates a standardized compliance report.

What migration testing conventions are enforced for Shopware migration tests?

Migration testing conventions enforced for Shopware migration tests include idempotency checks, cleanup expectations, correct assertion patterns, and proper usage of the MigrationStep framework. The review validates test files against rules MIGRATION-001 through MIGRATION-008 to ensure full conformance.

Can I use this migration test review on PHPUnit tests outside the tests/migration directory?

This migration test review is specifically designed for PHPUnit tests located in the tests/migration directory. It analyzes source migration classes to determine applicability and impact, so using it on tests outside this directory or without a corresponding migration source class will not yield meaningful compliance results.

How does source analysis work when reviewing a Shopware migration test?

Source analysis works by reading the source migration class associated with the test to determine rule applicability and impact. The review process then loads migration rules, detects violations against MIGRATION-001 to MIGRATION-008, and generates a structured report aligned with the repository's output format.

What is the best way to ensure idempotency and cleanup in Shopware migration tests?

The best way to ensure idempotency and cleanup in Shopware migration tests is to run an automated rule-driven review that checks for correct assertion patterns and MigrationStep framework usage. This validates your tests against established migration conventions and highlights areas needing correction.