# ADR-0008: Build-first-Strategie – verzögerte Hardware-Validierung

- **Status:** Angenommen (Auftraggeber-Freigabe)
- **Datum:** 2026-09-11
- **Phase:** 0/1 (übergreifend)
- **Bauplan:** §1, §1.1 Nr. 1/9/10, §29.7, §36 Nr. 16

## Kontext

Die Entwicklungsumgebung ist ein CPU-only-Linux-Container ohne Windows-GPU.
Der Auftraggeber wünscht am 2026-09-11 ausdrücklich: „erst fertig bauen und dann
auf Windows testen". PLAN.md §1 erlaubt Abweichungen vom normativen Ablauf,
wenn sie per ADR dokumentiert, technisch begründet und vom Auftraggeber
freigegeben werden. Diese Freigabe liegt mit der Anfrage vor.

## Entscheidung

1. Die Phasen 1–5 werden **plattformneutral vollständig gebaut** (Code, Tests
   auf CPU-Ebene, Schemas, Dokumentation), bevor Hardwaremessungen stattfinden.
2. Gate 0 und alle renderer-nahen Abnahmen werden **gesammelt in einem
   Windows-Durchlauf** nachgeholt (reverse validation). Reihenfolge dort:
   Portabilität → Decode/Residenz → Framezeit/DMX-Latenz → Adaptive Quality →
   Golden Images → Onefolder-Build.
3. Kein Gate wird vorher als grün gemeldet; STATUS.md führt die ausstehende
   Hardware-Validierung offen als Checkliste.

## Alternativen

- Streng planmäßig (Gate 0 zuerst): sicherer, aber ohne Windows-Zugang blockiert;
  vom Auftraggeber verworfen.
- Windows-Cloud-VM in der Entwicklungsumgebung: hier nicht verfügbar.

## Folgen und Risiken

- ADR-0004/0005 müssen ohne Messdaten vorläufig entschieden werden →
  ausdrücklicher Bestätigungsvorbehalt für den Windows-Durchlauf.
- Der D3D11-Elementpfad bleibt bis dahin unvalidiert. Absicherung: der
  Backend-Vertrag (§12.6) hält Korrekturen im Adapter lokal; Projekt-,
  Parameter-, DMX- und Web-API ändern sich nicht.
- Shader werden nur statisch bereitgestellt; Compile- und Golden-Image-Tests
  entstehen im Windows-Durchlauf.
- Fällt Gate 0 rot aus: gezielte Sanierung nach §1.1 Nr. 9 mit ERRORS.md-Eintrag;
  kein Architektur-Neubau erforderlich (Vertragsabsicherung).

## Messwerte / Nachweise

- CPU-Ebene: pytest/Ruff grün je Etappe (TEST_REPORT.md, fortlaufend).
- Hardware: ausstehend; Checkliste in STATUS.md.

## Freigabe

Auftraggeber: per Chat-Anfrage 2026-09-11 („erst fertig bauen und dann auf
Windows testen") – hiermit dokumentiert.