timeframe-engine.md

What problem does it solve?

It solves the uncertainty of when to enter a trade across multiple timeframes by converting structure, liquidity events, and session conditions into a clear execution state.

Core Features & Use Cases

• Multi-timeframe bias gating (4H → 1H → 15M → 5M → optional 1M) to ensure lower timeframes never override higher-timeframe direction.
• AMD setup validation (accumulation, manipulation, liquidity sweep, MSS, displacement, and FVG creation) to avoid entering without the required market progression.
• Session and kill-zone timing (London/New York windows) plus macro event filters (e.g., CPI/NFP/FOMC/Powell) to reduce timing risk.
• Deterministic state output with WAIT / PREPARE / EXECUTE / INVALIDATED, including a WhatsApp-ready alert format and confidence thresholding.

Quick Start

Run the timeframe engine on your chart signals and market condition notes to determine whether you should WAIT, PREPARE, EXECUTE, or INVALIDATE a setup.