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

---
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 `vendor/bin/php-cs-fixer fix --config=tools/php-cs-fixer/.php-cs-fixer.dist.php --dry-run --diff --verbose` fuer nicht-mutierende Pruefung nutzen (Convenience-Alias: `composer cs:check`).
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: `vendor/bin/php-cs-fixer fix --config=tools/php-cs-fixer/.php-cs-fixer.dist.php --dry-run --diff --verbose`.
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`