Files
geograsim/.dontDeploy/playwright/briefing/CODEX-BRIEF.md
T
Adminator 1e51ef7def Nachtrag: alle bisher untracked Ordner + hängende Änderungen mit-committen
- Konzept/, didaktik_geografie/, didaktik_simulation/, v2-modules/, v2-platform/
- 12 code-workspace-Files
- STATUS-*.md
- viele M/D/R-Änderungen an bereits getrackten Files
- .gitignore verstärkt: **/.humaninput/, **/secret_keys.txt

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-07-08 02:27:02 +02:00

5.5 KiB
Raw Blame History

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 SepJul · CH AugJul · DE bundeslandabhängig · LI AugJul.
  • 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:

# 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