Files
breadcrumb-the-shire/.agents/skills/starterkit-php-style-ci/SKILL.md
fs c34e62d729 harden: restore gate baseline, split dev/prod PHP profile, atomic module runtime build
Phase A — Gate Reliability:
- Fix typography token violations in app-breadcrumb.css
- Switch QG-006 from composer cs:check to direct php-cs-fixer
- Align all docs/skills with new gate command

Phase B — Production Profile:
- Multi-stage Dockerfile: dev (xdebug) / prod (no xdebug)
- Compose files target explicit build stages

Phase C — Module Runtime Hardening:
- Atomic staging+swap build in ModuleRuntimePageBuilder
- SHA-256 fingerprint from manifest content + page entries
- 11 new regression tests for build safety and fingerprint drift

Task: STARTERKIT-HARDENING-ONPREM-001

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-24 20:13:16 +01: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=.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=.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