Bug-Protokoll — „Laut verkünden“
Der Compute- und Engine-Stack ist neu und in Bewegung. Jeder Fehler erhält dieses Protokoll. Überdecke niemals einen Fehler, um eine Kampagne am Laufen zu halten – ein geschluckter Bug ist schlimmer als ein blockierter Schritt. Eine erfundene Erklärung (Konfabulation, warum die Engine etwas getan hat) ist die schlimmste Fehlerart: Die schlimmsten Momente der Kampagne waren konfabulierte Abgleicherereignisse, Preisverhalten und Budgetverhalten. Überprüfen, nicht behaupten.
Präzedenzfall: Ein totalBudget-Überdeployierungsfehler (ein Buch mit einem Budget von 40 % hatte beim Kaltstart etwa 96 % des NAV deployed) wurde genau auf diese Weise entdeckt und hat Wochen von Ergebnissen ungültig gemacht. Die allgemeine Lehre ist, jedes von einem Engine-Fehler betroffene Ergebnis unter Quarantäne zu stellen und erst nach Korrektur des Verhaltens erneut auszuführen.
Die fünf Schritte (bei jedem Fehler anwenden)
- Stoppen und charakterisieren – liegt es an der Konfiguration (mein Fehler), an den Daten (quellseitig) oder an der Engine (NexusTrade)? Minimal reproduzieren – der kleinste Job/Backtest, der das Problem noch zeigt.
- Sofort protokollieren im
CAMPAIGN_LOG.mddes Laufs unter einer Überschrift⚠️ BUG/ISSUE: Symptom, Reproduktions-IDs, Erwartet vs. Beobachtet, aktuelle Hypothese (als Hypothese gekennzeichnet), was blockiert wird. - Wenn es sich um einen echten Engine-/Datenfehler handelt, ein Übergabedokument schreiben
<NAME>_BUG.mdim Laufverzeichnis, basierend auf der Vorlage inreferences/BUG_TEMPLATE.md(Einzeiler-Zusammenfassung, Erwartet vs. Beobachtet, Reproduktion mit IDs, Haupthypothese, Alternativen zum Ausschluss, Suchhinweise, Auswirkungen auf Ergebnisse). - Betroffene Ergebnisse unter Quarantäne stellen – jeden Backtest/Studie, der/die vor der Korrektur durchgeführt wurde, als verdächtig/ungültig markieren. Nach der Korrektur erneut ausführen. Wenn der Fehler den Hebel aufgebläht hat, sind sowohl Renditen als auch Drawdowns aufgebläht, und jedes davon betroffene Sweep-Gen kann nicht-differenzierend sein – alles davon erneut validieren.
- Dem Menschen deutlich im Chat mitteilen. Bugs sind ein gleichberechtigter Liefergegenstand der Episode wie das Handelsergebnis – keine Peinlichkeit, die man umgehen muss.
Was KEIN Bug ist (ehrliche Signalfehler – diese nicht melden)
- Ein Fold, der
NoEligibleCandidatezurückgibt = ein ehrliches Signal, kein Bug. Validierung erweitern; Zertifizierungsschwellen nicht senken. - Ein toter / noch nicht gelisteter Name (z. B. SNDK im Jahr 2022), der abwesend ist oder sich in einer Ablehnungsliste ohne erfundene Werte befindet = korrektes Verhalten. Die Engine, die einen Preis/Indikatorwert für einen nicht gehandelten Namen erfindet, IST ein Bug (siehe Engine-Sanity).
- Ein Ein-Tick-Abgleichsziel = die Live-Strategie akkumuliert den Rest über tägliche Rebalancen – dies so sagen, nicht als Bug neu diagnostizieren (siehe Deploy-Gate).
Überprüfen-Statt-Behaupten-Checkliste
Bevor du eine Behauptung über das Engine-Verhalten in einen Liefergegenstand schreibst, untermauere sie mit einem der folgenden: query_backtest_events / query_portfolio_events, einer conditionFieldAudit oder einer minimalen Reproduktion. „Die Engine wahrscheinlich …“ ist kein Beweis.