breadcrumb-the-shire/tools/codex-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

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/**, tools/codex-skills/** und agent-system/**
   • agent-system/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.