typo3-conformance

TYPO3 Extension Conformance Checker

A comprehensive Claude Code skill for evaluating TYPO3 extensions against official TYPO3 coding standards, architecture patterns, and best practices.

🔌 Compatibility

This is an Agent Skill following the open standard originally developed by Anthropic and released for cross-platform use.

Supported Platforms:

• ✅ Claude Code (Anthropic)
• ✅ Cursor
• ✅ GitHub Copilot
• ✅ Other skills-compatible AI agents

Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.

Overview

This skill enables systematic evaluation of TYPO3 extensions for conformance to official TYPO3 standards.

Skill Ecosystem Integration

This conformance checker acts as an orchestrator that delegates to specialized skills for deep domain analysis:

🔧 Testing Analysis: typo3-tests

• Repository: https://github.com/netresearch/typo3-testing-skill
• Expertise: Deep PHPUnit configuration analysis, test quality patterns, TYPO3 Testing Framework validation
• Integration: Delegated for Testing Standards category (20 points)

📚 Documentation Analysis: typo3-docs

• Repository: https://github.com/netresearch/typo3-docs-skill
• Expertise: RST validation, TYPO3 documentation standards, rendering validation with Docker
• Integration: Delegated for Documentation Excellence (bonus category)

Delegation Benefits:

• Depth: Each skill provides domain expertise beyond surface-level checks
• Accuracy: Specialized validation reduces false positives/negatives
• Modularity: Skills can be used independently or together
• Maintainability: Each skill focuses on single responsibility

Fallback Strategy:

• Surface-level checks performed if specialized skills unavailable
• Basic validation ensures conformance reports always generate
• Full accuracy requires all ecosystem skills installed

Standards Checked

Standard	Version/Specification
TYPO3 Core	14.3 LTS (default / gold standard) / 13.4 LTS / 12.4 LTS
PHP	8.2 / 8.3 / 8.4 / 8.5 (v14 floor: 8.2; ceiling: 8.5.99)
Coding Style	PSR-12 (Extended Coding Style)
Architecture	Dependency Injection (PSR-11), PSR-14 Events, PSR-15 Middleware, Fluid 5 strict VHs, Extbase PHP attributes
Testing	PHPUnit 11/12/13, TYPO3 Testing Framework 9.x, Playwright E2E
Documentation	reStructuredText (RST), TYPO3 Documentation Standards, XLIFF 2.x (v14+)

Conformance Areas

• Extension Architecture - File structure, naming conventions, required files
• Coding Guidelines - PSR-12 compliance, TYPO3-specific code style
• PHP Architecture - Dependency injection, services, events, Extbase patterns
• Testing Standards - Unit, functional, and Playwright E2E testing requirements
• Best Practices - Real-world patterns from Tea extension and core standards

Features

Automated Validation Scripts

• ✅ check-conformance.sh - Main orchestration script
• 📁 check-file-structure.sh - File structure and directory validation
• 📝 check-coding-standards.sh - PSR-12 and TYPO3 code style checks
• 🏗️ check-architecture.sh - Dependency injection and architecture patterns
• 🧪 check-testing.sh - Testing infrastructure and coverage analysis
• 📊 generate-report.sh - Comprehensive conformance report generation

Reference Documentation

Core Standards:

• version-requirements.md - Official TYPO3 and PHP version compatibility matrix
• extension-architecture.md - TYPO3 file structure standards
• coding-guidelines.md - PSR-12 and TYPO3 code style guide
• php-architecture.md - Dependency injection and architectural patterns
• testing-standards.md - Unit, functional, and Playwright E2E testing
• best-practices.md - Real-world patterns and project infrastructure

Advanced Validation Guides:

• runtests-validation.md - Validate Build/Scripts/runTests.sh against Tea extension reference
• development-environment.md - Validate DDEV/Docker development environment setup
• directory-structure.md - Validate .Build/ vs Build/ directory separation and organization

Excellence Indicators:

• excellence-indicators.md - Optional quality features for exceptional extensions (0-20 bonus points)
  • Community & Internationalization: Crowdin, issue templates, .gitattributes, README badges
  • Advanced Quality Tooling: Fractor, TYPO3 CodingStandards, StyleCI, Makefile, CI matrix
  • Documentation Excellence: 100+ RST files, modern tooling (guides.xml, screenshots.json)
  • Extension Configuration: ext_conf_template.txt, composer doc scripts, multiple Sets

Secondary References:

• georgringer/news - Community reference extension demonstrating excellence patterns

Quality Tool Configuration Templates