breadcrumb-the-shire/.agents/skills/core-guardrails/references/quality-gates.md

Quality Gates

Pflicht-Gates

1. docker compose exec php vendor/bin/phpunit
2. docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress
3. docker compose exec php vendor/bin/phpunit tests/Architecture/CoreStarterkitContractTest.php
4. docker compose exec php vendor/bin/php-cs-fixer fix --config=tools/php-cs-fixer/.php-cs-fixer.dist.php --dry-run --diff --verbose
5. bin/docs-link-check.sh
6. bin/codex-skills-sync.sh --check

Policy-Hinweis:

• Verbindliche Enforcement-Einteilung (required, manual_non_blocking, periodic_non_blocking) wird zentral in /.agents/checks/enforcement-policy.json gepflegt.

Struktur-Gates (schnell)

(rg 'new\s+[^\s(]+Factory\(' lib/Service || true) | wc -l
(rg --glob '!**/*Factory.php' 'new\s+[^\s(]+(Service|Gateway|Repository)\(' lib/Service || true) | wc -l
(rg "\b(accessServicesFactory|directoryServicesFactory|userServicesFactory|authServicesFactory|tenantServicesFactory|settingServicesFactory|userRepositoryFactory|authRepositoryFactory|authGatewayFactory)\(" pages lib templates web || true) | wc -l
(rg -n 'new\s+[^\s(]+(Service|Gateway|Repository)\(' pages -g '*.php' || true) | wc -l
(rg -n '\bDB::' pages -g '*.php' || true) | wc -l
(rg -n 'app\([^\n]*Factory::class\)->create' pages/admin -g '*.php' || true) | wc -l
(rg -n 'Factory::class' pages/admin -g '*.php' || true) | wc -l
(rg -n 'ApiResponse::readJsonBody\(' pages/api/v1 -g '*.php' || true) | wc -l

Erwartung: jeweils 0.

JS-Scope

• Bei JS-Aenderungen Browser-Smoke mit DevTools-Console durchfuehren.
• Erwartung: keine neuen JS-Errors.

Docs-/Skills-Gates (schnell)

1. bin/docs-link-check.sh
   • prueft Doku-Links in README.md, docs/**, .agents/skills/** und .agents/**
   • .agents/runs/** ist standardmaessig ausgeschlossen (historische Artefakte)
2. bin/codex-skills-sync.sh --check
   • prueft Drift zwischen Repo-Skills und ~/.codex/skills

Berichtspflicht

• Bei jedem Gate klar angeben: passed / failed / not run.
• Bei failed den blocker explizit benennen.