Protocole de Bug — « Déclarer Haut et Fort »
La pile de calcul + moteur est nouvelle et évolue. Chaque échec reçoit ce protocole. Ne masquez jamais une erreur pour faire avancer une campagne — un bug avalé est pire qu'une étape bloquée. Un mécanisme confabulé (inventer pourquoi le moteur a fait quelque chose) est le pire mode d'échec : les pires moments de la campagne ont été des événements de réconciliation confabulés, un comportement de prix et un comportement de budget. Vérifiez, n'affirmez pas.
Précédent : un bug de sur-déploiement de totalBudget (un carnet avec un budget de 40% déployé à ~96% de la VNI au démarrage à froid) a été attrapé exactement de cette façon et a invalidé des semaines de résultats. La leçon générale est de mettre en quarantaine chaque résultat affecté par un défaut du moteur et de relancer uniquement après que le comportement soit corrigé.
Les cinq étapes (à appliquer à chaque échec)
- Arrêtez et caractérisez — est-ce la configuration (ma faute), les données (côté source) ou le moteur (NexusTrade) ? Reproduisez minimalement — le plus petit travail/backtest qui montre encore le problème.
- Journalisez-le immédiatement dans le
CAMPAIGN_LOG.mdde l'exécution sous un titre⚠️ BUG/ISSUE: symptôme, identifiants de reproduction, observé vs attendu, hypothèse actuelle (étiquetée hypothèse), ce qu'il bloque. - S'il s'agit d'un vrai bug de moteur/données, rédigez un document de transmission
<NOM>_BUG.mddans le répertoire d'exécution, basé sur le modèle dansreferences/BUG_TEMPLATE.md(résumé en une ligne, attendu vs observé, reproduction avec identifiants, hypothèse principale, alternatives à exclure, où chercher, impact sur les résultats). - Mettez en quarantaine les résultats affectés — marquez chaque backtest/étude exécuté avant la correction comme suspect/invalide. Relancez après la correction. Si le bug a gonflé l'effet de levier, les rendements ET les drawdowns sont gonflés et tout gène de balayage touché peut être non différenciant — revalidez tout.
- Dites-le à l'humain, de manière visible, dans le chat. Les bugs sont un livrable co-égal de l'épisode avec le résultat de trading — pas une source de gêne à contourner.
Ce qui N'est PAS un bug (échecs de signal honnête — ne les enregistrez pas)
- Un pli renvoyant
NoEligibleCandidate= un signal honnête, pas un bug. Élargissez la validation ; n'abaissez pas les seuils de certification. - Un nom mort / pas encore coté (par ex. SNDK en 2022) étant absent ou dans une liste de rejet sans valeurs fabriquées = comportement correct. Le moteur fabriquant une valeur de prix/indicateur pour un nom qui n'a pas été négocié EST un bug (voir engine-sanity).
- Une cible de réconciliation à un seul tick = la stratégie en direct accumule le reste lors des rééquilibrages quotidiens — dites-le, ne le re-diagnostiquez pas comme un bug (voir deploy-gate).
Liste de vérification « vérifiez, n'affirmez pas »
Avant d'écrire une affirmation sur le comportement du moteur dans un livrable, appuyez-la avec l'un des éléments suivants :
query_backtest_events / query_portfolio_events, un conditionFieldAudit, ou une reproduction minimale. « Le moteur probablement… » n'est pas une preuve.