1. Breakout / Breakdown patterns — Stocks breaking out of consolidation ranges, trendlines, or chart patterns (flags, triangles, rectangles) on above-average volume are primary candidates.
2. Support-Resistance levels — Key horizontal levels where price has historically reversed or stalled. These define entry zones, stop-losses, and targets.
3. Volume-Price action — Volume confirms conviction. A breakout without volume is suspect. A pullback on declining volume to support is healthy. Delivery percentage adds a layer of quality to volume analysis — in Indian markets, high volume with low delivery % (below 30%) often means intraday speculation rather than genuine accumulation. For swing/positional trades, look for delivery % above 35-40% on breakout days.

1. Determine the universe — Nifty 50, Nifty 200, a specific sector, or user-specified list
2. Use web search to pull recent price action and market context (broad scan)
3. Screen for setups matching the criteria below — shortlist 4-6 candidates
4. Verify CMP for each shortlisted stock with individual searches before calculating any levels
5. Output a watchlist with ticker, setup type, key levels (support/resistance/breakout level), and a one-line rationale

.xlsx

• Brief mode — triggers: "quick take", "brief", "short", "just the levels", "tldr", or when the user asks about multiple stocks in one message. Output: Verdict + Key Levels + Conviction Score + Safety Checks + GTT Format. Skip the narrative sections.
• Detailed mode — triggers: "full analysis", "deep dive", "detailed", or when user asks about a single stock with no brevity cue. Output: All 12 sections of the trade plan template.
• Default: Detailed for single-stock analysis, Brief for multi-stock queries. When unsure, go detailed — the user can always say "shorter" and you switch.

undefined

• Resistance: ₹XXX, ₹XXX
• Support: ₹XXX, ₹XXX
• Breakout/Breakdown Level: ₹XXX
• Circuit Limit: ±X% (for non-F&O stocks)

• Type: [Breakout / Pullback to support / Breakdown / Range trade]
• Timeframe: [Swing (2-5 days) / Positional (1-4 weeks)]
• Conviction Score: [X/10 (Grade)] — show the full scorecard table from references/conviction-scoring.md

• Entry: ₹XXX (trigger condition)
• Stop Loss: ₹XXX (reasoning — e.g., below support, below breakout candle)
• Target 1: ₹XXX (next resistance / measured move)
• Target 2: ₹XXX (extended target)
• Risk:Reward: 1:X.X

• Risk per trade: 1-2% of capital (default, user can customize)
• SL distance: ₹XXX (X.X%)
• Position size: For ₹[CAPITAL], buy [QTY] shares (₹[AMOUNT] deployed)

• ASM/GSM status: [Clear / Under surveillance]
• F&O ban: [No / Yes — flag]
• Circuit limit: [±X%]
• Earnings proximity: [Date or "No earnings nearby"]
• India VIX: [Level — and what it means for sizing]

• Volume breakout: Stock closing above a resistance level or consolidation range with volume significantly above its 20-day average (1.5x+ is a good threshold) AND delivery percentage above 35%. High volume with low delivery (<30%) means intraday churn, not real accumulation — treat such breakouts with suspicion.
• Pullback to breakout zone: Stock that recently broke out, pulled back to the breakout level on declining volume, and is holding. The former resistance becomes support.
• Base breakout: Stock emerging from a multi-week consolidation (tight range, declining volume) with a volume spike and healthy delivery %

• Support bounce: Stock testing a well-established support level (tested 2+ times) with volume drying up on the decline, suggesting sellers are exhausted
• Higher-low formation: Stock making a series of higher lows, approaching resistance — potential breakout candidate

• Stocks in a clear downtrend (lower highs, lower lows) without any base formation
• Breakouts on low or declining volume
• Breakouts with high volume but very low delivery % (<25%) — likely speculative/intraday driven, not sustained buying
• Stocks near earnings dates (within 1 week) unless the user explicitly wants to trade the event
• Illiquid stocks (very low average volumes) — harder to exit
• Stocks under ASM/GSM surveillance — restricted trading, reduced circuits, likely operator manipulation
• Stocks in F&O ban period — erratic price action from unwinding positions
• Stocks showing operator activity red flags (sudden unexplained spikes, micro-cap, no institutional holding, <15% delivery on huge volume)

• Above 40%: Strong conviction — genuine accumulation or distribution
• 35-40%: Acceptable — decent institutional interest
• 25-35%: Caution — mixed signal, higher speculative component
• Below 25%: Red flag — mostly intraday speculation, breakout may not sustain

1. Pass 1 (broad scan): Search for market movers, breakout candidates, sector performance to identify a shortlist of 4-6 names
2. Pass 2 (price verification): For each shortlisted stock, search for its actual current price, 52W high/low, and key levels before including it in the output

• get_ltp

  /

  get_quote

  for real-time prices — faster and more accurate than web search

• get_holdings

  for existing portfolio context

• get_margins

  for available capital
• This eliminates the need for web search price verification — Kite data is live and authoritative

• Search for "[STOCK] share price today", "[STOCK] technical analysis", "[STOCK] chart" to get current levels
• Search for "NSE top gainers today", "stocks near 52 week high NSE", "breakout stocks India today" for screening
• Search for sector-specific moves: "IT stocks NSE today", "pharma stocks breakout"

• If the user uploads a CSV from their broker/screener — parse it and work with the data directly
• If the user shares a chart screenshot — read the visible levels, patterns, and indicators from the image
• If the user provides a list of stocks — analyze each one

• If the user just mentions a stock name ("what about RELIANCE?"), search for current data and analyze
• If the user gives you levels ("HDFCBANK support at 1580, resistance at 1650"), work with those directly without searching

• Risk per trade: 1-2% of trading capital. If the user hasn't specified their capital, ask once, then remember for the session. If they don't want to share, skip position sizing and just give levels.
• Minimum Risk:Reward: 1:2. Don't recommend trades where the SL distance is larger than the potential gain. If R:R is between 1:1.5 and 1:2, mention it as a "marginal R:R" setup.
• Stop Loss placement: Always based on price structure, not arbitrary percentages. SL goes below the nearest support (for longs) or above nearest resistance (for shorts). If the SL distance makes the R:R unfavorable, the trade isn't worth taking — say so.
• Position sizing formula:

  Shares = (Capital × Risk%) / SL Distance per share

  • Example: ₹5,00,000 capital, 2% risk = ₹10,000 max loss. If SL is ₹20 away from entry → buy 500 shares.
• Partial booking: Suggest booking 50% at Target 1 and trailing SL to entry for the rest. This is a suggestion, not a rule.
• Position scaling (adding to winners): When a trade moves in your favor and the setup strengthens, adding to the position can turn a good trade into a portfolio-maker. See

  references/alpha-and-edge.md

  for the full scaling framework — rules on when to add, how much, and how to adjust SL for the combined position.
• Maximum portfolio heat: Total risk across all open positions must not exceed 6-8% of capital. In high VIX (>20), reduce to 4-5%. When suggesting a new trade, check if adding it would breach this limit. See

  references/alpha-and-edge.md

  for details.
• India VIX check: Always check India VIX before building any watchlist or trade plan. VIX below 15 = normal trading. VIX 15-20 = widen SLs 10-15%, reduce sizes. VIX above 20 = only A-grade setups, half-size positions. VIX above 25 = mostly cash. See

  references/alpha-and-edge.md

  for full VIX framework.
• Slippage buffer: Factor ₹3-5 slippage for large-caps, ₹5-15 for mid-caps into entry price and SL calculations. Breakout entries typically have higher slippage. Note adjusted R:R after slippage. See

  references/alpha-and-edge.md

  .
• Gap risk awareness: Note stock beta in trade plans. High-beta stocks (>1.3) amplify market gaps. Friday entries carry extra weekend gap risk. Before long weekends, suggest booking partial profits or tightening SLs. See

  references/alpha-and-edge.md

  .

This is a technical analysis-based trade idea, not financial advice. Always do your own research and manage your risk. Past patterns don't guarantee future results.

• Use ₹ (rupee symbol) for all prices
• Use Indian number formatting where possible (e.g., ₹1,50,000 not ₹150,000)
• Refer to stocks by their NSE ticker (RELIANCE, TATAMOTORS, HDFCBANK, etc.)
• Be direct and opinionated — traders want clear "yes/no/wait" signals, not wishy-washy "it could go either way" analysis. If the setup isn't clean, say so.
• When a trade idea has merit, lead with the setup and levels. When it doesn't, say "no setup" and explain briefly why.
• Timeframe callout is important — explicitly state whether this is a swing (2-5 day) or positional (1-4 week) idea so the trader sets expectations correctly.

• 8-10 (A-grade): Full position. All key factors aligned.
• 6-7.5 (B-grade): Reduced position (50-75%). Most factors support.
• 4-5.5 (C-grade): Small pilot only (25-50%). Speculative.
• Below 4: No trade. Skip or watchlist.

references/conviction-scoring.md

1. Relative Strength Ranking — How is the stock performing vs Nifty and its sector? Stocks with strong RS (outperforming Nifty by 5%+) are higher priority.
2. Multiple Timeframe Check — Is the weekly trend aligned with the daily setup? Weekly bullish + daily breakout = highest probability. Weekly bearish + daily bounce = risky counter-trend trade.
3. Gap Analysis — Breakaway gaps on volume are actionable. Exhaustion gaps after long runs are warning signs. Gaps that fill intraday are weak.
4. Earnings Calendar Alert — Flag if earnings are within 14 days. Within 7 days = prominent warning. This is a binary risk event that can override any technical setup.

references/advanced-filters.md

1. Circuit limits: Check the stock's price band (2%/5%/10%/20%). If SL is close to the circuit limit, flag gap risk — your SL may not execute if the stock hits lower circuit.
2. ASM/GSM status: Search "[STOCK] ASM GSM status". If under surveillance → do not recommend. Flag as "restricted trading, likely operator activity."
3. F&O ban: Search "F&O ban list today NSE". Stocks in ban have erratic price action → flag and suggest waiting.
4. Operator activity check: For mid/small caps, look for red flags — sudden unexplained spikes, micro-cap, <15% delivery on huge volume, no institutional holding. If 3+ red flags → avoid.
5. T+1 settlement: Note that delivery trades settle T+1. Friday entries carry weekend gap risk. Before long weekends/holidays, add a warning.

references/india-mechanics.md

1. Unusual volume detection: Don't just check "above average" — flag statistically anomalous volume (3x+ average). Cross-reference with delivery % using the interpretation matrix in the reference file. Anomalous volume + high delivery = institutional activity signal.
2. Bulk/block deal tracking: Always search for recent bulk/block deals (last 30 days) when analyzing a stock. Institutional buying in bulk + technical setup = conviction boost. Promoter selling = caution flag.
3. Sector-stock divergence: When a stock diverges from its sector by >3%, flag it. Laggard in a strong sector = potential catch-up play. Leader in a weak sector = genuine relative strength.
4. Historical pattern context: Reference known Indian market pattern tendencies — e.g., breakouts from 3+ week bases in Nifty 50 stocks have ~70% success rate in trending markets, ~50% when Nifty is below 200 DMA. Calibrate expectations.
5. India VIX integration: Check VIX before every analysis session. VIX level directly adjusts position sizing and conviction thresholds.
6. Portfolio heat monitoring: Track total risk across all open positions. Never exceed 6-8% of capital. In high-VIX environments, cap at 4-5%.

references/alpha-and-edge.md

• Stock, date recommended, entry zone, SL, T1, T2, conviction score
• Current status: 🟢 Hit T1, ✅ Hit T2, 🔴 Hit SL, 🟡 Still active, ❌ Setup invalidated before entry
• P&L if entered at the midpoint of the entry zone
• Days held (or days since recommendation)

undefined

• Use

  get_ltp

  /

  get_quote

  for real-time verified prices instead of web search
• Use

  get_holdings

  +

  get_positions

  for live risk dashboard data
• Use

  get_margins

  to check available capital for position sizing
• Use

  place_order

  (self-hosted only) to execute trades after explicit user confirmation
• Cross-reference holdings when suggesting new trades — flag sector concentration

references/kite-mcp.md

references/

• references/conviction-scoring.md

  — Full 8-parameter scoring rubric with weights, thresholds, and presentation format. Read when calculating conviction scores.

• references/advanced-filters.md

  — Relative strength ranking, multiple timeframe checks, gap analysis, earnings alerts, and sector rotation. Read when doing deep analysis or full trade plans.

• references/workflow-tools.md

  — Watchlist maintenance, risk dashboard, position sizing calculator, news/event flagging, and Zerodha-ready order format. Read when user asks for portfolio management or order execution help.

• references/kite-mcp.md

  — Kite MCP integration details: available tools, how to use them in each skill mode, order execution safety rules, setup instructions for users. Read when Kite MCP tools are detected or user asks about connecting their Zerodha account.

• references/india-mechanics.md

  — Circuit limits, T+1 settlement, ASM/GSM framework, F&O ban periods, operator activity warnings, budget/RBI policy patterns. Read before recommending any stock outside Nifty 50, and always for mid/small caps.

• references/alpha-and-edge.md

  — Unusual volume detection, bulk/block deal tracking, sector-stock divergence, historical pattern context, India VIX framework, gap risk/slippage management, portfolio heat rule. Read for every trade plan to add genuine analytical edge.