38 lines
1.2 KiB
Markdown
38 lines
1.2 KiB
Markdown
---
|
|
name: starterkit-php-style-ci
|
|
description: 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`
|