starraider/ai-typo3-migrator-plugin
Portable Agent Skills for planning, analyzing, and safely executing TYPO3 major-version upgrades, extension migrations, and site package merges.
Use when analyzing, planning, or executing a TYPO3 migration from EXT:gridelements to the current b13/container extension. Recreate every used legacy grid as a project-owned Container CType, preserve its frontend markup and child ordering, then use a reviewed, dry-run-first database migration script to replace Gridelements relations. Includes a staged route for data created by Gridelements 8.7.0. Not for a TYPO3 core upgrade without this extension migration, a visual redesign, or an unreviewed production database rewrite.
Use when analyzing, planning, or merging two TYPO3 site packages, theme extensions, or side packages into one target extension, including Composer metadata, TypoScript, site sets, Fluid templates, TCA overrides, PHP namespaces, assets, and target-version compatibility. Not for a TYPO3 core upgrade or a production deployment.
Migrate a TYPO3 site package from legacy or custom CSS to Tailwind CSS v4 in DDEV while preserving approved rendered behavior. Use for a planned theme migration that needs legacy visual baselines, Tailwind build integration, Fluid-template conversion, accessibility checks, and cross-browser verification. Do not use for a small isolated CSS fix or for setting up Playwright alone.
Use when the user explicitly requests a TYPO3 upgrade strategy analysis for a specified source and newer target version, comparing sequential major upgrades, a clean target rebuild with controlled content migration, and a hybrid approach. Inspects the project and database read-only, recommends a favored option for human decision, estimates effort, and writes one Markdown report inside the project. Not for executing upgrades or changing Composer or database state.
Use when analyzing, planning, or executing a Composer-based TYPO3 11.5 to 12.4 upgrade, including extension compatibility, Composer blockers, PHP/database readiness, Rector or Fractor migrations, and deprecated APIs. Not for patch updates, production deployment, or an unrelated site-package merge.
Use when analyzing, planning, or executing a Composer-based TYPO3 12.4 to 13.4 upgrade, including extension compatibility, Composer blockers, PHP/database readiness, Content Blocks 0.x migrations, Rector or Fractor migrations, and deprecated APIs. Not for patch updates, production deployment, or an unrelated site-package merge.
Use when analyzing, planning, or executing a Composer-based TYPO3 13 to 14 upgrade, including extension compatibility, Composer blockers, PHP/database readiness, Rector or Fractor migrations, and deprecated APIs. Not for patch updates, production deployment, or an unrelated site-package merge.