Files
breadcrumb-the-shire/.agents/skills/starterkit-php-style-ci/SKILL.md
fs 0bf7f62fd8 chore: move php-cs-fixer config into tools
- relocate .php-cs-fixer.dist.php to tools/php-cs-fixer/.php-cs-fixer.dist.php

- update composer scripts, docs, quality gates, and style skill references

- keep finder scope stable via project-root resolution

- fix pre-existing unused imports reported by php-cs-fixer
2026-04-01 16:38:58 +02:00

1.4 KiB

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 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