breadcrumb-the-shire/tools/codex-skills/starterkit-php-style-ci/SKILL.md

name, description

name	description
starterkit-php-style-ci	Standard-Skill fuer PHP Coding-Style im Starterkit (php-cs-fixer, dry-run in CI, lokaler fix/check workflow). Verwenden bei Style-Einfuehrung, CI-Checks oder grossen Format-Diffs.

Starterkit PHP Style CI

Ziel

Coding-Style pruefbar, reproduzierbar und regressionsarm machen.

Wann verwenden

1. Einfuehrung oder Nachschaerfung von Style-Regeln.
2. CI-Dry-Run fuer Style-Checks.
3. Aufraeumen grosser Style-Diff-Wellen.

Verbindliche Regeln

1. MUST composer cs:check fuer nicht-mutierende Pruefung nutzen.
2. MUST composer cs:fix nur bewusst und mit Diff-Kontrolle ausfuehren.
3. MUST Style-Check vor Merge gruen halten (lokal und optional CI).
4. MUST nach groesseren Fixes mindestens phpunit und phpstan laufen lassen.
5. MUST NOT manuell Einzelstellen formatieren, wenn der Fixer sie zentral loesen kann.

Workflow

1. Baseline erfassen: composer cs:check.
2. Falls noetig fixen: composer cs:fix.
3. Diff fokussiert pruefen (Imports, Braces, Nebenwirkungen).
4. Qualitaetsgates laufen lassen.
5. CI-Dry-Run konfigurieren oder validieren.

Referenzen

• Lokaler Workflow: references/style-workflow.md
• CI Dry Run: references/ci-dry-run.md