20 lines
1.4 KiB
Markdown
20 lines
1.4 KiB
Markdown
# AGENTS.md – Hinweise für KI-Agenten
|
||
|
||
> Stand: 29.10.2026 · für KI-Assistenten, die Prüfer beim Prüfen oder Ergänzen von Fragen unterstützen.
|
||
|
||
## Lesen vor der Arbeit
|
||
1. [README.md](README.md) – Aufbau, Format einer Frage, Build.
|
||
2. [docs/question_rules.md](docs/question_rules.md) – verbindliche Regeln für Fragen.
|
||
3. [docs/exam_format.md](docs/exam_format.md) – Prüfungsformat und Objectives 5.0 (mit Quellen).
|
||
4. [docs/decisions.md](docs/decisions.md) – Festlegungen; nicht ohne Rücksprache ändern.
|
||
|
||
## Regeln
|
||
- Sprache Deutsch mit Umlauten; Datei-/Schlüsselnamen englisch (ASCII).
|
||
- Keine Erfindungen: Befehle, Optionen, Dateipfade nur, wenn belegbar (Manpage, offizielle Doku); Unsicheres als unsicher kennzeichnen, nicht als Frage aufnehmen.
|
||
- Distraktoren eindeutig falsch; bei Zweifel lieber Option ersetzen.
|
||
- Nach jeder Änderung `python3 tools/build_bank.py -c`; Fehler beheben, bevor gebaut wird.
|
||
- `js/bank.js` und `dist/` sind erzeugt – nie von Hand ändern. `tools/.psk` nie ausgeben oder weitergeben.
|
||
- Code bleibt ohne Build und ohne externe Abhängigkeiten lauffähig unter `file://` (kein `fetch`, keine ES-Module, kein CDN).
|
||
- Datei-Header (`@file`, `@brief`, `@author`, `@owner`, `@assist`, `@version`) erhalten und bei Änderung `@version` erhöhen; `@author` ist immer ein Mensch, nie die KI.
|
||
- Tests: siehe [docs/REVIEW.md](docs/REVIEW.md#tests).
|