バグプロトコル — 「大声で宣言」
コンピュート + エンジンスタックは新しく、動いています。すべての障害はこのプロトコルに従います。 キャンペーンを進行させるためにエラーを隠蔽してはいけません — 飲み込んだバグは、ステージがブロックされるよりも悪質です。捏造されたメカニズム(エンジンがなぜその動作をしたかを作り上げること)は最悪の障害モードです。キャンペーンの最悪の瞬間は、調整イベント、価格動作、予算動作を捏造したことによって生じました。確認し、断言しないでください。
前例: totalBudget の過剰配備バグ(コールドスタート時に40%の予算を配備するブックがNAVの約96%を配備)はまさにこの方法で発見され、数週間の結果を無効化しました。一般的な教訓は、エンジンの欠陥によって影響を受けたすべての結果を隔離し、動作が修正された後にのみ再実行することです。
5つのステップ(すべての障害に適用)
- 停止して特性評価 — 設定(自分の責任)、データ(ソース側)、エンジン(NexusTrade)のいずれか? 最小限で再現 — 問題を示す最小のジョブ/バックテスト。
- 即座にログに記録 — 実行の
CAMPAIGN_LOG.mdに「⚠️ BUG/ISSUE」見出しの下に記録:症状、再現ID、期待値と観測値、現在の仮説(hypothesis とラベル付け)、ブロックする内容。 - 実際のエンジン/データバグの場合、実行ディレクトリに
<NAME>_BUG.mdという引き継ぎドキュメントを作成。references/BUG_TEMPLATE.mdのテンプレートに従う(一行サマリー、期待値 vs 観測値、ID付き再現、主要仮説、除外すべき代替案、調査場所、結果への影響)。 - 影響を受けた結果を隔離 — 修正前に実行されたすべてのバックテスト/スタディを疑わしい/無効としてマーク。修正後に再実行。バグがレバレッジを過大にした場合、リターンとドローダウンの両方が過大評価され、触れたスイープ遺伝子は非差別化されている可能性がある — すべてを再検証する。
- チャットで人間に目立つように伝える。 バグは、トレーディング結果と同等のエピソードの成果物であり、回避すべき恥ずかしいものではありません。
バグではないもの(正直なシグナルの失敗 — これらはファイルしない)
- フォールドが
NoEligibleCandidateを返す = 正直なシグナルであり、バグではない。バリデーションを拡大し、認証フロアを削減しない。 - 死んでいる/まだ上場していない銘柄(例:2022年のSNDK)が存在しない、または拒否リストにあり、偽の値がない = 正しい動作。エンジンが取引されていない銘柄に対して価格/インジケーター値を捏造することはバグです(engine-sanity 参照)。
- 単一ティックの調整目標 = ライブ戦略は日次リバランスで残りを蓄積する — そのように説明し、バグとして再診断しない(deploy-gate 参照)。
確認し断言しないチェックリスト
エンジンの動作に関する主張を成果物に書く前に、次のいずれかで裏付ける:query_backend_events / query_portfolio_events、conditionFieldAudit、または最小限の再現。「エンジンはおそらく…」は証拠ではありません。