BB Width Compression Reversal¶

Research EA Spec: BB Width Compression Reversal¶

EA Identity¶

• EA name: REF0508_03_BB_Width_Compression_Reversal_v1
• Symbol: USDJPY
• Timeframe: H1
• Primary style: mean_reversion
• Entry mechanism: volatility_squeeze
• Regime target: ranging
• Position logic: fixed_sl

Research Thesis¶

BB Width Compression Reversal candidate generated from 2 research source(s). The strategy must preserve the source idea while keeping parameters broad enough to survive out-of-sample testing.

Source Evidence¶

• [FILTER] [MR] 市場クローズ前後 (23:00-01:30 JST) は日次決算ポジション調整で流動性低下、スキャルは避ける
• [SEASONAL] [MR] 月初の週 (1-5営業日) は機関の月次リバランスでドルが買われやすい傾向
• Mean Reversion Patterns
• [MR] Bollinger Bands σ=2 では統計的エッジがほぼない、σ=2.5以上で初めて意味を持つ (Aronson 2007)

Tradable Spec¶

以下5点は必須です。いずれかが欠落・空欄の場合、この仕様書は不合格としてください。

1. Entry logic（エントリー条件）¶

Step 1 — Squeeze detection on bar[2] (historical): squeezeActive = (bb_upper[2] - bb_lower[2]) < InpSqueezeThresh * atr[2] (default InpSqueezeThresh=1.5). Step 2 — Breakout on bar[1]: close[1] > bb_upper[1] for BUY, close[1] < bb_lower[1] for SELL. CRITICAL: squeeze (step 1) must be checked on bar[2], breakout (step 2) on bar[1]. Checking both on the same bar is a logical contradiction — squeeze implies narrow BB, breakout outside BB implies wide move. They cannot coexist on the same bar.

2. Exit logic（決済条件）¶

Take profit: (1) price returns to N-bar SMA (default N=20), OR (2) RSI crosses back through midline (from oversold: RSI[1] > 50; from overbought: RSI[1] < 50) — whichever fires first. Stop loss: ATR(14)*1.5 beyond entry bar, FIXED (never trail — trailing converts reversion to trend trade). Time exit: close at bar InpMaxBars (default=12) if neither TP nor SL triggered (stale reversion = structural failure, not an opportunity). Do NOT hold mean reversion trades past session boundary.

3. Risk management（資金管理）¶

Fixed fractional risk per trade, no martingale, no grid expansion, max one position per symbol, and hard daily loss guard.

4. Regime filter（レジームフィルター）¶

ranging regime confirmation using SAME timeframe indicators only

5. Invalidation condition（無効化条件）¶

If walk-forward repeatedly shows OOS PF < 1.0 or trades collapse after loosening entry filters, archive the DNA.

5点構造チェック: 上記5セクションがすべて記載されていることを確認してください。

Filters¶

• Spread and session filter
• Regime-specific confirmation filter from source evidence
• Minimum ATR activity filter

Logic Independence Requirements¶

必須チェック（実装前に確認すること）:

• エントリーシグナル変数とレジームフィルター変数は独立したデータ源または独立したlookbackから計算すること
• 悪い例: bullishCross = fastMA[1] > slowMA[1] と isBearishRegime = fastMA[1] < slowMA[1] を AND 結合 → 同一バーで両立不可、取引ゼロになる
• 正しいレジーム定義: slowMA[1] - slowMA[10] の傾き、上位足のMA方向、長い lookback（50本以上）の傾き
• 全フィルターを AND 結合した時に、理論上発火できるバーが存在することをスケッチで確認すること
• 逆張り戦略では「エントリー条件の否定 ≠ レジーム条件」になっているか必ず確認すること
• RSI・BB・ATR など同一インジケーターを「シグナル源」と「フィルター源」の両方に使う場合、同じバーで矛盾する不等式を要求していないか確認すること
• レジーム変数は1本のみ: bullishRegime (または uptrend 等) という bool 変数を1つ定義し、エントリー条件の AND に使うのはその1変数のみにすること。bullishRegime && regimeUp のように2本のレジーム変数を AND 結合することを禁止する。スロープ・価格位置・ADX など複数軸で判断したい場合は、それらを統合した1本の bool 変数にまとめてから AND に組み込むこと。

Optimization Envelope¶

• Relaxable: confirmation thresholds, ATR activity threshold, session window, signal confirmation bars.
• Not relaxable: stop-loss discipline, max one position, no fixed historical price levels.
• Special approaches ALLOWED if explicitly justified: broker asymmetry exploitation, martingale-with-withdrawal strategy, contrarian-sentiment fade, geopolitical event arbitrage, structural latency edges, quantum-inspired optimization, swarm-intelligence position sizing, game-theoretic market-making.
• For any special approach, you MUST include: (1) exact risk cap in pips/% per trade and per day, (2) kill-switch condition (when to stop trading), (3) explanation of why the structural edge is believed to exist, (4) fallback to standard rules if the edge disappears.
• Diversity mandate: if previous EAs in registry are mostly TREND, generate MR or BREAKOUT. If mostly technical indicator-based, generate anomaly/seasonal/regime-based or cross-disciplinary (physics/bio/psychology) approaches. Seek the UNEXPLORED angle.
• Initial optimization scope: 3-5 parameters only.
• If no trades: loosen entry confirmation first, then session restriction, then ATR threshold.
• If too many trades: strengthen regime filter and minimum signal distance.

Backtest Acceptance¶

• Backtest at least 18 months with the latest 3 months held out.
• Use walk-forward setting 6:2 when MT5 runner is available.
• Reject if OOS/IS PF ratio is below 0.70 or if OOS PF min is below 1.10.
• Reject if OOS trade count is below 15 trades per held-out window (minimum 30 total); first loosen entry filters before optimizing profit targets.

Overfitting Controls¶

• Keep each numeric parameter in a wide theory-backed range; do not tune to a single date range.
• Limit optimization to 3-5 core parameters in the first pass.
• Prefer regime filters with clear market meaning over curve-fitted thresholds.
• Stop improving the candidate after repeated NO_TRADE/LOW_SAMPLE failures.

Learning Feedback¶

• ledger: 1 prior infra/incomplete run(s) for this DNA
• ledger: improve: rerun the same candidate after repairing backtest artifacts

Implementation Guardrails¶

• [META] [RISK] [CONTRA] MT5 Strategy Testerは同名EAのinput値をキャッシュすることがあり、mq5側のinputデフォルトを変更して再コンパイルしても、BTでは前回値が使われる場合がある。inputデフォルト変更の検証では、別EA名/別ファイル名にするか、tester.ini/ExpertParametersで明示的に値を渡し、Testerログの「started with inputs」を必ず確認する。 (.clinerules)
• [RISK] [META] [CONTRA] 【部分決済後のコメント管理パターン】MQL5ではPositionModifyでコメントを変更できないため、TP1部分決済後の状態管理にコメントプレフィックスを使う設計は「二重部分決済」リスクを内包する。対策として: (1)グローバルなulong配列でTP1済みチケットを管理する、(2)部分決済後に残りを即クローズ→新コメントで再エントリーする、のいずれかのパターンを採用すること。 (.clinerules)
• [TREND] [BREAKOUT] [FILTER] [META] マルチタイムフレームEAでATR等のボラティリティ指標をCopyBufferする際、エントリー判定用の価格・MA（start_pos=1で確定足参照）とATR（start_pos=0で未確定バー参照）でstart_posが混在しやすい。設計方針として「全バッファのstart_posを統一する」か「ATRのみ最新値を使う理由をコメントで明記する」かを決めておくべき。 (.clinerules)
• [FILTER] SYMBOL_SPREADはポイント単位のlong値を返すため、価格単位に変換するには* _Pointを直接使用する (.clinerules)
• [FILTER] スキャルピングEAでXAUUSD等のスプレッド変動が大きい銘柄を扱う場合、pips単位ではなく価格単位（ドル）でスプレッド閾値・トレランスを指定する設計が適切。_Digits==2環境ではpips×_Pointが意図しない極小値になる (.clinerules)
• [TREND] [FILTER] スプレッドリトライパターン（予約エントリーのスプレッド不良時リトライ）: 予約フラグ方式でスプレッド不良時に即破棄せず、MAX_SPREAD_RETRY回まで次バーで再試行する設計。リトライカウンターは予約フラグと同時にリセットし、クールダウンや金曜制限等の他条件で予約破棄する際もリセットを忘れないこと。リトライの粒度（ティック単位 vs バー単位）を設計時に明確にすべき。 (.clinerules)
• [META] HistorySelect(0, TimeCurrent()) は全取引履歴を走査対象にするため、長期運用や多数の取引がある口座ではパフォーマンスに影響する。連敗カウント等の直近履歴のみが必要な場合は、開始時刻を限定する（例: TimeCurrent() - 30243600）か、最後のチェック時刻を記録して差分走査にする。 (.clinerules)
• [META] MQL5のOnTradeTransactionではDEAL_ENTRY_INOUTも処理対象に含めないと、ネッティング口座での約定イベントを捕捉できない場合がある (.clinerules)

Story Package¶

• Hook: AIが研究メモから自律発掘した「BB Width Compression Reversal」をEA化して検証。
• Blog angle: 研究アイデアは本当にMT5で再現できるのか、OOSで崩れるかまで公開する。
• Failure angle: 失敗時は NO_TRADE / LOW_SAMPLE / OVERFIT / HIGH_DD に分類して次の研究候補へ進む。