TYPO3 Extension Conformance Checker

Evaluate TYPO3 extensions for standards compliance, architecture, 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: Delegate to typo3-testing
• Documentation: Delegate to typo3-docs
• OpenSSF Scorecard: Delegate to enterprise-readiness

Evaluation Workflow

Step 0: Understand Extension Context (always first)

Understand: purpose, target TYPO3/PHP version, extension type (plugin, module, site package, library), criticality, codebase scope.

Steps 1-10: Conformance Checks

1. Initial Assessment -- Extension key, target TYPO3 version, extension type
2. File Structure -- composer.json, ext_emconf.php, required directories
3. Coding Standards -- strict_types, type declarations, PSR-12
4. Prohibited Patterns -- No $GLOBALS access, no GeneralUtility::makeInstance() for services
5. PHP Architecture -- Constructor DI, Services.yaml, PSR-14 events
6. Backend Modules -- ES6 modules, Modal API, CSRF protection (v13+)
7. Testing -- PHPUnit setup, Playwright E2E, coverage >70%
8. Best Practices -- DDEV setup, runTests.sh, quality tools, CI/CD
9. TER Publishing -- Workflow, upload comment format, CI compatibility
10. Assessment Audit Checks -- PHPStan baseline, TCA searchFields/default_sortby, DI interface aliases, enum constants, cache double-lookup, XLIFF completeness, multi-version dependency adapters

Step 11: Verification Loop

After fixes, re-run 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 points.

Critical issues block deployment regardless.

Running Checks

scripts/check-conformance.sh /path/to/extension    # Full check
scripts/check-file-structure.sh /path/to/extension  # Individual checks
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

Guidance for each evaluation area:

• references/extension-architecture.md -- Directory structure, required files
• references/coding-guidelines.md -- PSR-12, naming, TYPO3 style
• references/php-architecture.md -- DI, services, events, middleware
• references/testing-standards.md -- PHPUnit/Playwright requirements
• references/composer-validation.md -- composer.json rules
• references/ext-emconf-validation.md -- TER field specs
• references/version-requirements.md -- TYPO3/PHP compatibility
• references/dual-version-compatibility.md -- v12+v13 patterns
• references/multi-version-dependency-compatibility.md -- Adapter pattern for multi-major-version deps
• references/v13-deprecations.md -- Deprecated APIs, migration
• references/backend-module-v13.md -- ES6, Modal API, a11y
• references/ter-publishing.md -- TER publication requirements
• references/report-template.md -- Report structure
• references/excellence-indicators.md -- Bonus scoring
• references/best-practices.md -- Organizational patterns

Asset Templates

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