Range Escape Planner [AGPro Series]Range Escape Planner
🧠 Core Idea
Is price escaping a mature range with enough quality to monitor, or is the move still vulnerable to failure?
📌 Overview / What it does
Range Escape Planner is a chart-first breakout quality and trade planning tool built around mature range escape behavior.
Instead of printing a generic breakout signal, the script maps the active range boundary, projected escape corridor, invalidation edge, target guide, obstruction room, follow-through quality, and retest behavior. These components are converted into a 0-100 Escape Score and a clear next-action state.
The script produces a range boundary box, escape corridor, risk/target guide lines, compact labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that a range escape will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate breakout quality after price leaves a mature range.
Many breakout tools identify the break itself but stop before answering the practical planning questions: is the range mature, is the close beyond the boundary strong enough, is volatility expanding constructively, is there clean room, and where is the failure reference?
The design philosophy is simple: a range escape is only useful when it has maturity, confirmation, room, and a readable invalidation edge.
⚡ Why This Script Is Different
Most tools focus on basic range breaks, box breakouts, session opening ranges, or simple breakout markers.
This script does NOT clone Darvas Box Breakout Quality, does NOT rebuild an ORB model, and does NOT act as a generic consolidation breakout signal.
Instead, it treats the move as a planning problem. The main output is not a buy or sell command. It is a structured state that helps users separate VALID ESCAPE, ESCAPE WATCH, RANGE READY, OBSTRUCTION, FAILED, and WAIT RANGE conditions.
⚙️ Methodology
1. Context Detection
The script maps the prior range from previous bars and checks whether price is still inside, near an edge, or closing beyond the boundary.
2. Reference Mapping
It draws the mature range, escape edge, invalidation edge, projected target guide, and older swing obstruction room.
3. Reaction Evaluation
The model scores range maturity, close beyond range, volatility expansion, follow-through, retest quality, and obstruction room.
4. Visual Output
The result is displayed through centered zone labels, compact event labels, guide lines, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the range box shows the active mature range. The escape corridor shows the projected planning path from the broken boundary toward a target guide. Zone text is centered inside the boxes.
Labels = compact markers identify RANGE READY, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION, and FAILED context.
Colors = green highlights cleaner long-side escape quality, pink highlights short-side or failure risk, amber highlights review conditions, and indigo highlights watch or mature-range context.
Panel = the panel summarizes Escape Score, Range Age, Confirmation, Obstruction, and Action.
🚦 Signals & States
• RANGE READY → the range is mature and price is near an escape edge.
• ESCAPE WATCH → price has escaped the range, but follow-through or retest confirmation is still incomplete.
• VALID ESCAPE → the escape has stronger score alignment, follow-through or retest support, and acceptable obstruction context.
• RETEST HOLD → price retested the escape edge and held outside the prior range.
• OBSTRUCTION → the escape is active, but older structure may limit clean room.
• FAILED → price returned through the escape edge and the escape context is no longer clean.
• WAIT RANGE → no mature range escape context is active.
🔔 Alerts Logic
Alerts trigger when the planner detects RANGE READY, New Range Escape, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION REVIEW, or FAILED ESCAPE conditions.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest context appears when a range is mature, price closes beyond the range boundary, volatility expands constructively, candle follow-through improves, the broken edge holds on retest, and obstruction room remains acceptable.
When these components align, the Escape Score improves and the state can progress from RANGE READY to ESCAPE WATCH or VALID ESCAPE.
📊 When to Use
• During range breakout and range expansion review
• 4H and multi-hour swing charts where the range structure has enough space to breathe
• After price has spent time inside a defined range
• When evaluating whether a breakout has clean follow-through
• When a trader needs a visible invalidation edge and target-room reference
• On liquid markets where ATR, range, and swing structure are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• Very compressed intraday charts where labels and range boxes can crowd the price action
• News-driven spikes where price gaps far beyond the range
• Markets where older swing structure is too messy to define clean obstruction room
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Planning Side → controls Auto, Long Escape, or Short Escape mode.
• Range Lookback → controls how the prior range boundary is mapped.
• Minimum Range Age → defines how mature the range should be before stronger scoring.
• Minimum Close Beyond Edge ATR → controls how far price must close beyond the boundary before an escape registers.
• Follow-Through ATR → defines stronger post-escape movement beyond the edge.
• Retest Tolerance ATR → controls how close price can revisit the broken boundary and still count as a hold.
• Obstruction Lookback → controls how older swing structure is checked for clean room.
• Label and Panel Font Size → controls chart labels, centered box text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The range box defines the active decision area. The escape corridor shows the forward planning path. The invalidation, target, and obstruction lines add context without turning the chart into a crowded signal board.
The AGPro panel provides a compact decision summary with a merged blue title row and clear state hierarchy.
🧪 Practical Usage Workflow
1. Read the panel state and Escape Score.
2. Check whether the range is mature enough.
3. Review the escape corridor and edge line.
4. Check confirmation, retest behavior, and obstruction room.
5. Treat alerts as attention markers, then evaluate broader market context.
🔍 Interpretation Guidelines
Think in terms of escape quality, not prediction.
A stronger score means multiple structural conditions are aligned. A weaker score means the escape may be premature, poorly confirmed, obstructed, too noisy, or already failed.
OBSTRUCTION is especially important because a range can break cleanly while nearby older structure still limits practical room.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a Darvas Box clone
• Not an ORB model
• Not a generic support/resistance zone map
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, and older swing structure.
Timeframe differences can change how range maturity and escape quality appear. Volatility spikes can distort the score. Thin markets can create false escape or failure behavior.
Outputs should always be interpreted with broader market structure, liquidity, and risk context.
🧠 Market Context Notes
Range escape behavior is most useful when a readable balance area exists before expansion.
An escape with no follow-through may still be early. An escape with immediate obstruction may require extra caution. An escape that returns through the broken edge is treated as failed context, not as a new opposite prediction.
🧾 Use Case Examples
When price closes beyond a mature range, volatility expands from normal conditions, the candle holds beyond the edge, and older obstruction room is clean, the planner may classify the move as VALID ESCAPE.
When price breaks the boundary but quickly returns through the edge, the planner may classify the context as FAILED.
When price escapes but older swing structure is immediately ahead, the planner may show OBSTRUCTION even if the score is otherwise improving.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning a range breakout into a structured planning question: is the escape mature, confirmed, readable, and supported by clean room?
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, or follow-through.
This tool provides structured visual context and rule-based attention markers. It does not provide certainty.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how mature ranges resolve, how escape quality changes after the first break, and how obstruction room affects the readability of breakout continuation.
Indicador Pine Script®






















