chore(agents): implement v2 hardening and enforcement-ready QA

docs/howto-gitea-required-checks.md

@@ -0,0 +1,43 @@
+# Gitea Required Checks (Phase 1: enforcement-ready)
+
+Letzte Aktualisierung: 2026-04-01
+
+## Ziel
+
+QA-Pflichtchecks fuer CoreCore in Gitea vorbereiten, ohne sie sofort als Merge-Blocker zu aktivieren.
+
+## Enthaltene Basis
+
+- Beispiel-Workflow: `/.gitea/workflows/qa-required.yaml`
+- Pflicht-Gate-Einstieg: `/bin/qa-required.sh`
+- Policy-Quelle: `/.agents/checks/enforcement-policy.json`
+
+## Was `qa-required` abdeckt
+
+`bin/qa-required.sh` fuehrt die aktuell blockenden Gates aus:
+
+- `QG-001` PHPUnit
+- `QG-002` PHPStan
+- `QG-003` Architecture Core Contract
+- `QG-006` PHP Style Check
+- `QG-008` Docs link integrity
+- `QG-009` Codex skills sync
+
+## Phase-1 Setup (noch nicht blockend)
+
+1. Sicherstellen, dass der Gitea-Runner Docker + Docker Compose ausfuehren darf.
+2. Workflow-Datei nach `.gitea/workflows/qa-required.yaml` uebernehmen.
+3. PR gegen `main` oeffnen und pruefen, dass Job `qa-required` gruen laeuft.
+4. Branch Protection noch **nicht** auf "required" setzen.
+
+## Phase-2 Aktivierung (blockend)
+
+1. Branch-Protection fuer `main` aktivieren.
+2. Statuscheck `qa-required` als required markieren.
+3. Optional: weitere Jobs ergaenzen (z. B. nightly/extended Checks), aber nur `qa-required` blockend setzen.
+
+## Hinweise
+
+- `QG-005` (Browser-Smoke) bleibt manuell/non-blocking.
+- `QG-007` (composer-unused) bleibt periodisch/non-blocking.
+- Fuer lokale Ausfuehrung: `bin/dev qa-required` bzw. `bin/dev qa-extended`.