Adminator
1e51ef7def
- 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>
134 lines
5.5 KiB
Markdown
134 lines
5.5 KiB
Markdown
# 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
|