TYPO3 Core Contributions
Guide for contributing to TYPO3 Core: Forge issues, Gerrit patches, CI debugging, and review workflows.
When to Use
- Forge issue analysis or creation (
forge.typo3.org/issues/*) - Patch submission, CI debugging, Gerrit review workflow
- Commit message formatting, cherry-picks, rebasing
Prerequisites
Run ${CLAUDE_SKILL_DIR}/scripts/verify-prerequisites.sh to check: TYPO3.org account, Gerrit SSH (ssh -p 29418 <user>@review.typo3.org), Git email matching Gerrit. See references/account-setup.md.
Workflow
- Setup: Account + environment (
${CLAUDE_SKILL_DIR}/scripts/setup-typo3-coredev.sh,references/ddev-setup-workflow.md) - Branch:
git checkout -b feature/<issue>-description - Analyze: Understand root cause, reproduction steps, affected versions before coding
- Develop: Implement fix + tests, validate with typo3-conformance-skill
- Commit: Follow format below, include
Resolves: #<issue>+Releases: - Push:
git push origin HEAD:refs/for/main(starts as WIP) - CI: Wait for all jobs. Read actual GitLab logs at
git.typo3.org/typo3/CI/cms/-/jobs/<id>. Fix ALL failures in one amend+push - Ready: Mark ready via
git push origin HEAD:refs/for/main%readyor Gerrit UI "Start Review" - Review: Address feedback, amend commit, preserve Change-Id. Fetch reviewer's patchset first to preserve their message edits:
git fetch origin refs/changes/XX/NNNNN/N && git reset --soft FETCH_HEAD - Update:
git commit --amend && git push origin HEAD:refs/for/main
Commit Format
[TYPE] Subject (imperative mood, max 52 chars)
How and why (not what). Wrap at 72 chars.
Resolves: #12345
Releases: main, 13.4, 12.4Types: [BUGFIX], [FEATURE] (main only), [TASK], [DOCS], [SECURITY] Breaking: [!!!][TYPE] prefix, Releases: main only Required: Every commit MUST have Resolves: (not just Related:)
CI Debugging
Read ALL failing job logs (never guess). Common jobs: cgl pre-merge (code style), phpstan (static analysis), unit/functional (tests). Fix all in one patchset. Local checks:
./Build/Scripts/runTests.sh -s unit && ./Build/Scripts/runTests.sh -s functional
./Build/Scripts/cglFixMyCommit.sh
./Build/Scripts/runTests.sh -s phpstanKey Operations
| Task | Command |
|---|---|
| Push to Gerrit | git push origin HEAD:refs/for/main |
| Mark ready | git push origin HEAD:refs/for/main%ready |
| Set WIP | git push origin HEAD:refs/for/main%wip |
| Rebase | git fetch origin && git rebase origin/main |
| Cherry-pick patch | git fetch origin refs/changes/XX/NNNNN/N && git cherry-pick FETCH_HEAD |
| Install hook | cp Build/git-hooks/commit-msg.git/hooks/ && chmod +x.git/hooks/commit-msg |
| Fix email mismatch | GIT_COMMITTER_EMAIL="registered@email" git commit --amend --no-edit |
| Forge API | ${CLAUDE_SKILL_DIR}/scripts/create-forge-issue.sh, references/forge-api.md |
References
| Topic | File |
|---|---|
| Account setup | references/account-setup.md |
| Commit format | references/commit-message-format.md |
| Gerrit workflow | references/gerrit-workflow.md |
| Review patterns | references/gerrit-review-patterns.md |
| Modern patterns | references/modern-typo3-patterns.md |
| DDEV setup | references/ddev-setup-workflow.md |
| Forge API | references/forge-api.md |
| Commit hook | references/commit-msg-hook.md |
| Troubleshooting | references/troubleshooting.md |