TYPO3 Extension Conformance Checker

Evaluate TYPO3 extensions for standards compliance, architecture patterns, and best practices.

When to Use

Assessing extension quality before production deployment
Generating conformance reports for code review
Planning modernization to TYPO3 v12/v13/v14 standards
Validating TER publishing readiness

Skill Delegation

Testing details: Delegate to typo3-testing skill
Documentation validation: Delegate to typo3-docs skill
OpenSSF Scorecard: Delegate to enterprise-readiness skill

Evaluation Workflow

Step 0: Understand Extension Context (always first)

Before checking files, understand: purpose, target TYPO3/PHP version, extension type (plugin, module, site package, library), criticality (production vs experimental), and codebase scope.

Steps 1-9: Conformance Checks

Initial Assessment -- Extension key, target TYPO3 version, extension type
File Structure -- composer.json, ext_emconf.php, required directories
Coding Standards -- strict_types, type declarations, PSR-12
Prohibited Patterns -- No $GLOBALS access, no GeneralUtility::makeInstance() for services
PHP Architecture -- Constructor DI, Services.yaml, PSR-14 events
Backend Modules -- ES6 modules, Modal API, CSRF protection (v13+)
Testing -- PHPUnit setup, Playwright E2E, coverage >70%
Best Practices -- DDEV setup, runTests.sh, quality tools, CI/CD
TER Publishing -- Workflow, upload comment format, CI compatibility

Step 10: Verification Loop

After fixes, re-run conformance checks. Document score improvement (e.g., "58 -> 82"). Ensure no regressions.

Scoring System

Base Score (0-100): Architecture (20) + Guidelines (20) + PHP Patterns (20) + Testing (20) + Best Practices (20). Excellence bonus up to 22 additional points.

Score Range	Interpretation	Action
90-100+	Excellent	Ready for production and TER
80-89	Good	Minor improvements recommended
70-79	Acceptable	Address before major releases
50-69	Needs Work	Significant improvements required
Below 50	Critical	Block deployment until resolved

Critical issues (security, data loss, core incompatibility) block deployment regardless of score.

Running Checks

# Full conformance check
scripts/check-conformance.sh /path/to/extension

# Individual checks
scripts/check-file-structure.sh /path/to/extension
scripts/check-coding-standards.sh /path/to/extension
scripts/check-architecture.sh /path/to/extension
scripts/check-testing.sh /path/to/extension
scripts/check-phpstan-baseline.sh /path/to/extension
scripts/generate-report.sh /path/to/extension

References

Detailed guidance for each evaluation area:

references/extension-architecture.md -- Directory structure, required files
references/coding-guidelines.md -- PSR-12, naming conventions, TYPO3 style
references/php-architecture.md -- DI, services, events, Extbase, middleware
references/testing-standards.md -- PHPUnit and Playwright requirements
references/composer-validation.md -- composer.json validation rules
references/ext-emconf-validation.md -- TER requirements, field specs
references/version-requirements.md -- TYPO3/PHP compatibility matrix
references/dual-version-compatibility.md -- v12+v13 patterns
references/v13-deprecations.md -- Deprecated APIs and migration paths
references/backend-module-v13.md -- ES6, Modal API, accessibility
references/ter-publishing.md -- TER publication requirements
references/report-template.md -- Standard report structure
references/excellence-indicators.md -- Bonus scoring criteria
references/best-practices.md -- Tea extension organizational patterns

Asset Templates

Quality tool configs in assets/Build/: PHPStan, PHP-CS-Fixer, Rector, ESLint, Stylelint, TypoScript lint.

typo3-conformance