Setup Lifecycle Tracker [AGPro Series]Setup Lifecycle Tracker
🧠 Core Idea
What stage is this setup in right now: forming, armed, triggered, invalidated, or expired?
📌 Overview / What it does
Setup Lifecycle Tracker is a chart-first setup planning tool that follows a developing market structure through a defined lifecycle window.
Instead of showing another isolated signal, it maps the setup stage, trigger rail, invalidation rail, expiry marker, time risk, and a 0-100 lifecycle quality score directly on the chart.
The script does not predict price, automate execution, or tell users what to trade. It organizes setup context so the trader can evaluate whether the setup is still valid, still early, close to activation, already invalidated, or simply too old.
🎯 Purpose & Design Philosophy
This script was built for traders who want a cleaner way to manage setup timing.
Many setups look interesting when they first appear, but they often decay, trigger too late, or lose their invalidation logic before the trader reacts. Setup Lifecycle Tracker fills that gap by turning setup timing into a visible planning structure.
The design philosophy is simple: a setup should have a stage, a deadline, a risk reference, and a clear next-action state. Without those elements, the chart can become another collection of loose signals.
⚡ Why This Script Is Different
Most tools focus on entry markers, setup scores, or generic support and resistance levels.
This script does NOT try to clone a setup scorecard, create a buy/sell system, or build a broad support/resistance map.
Instead, it tracks the lifecycle of one active setup window. It shows whether the setup is forming, armed near the trigger rail, already triggered, invalidated by its risk rail, or expired because too much time has passed.
⚙️ Methodology
1. Context Detection
The script reads trend context, recent range structure, volatility, candle behavior, and volume support to decide whether a clean setup window can be tracked.
2. Reference Mapping
When a setup forms, the script creates a trigger rail, an invalidation rail, and a lifecycle window between them.
3. Reaction Evaluation
The model evaluates setup maturity, trigger proximity, confirmation strength, time decay, and invalidation distance to produce a 0-100 lifecycle score.
4. Visual Output
The active lifecycle window, stage labels, trigger rail, invalidation rail, expiry marker, candle tint, and panel summarize the current state.
🗺️ How to Read the Chart
Zones = the lifecycle window between trigger and invalidation.
Labels = current lifecycle stage and optional score.
Colors = stage context:
• Blue / indigo = forming
• Yellow = armed
• Green = triggered
• Red / pink = invalidated or expired
Panel = the compact AG Pro summary showing Stage, Quality Score, Time Risk, Invalidation, and Action.
🚦 Signals & States
• FORMING → a setup window has been detected but is not yet close enough to the trigger rail.
• ARMED → price is close enough to the trigger rail and the lifecycle score is strong enough to deserve attention.
• TRIGGERED → the tracked setup moved beyond its configured trigger condition.
• INVALIDATED → price crossed the invalidation rail and the setup context is no longer valid.
• EXPIRED → the setup stayed active too long without a useful lifecycle resolution.
🔔 Alerts Logic
The script includes alerts for:
• New lifecycle window forming
• Setup armed near the trigger rail
• Setup triggered
• Setup invalidated
• Setup expired
• High-quality lifecycle threshold reached
Alerts are attention markers only. They are not trade instructions, automated entries, or guaranteed outcome signals.
🧩 Confluence Logic
The lifecycle score becomes stronger when setup maturity, trigger proximity, confirmation strength, time health, and invalidation fit align.
For example, a setup that is mature, close to the trigger rail, supported by directional candle behavior, and not too close to invalidation will generally score better than an old setup with weak confirmation and high time risk.
📊 When to Use
• Breakout preparation
• Pullback continuation planning
• Range compression before expansion
• Setups that need a time limit
• Charts where invalidation needs to stay visible
• Traders who want to separate early setups from late setups
⚠️ When NOT to Use
• Extremely low-liquidity markets
• Charts with unreliable volume and erratic candles
• Very noisy micro timeframes
• Extreme volatility spikes where ATR-based references expand too quickly
• Situations where the user wants a direct buy/sell signal instead of a planning map
🎛️ Key Inputs
• Setup Side → selects automatic, long-side, or short-side lifecycle tracking.
• Trigger Model → controls how the setup moves into TRIGGERED state.
• Setup Lookback → defines the forming range used for trigger and invalidation mapping.
• Sensitivity → changes how strict the lifecycle detection and confirmation logic feels.
• Expiry Bars → controls how long an untriggered setup can stay active.
• Minimum Quality Score → defines the threshold for stronger lifecycle contexts.
• Panel / Label Settings → control panel position, theme, font size, label size, and label density.
🖥️ Interface & Visual Design
The interface is built around a single chart-first lifecycle window.
The panel is intentionally compact. It does not replace the chart; it summarizes the active state so the user can quickly read the setup stage, score, time risk, invalidation, and next context action.
Labels are kept moderate and offset away from candles to preserve readability.
🧪 Practical Usage Workflow
1. Read the panel stage.
2. Check the lifecycle window between trigger and invalidation.
3. Watch whether the setup moves from FORMING to ARMED.
4. Review the trigger rail and invalidation rail.
5. Use the expiry marker to avoid stale setup interpretation.
6. Confirm the broader market context before making any decision.
🔍 Interpretation Guidelines
A high lifecycle score means the current setup context is cleaner according to the script's rule set.
An ARMED state means the setup is close to the trigger area, not that a trade must be taken.
An EXPIRED state means time quality has degraded.
An INVALIDATED state means the tracked setup lost its mapped risk reference.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading tool
• Not a guaranteed signal system
• Not a generic support/resistance mapper
• Not a clone of Setup Quality Scorecard
⚠️ Limitations & Transparency
Lifecycle windows depend on lookback, ATR behavior, and recent structure.
Different timeframes can produce different setup stages.
High-volatility conditions may expand rails and change score behavior.
Low-liquidity symbols can create unstable ranges and misleading candle structure.
🧠 Market Context Notes
Setup lifecycle quality is strongest when structure, volatility, and timing align.
A setup can be technically visible but still weak if it is too old, too far from the trigger rail, too close to invalidation, or unsupported by confirmation behavior.
🧾 Use Case Examples
When price compresses below a range edge and the lifecycle window turns ARMED, the trader can observe whether the trigger rail is reached before the expiry marker.
When a setup remains FORMING for too long, the time risk row helps identify whether the context is becoming stale.
When price crosses the invalidation rail, the script marks the lifecycle as INVALIDATED so the previous setup is no longer treated as active.
🧱 System Philosophy
AGPro tools are designed to help traders read market context with structure and restraint.
Setup Lifecycle Tracker follows that philosophy by converting setup timing into a visible planning workflow instead of adding another isolated signal marker.
🔐 Non-Promise Statement
No script can provide certainty.
No score, state, label, or alert guarantees future price behavior.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical use only.
It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users remain responsible for their own decisions, risk management, and position sizing.
📚 Educational Note
The main educational purpose of this script is to help users think in lifecycle stages: setup formation, activation risk, invalidation, time decay, and context review.
Indicator
