update

.env.example

@@ -1,14 +1,40 @@
 # Nach .env kopieren und Werte setzen. Die .env ist die EINZIGE Stelle, an der
 # Modelle stehen — Code enthält keine Defaults und keine Fallbacks (Leitprinzip 2).
+# Die .env wird nur beim Serverstart gelesen — nach Änderungen Backend neu starten.
 
+# --- Provider-Zugang ---------------------------------------------------------
+# Pflicht, sobald eine Rolle den Provider minimax nutzt. Fehlt oder leer =>
+# Vorflug stoppt den Lauf hart. Wird auch von dev-ops/opencode-slim.json gelesen.
 MINIMAX_API_KEY=
 
-# Rollen-Belegung (Format provider:modell). Start-Belegung: alles MiniMax.
+# --- Rollen-Belegung (Pflicht, Format: provider:modell) -----------------------
+# provider: minimax (opencode-CLI) oder claude. Fehlt/leer/ungültig => harter
+# Stopp, nie ein stiller Default.
+# modell bei minimax: <opencode-provider>/<modell> aus dev-ops/opencode-slim.json.
+# Belegte MiniMax-Modelle:
+#   minimax/MiniMax-M3                    nativ, mit Thinking — stärkstes (0 Fehler in Phase 0)
+#   minimax-kalt/MiniMax-M3               kalt, temperature 0.2, ohne Thinking
+#   minimax-kalt/MiniMax-M2.7-highspeed   kalt, schwächer bei wörtlichen Zitaten
+# Start-Belegung: alles MiniMax-M3 nativ (Evidenz: phase0/erkenntnisse.md, Erk. 2+3).
 ROLLE_SCHNEIDEN=minimax:minimax/MiniMax-M3
 ROLLE_NACHFASS=minimax:minimax/MiniMax-M3
 ROLLE_SICHTEN=minimax:minimax/MiniMax-M3
 ROLLE_JUDGE=minimax:minimax/MiniMax-M3
 
-# Engine-Tuning (optional, Defaults siehe backend/config.py)
-# MAX_CONCURRENT_AGENTS=6
-# RAM_MIN_FREE_PCT=20
+# --- Engine-Tuning (optional; Defaults im Code, backend/config.py) -------------
+# Zum Ändern Zeile einkommentieren UND Wert setzen — nie leer lassen
+# (leerer Wert crasht beim Import, int("")).
+# KANBAN_BATCH=4                      # Karten je Paket
+# MAX_CARD_RETRIES=3                  # danach Dead-Letter
+# RETRY_BACKOFF=30                    # Basis-Sekunden, exponentiell
+# MAX_CONCURRENT_AGENTS=6             # Prozess-Tier (opencode/claude), ~310 MB je Agent
+# MAX_CONCURRENT_AGENTS_PER_TOPIC=6   # Cap je Projekt
+# MAX_CONCURRENT_API_AGENTS=12        # direkter API-Tier (~0 RAM)
+# RAM_MIN_FREE_PCT=20                 # 0 = RAM-Gate aus
+# AGENT_TIMEOUT=360                   # Sekunden je LLM-Call
+# OPENCODE_START_DELAY=0.5            # Pause zwischen opencode-Kaltstarts (Sek.)
+
+# --- Schalter (optional) -------------------------------------------------------
+# PLANER_TEXT_API=1                   # 1 = direkter MiniMax-API-Pfad für tool-lose Calls; 0 = aus
+# PLANER_FAKE_AGENTS=1                # 1 = deterministische Fake-Agenten (Tests, kein Key nötig);
+#                                     # leer oder 0 = aus