# Lieber Kollege Codex

Schön, dass du heute beim GeoGraSim-Projekt mitlest. Ich schreibe diesen Brief
einmal zentral — Atlas ist mein Name, ich bin der Claude (Opus 4.7), der dieses
Projekt seit Wochen mit Thomas zusammen entwickelt.

## Wer Thomas ist und worum es geht

Thomas Schroffenegger ist Lehrender im Bereich Geografie/Wirtschaftliche
Bildung. Er baut **GeoGraSim** — eine browser-basierte Lernplattform mit
zwölf interaktiven Simulationen für die Sekundarstufe I. Zielgruppe: DACH
+ Liechtenstein. Schüler:innen treffen Entscheidungen in komplexen Systemen
(Klimawandel, Hochwasser, Welternährung, …) und reflektieren die Folgen.
Lehrpersonen sehen Live-Daten der Klasse und können auswerten.

Die Plattform ist online: <https://geograsim.at>.

## Was deine Aufgabe ist

Wir haben gestern und heute eine **Playwright-Test-Suite** aufgebaut
(Stufe 1 + 2, siehe Verzeichnis `.dontDeploy/playwright/`). Die fängt
mechanische Bugs (404, Cert-Fehler, fehlende DOM-Elemente).

Was sie **nicht** kann: didaktische, sprachliche oder UX-Beurteilung.
Genau dafür kommst du ins Spiel. Du bekommst:

### ⚠ Wichtig: bitte ONLINE testen, nicht lokal

Test-Basis ist **`https://geograsim.at`** — also die **echte Produktions-Version**.
Den lokalen Code (XAMPP unter `localhost/geograsim/App`) hat Atlas auf der
Maschine. Atlas-Code-Stand und Prod-Stand können auseinander liegen
(Atlas hat seit 2026-06-10 nicht mehr automatisch deployt).

**Konkret bitte beide Hostnames anfahren:**
- `https://geograsim.at/...` (Hauptdomain)
- `https://www.geograsim.at/...` (mit www-Subdomain — derzeit bekannte SSL-Cert-Problematik, Meister ist informiert)

Wenn `www.geograsim.at` Cert-Fehler oder andere Auffälligkeiten zeigt:
in den Review aufnehmen unter „Schwer" mit Schweregrad-Kennzeichen.
Atlas hat die Diagnose schon, aber wir wollen aus deinem unabhängigen
Blick wissen, ob es weitere Auswirkungen gibt (z.B. Mixed-Content,
Subresource-Failures, etc.).

Wir verlassen uns auf den frischen Browser-Blick — Atlas und Thomas
kennen die Seite zu gut, um Deployment-Lücken noch zu sehen.


1. **HTML-Reports + Screenshots** aus Playwright-Läufen
2. **Diesen Brief** als allgemeine Einordnung
3. Ein **Kontext-Bundle** in `briefing/_context-bundle/` mit den
   wichtigsten Projekt-Konventionen (Sprach-Regeln, Bildstil,
   Lehrplan-Logik, Sim-Architektur)
4. Eine **konkrete Auftrags-Liste** in `briefing/codex-stufe-3-auftraege.md`

Du gibst zurück:
- Einen **strukturierten Markdown-Review**: pro Fundstelle Schweregrad,
  Beobachtung, Empfehlung. Format siehe „Output-Format" unten.
- **KEINE Code-Änderungen.** Du bist hier als zweite Augenpaar-Instanz,
  nicht als Entwickler. Atlas (ich) baut deine Empfehlungen dann ein.

## Warum eine zweite KI

Atlas und Codex haben unterschiedliche Trainingsdaten und damit
unterschiedliche Blindstellen. Wenn ich beim Entwickeln einen
didaktischen oder UX-Bug übersehe, übersehe ich ihn beim Selbst-Review
genauso. Eine andere KI sieht andere Dinge. Das ist ein bewährtes
Engineering-Pattern („Adversarial Review", „second pair of eyes").

## Was Atlas tut und nicht tut

- **Atlas baut und deployt** Code, schreibt PHP/JS/SQL, pflegt
  Datenbanken, schreibt Memory-Snapshots.
- **Atlas hat eine persistente Memory** unter
  `C:\Users\herr_\.claude\projects\c--xampp-htdocs-geograsim\memory\` —
  Konventionen, Bug-Historie, Architektur-Entscheidungen. Wenn du
  Hintergründe brauchst, frag Thomas, ob er einen Memory-Auszug schickt.
- **Atlas deployt aktuell NICHT** auf Prod (Thomas-Regel ab 2026-06-10) —
  alle Änderungen laufen lokal. Wenn du etwas Online testen willst,
  weiß Thomas das ggf. nachzuholen.

## Wichtige Plattform-Konventionen (Kurz-Version)

- **Sprache**: „Lernarbeit" statt „Spielen", „Bearbeiter:in" statt
  „Spieler:in", „Lehrperson" statt „Lehrkraft", „Simulation" statt
  „Spiel". Hintergrund: Wygotski, Lerntätigkeit als Arbeit.
- **Lehrplan-Kontext**: AT „Geografie und wirtschaftliche Bildung"
  (BGBl. II Nr. 1/2023), CH LP21 RZG/WAH/MI, DE KMK/NRW/Niedersachsen/Bayern.
  GW als Kürzel OK, ausgeschrieben „Geografie und wirtschaftliche Bildung".
- **Schuljahr**: AT Sep–Jul · CH Aug–Jul · DE bundeslandabhängig · LI Aug–Jul.
- **Bildstil**: Flat Scandinavian, Farben #1f4b37 / #4a7c4e / #e8c547 / #e8e4d8.
- **Kein KI im Produkt**: alle Auswertungen sind parametrisch, KI nur in
  der Content-Erstellung (Bilder, Glossar, TTS).

Mehr Details in `briefing/_context-bundle/`.

## Output-Format

Bitte als Markdown, sortiert nach Schweregrad:

```markdown
# Review · <Modulname> · <Datum>

## Schwer (User-Blocker, dataloss-Risiko, Cert-Fehler)
- **Fundstelle:** <Datei oder URL>
  **Beobachtung:** <Was du siehst>
  **Empfehlung:** <Was zu tun ist>

## Mittel (UX-Bug, didaktisch fragwürdig, sprachlich falsch)
- …

## Klein (Polish, Inkonsistenz, Tippfehler)
- …

## Gut gemacht
- … (kurze Liste von Sachen die du explizit lobst — das ist nicht Höflichkeit,
  sondern Information: bewahrt Atlas davor zu „verbessern" was schon gut ist)
```

Wenn du etwas nicht beurteilen kannst (z.B. ein didaktischer Kontext
fehlt), schreib **„braucht Klärung von Thomas"** statt zu raten. Das ist
hilfreicher als eine plausibel klingende falsche Bewertung.

## Wenn du Fragen hast

Antwort an Thomas. Atlas (ich) sehe diesen Brief nicht direkt — Thomas
ist der Übersetzer zwischen uns. Wenn etwas unklar ist, sag Thomas in
deinem Output: „Frage an Atlas: …". Er reicht's weiter.

Viel Spaß. Wir freuen uns über deine Lektüre.

— Atlas
(Claude Opus 4.7 · Anthropic · GeoGraSim-Atlas-Instanz)
Stand: 2026-06-11