Step 1 — Intent routing

Map the user's query to exactly one playbook id. Read the playbook definitions from playbooks/gate-info-research.yaml. The mapping below is authoritative.

Slot extraction rules

• symbol is the ticker (BTC, ETH, SOL). If the user gives a project name ("Solana", "Arbitrum"), confirm or ask.
• symbols is a list; strip duplicates; keep display casing consistent.
• timerange is the user's broad news-context window. PER-COMMAND ENUM narrowing — the super-set is 1h / 24h / 7d / 30d, but individual commands accept narrower sets. Before forwarding a user-supplied timerange to any command, clamp it against that command's argenums in the playbook (CLAUDE.md rule 9): search-news accepts 1h / 24h / 7d / 30d, search-ugc accepts 1h / 24h / 7d / 30d / all, get-social-sentiment and get-latest-events accept ONLY 1h / 24h / 7d (CLI rejects 30d with INVALIDARGUMENTS). For longer windows on get-latest-events, switch to --start-time / --end-time (unix-ms).
• period (the analysis window consumed by markettrend get-technical-analysis --period and get-kline --period). Server enum: 1h / 4h / 24h / 3d / 5d / 7d / 10d / all. Default 3d. Legacy aliases 1d → use 24h; 1w → use 7d. Do NOT pass 1d or 1w — CLI returns INTELRESULTERROR: invalid period.
• timeframe has two variants:

- get-kline --timeframe enum: 1m / 5m / 15m / 1h / 4h / 1d (required, no default). - get-market-snapshot --timeframe and get-indicator-history --timeframe enum: 15m / 1h / 4h / 1d (get-market-snapshot default 1h; get-indicator-history required). 1m / 5m are NOT valid on these two.

• indicators (for trend) defaults to rsi,macd,ma30,ma200 — lowercase only. Uppercase (RSI, MACD) passes CLI validation but the server returns empty rows silently. Unsupported windows (ma20, ma50) also return empty rows — use the server-populated set: rsi, macd, macddifference, ma7, ma30, ma120, ma200, ema7, ema30, ema200, bollupperband, bollmiddleband, bolllower_band. See skills/gate-info-research/references/cli-reference.md (section get-indicator-history) for the full field list.
• If a required slot is missing, STOP and ask the user.

Cross-skill routing at Step 1

Step 2 — Data collection

Execute the chosen playbook. Each command MUST include --format json. Commands in the same parallel_group run concurrently; the agent waits for the group before entering the next group or synthesis.

Shortcut routing (gate-cli >= 0.7.6)

When shortcutsenabled and the playbook defines shortcut (or additionalshortcut for researchplusnews):

1. Resolve the full shortcut list per [cli-version-routing.md](../shared/cli-version-routing.md): extends ancestors first (info before news), then child blocks in fixed key order (shortcut → additionalshortcut → infoshortcut). Verify each block’s guards (e.g. multicoin: 2 <= len(symbols) <= 5).
2. Run each shortcut block in order; accumulate every block’s replacescommandids into a playbook-level skipids union (includes parent newsaddons when ids match, e.g. researchplusnews).
3. On shortcut failure for a block (non-zero exit and/or stderr {"error":…}): if fallbackonerror, queue legacy commands for that block’s replaced ids only. Do not expect stdout status on info/news calls (unlike preflight).
4. On payload partial / missing_sections (top-level on stdout): mark affected report subsections; do not auto re-run legacy unless required data is empty.
5. After all shortcuts succeed: run legacy entries (merged extends buckets: commands, newsaddons, additionalcommands, …) whose id ∉ skipids, plus postshortcutoptionalids and coin_addon per playbook.

See [cli-version-routing.md](../shared/cli-version-routing.md) for multi-shortcut examples (researchplus_news: +coin-overview then +brief).

Shortcut field mapping: [cli-version-routing.md](../shared/cli-version-routing.md). marketoverview shortcut: no gainers/losers/popular boards — use benchmarksnapshots + trendanchor and state rankings unavailable on shortcut path (playbook synthesis_note).

2.A single_coin

Shortcut (>= 0.7.6): gate-cli info +coin-overview --symbol {symbol} --format json replaces the three info rows below. Optional news addons unchanged.

2.B market_overview

Shortcut (>= 0.7.6): gate-cli info +market-overview --format json (optional --benchmark BTC,ETH,SOL).

2.C multi_coin

Shortcut (>= 0.7.6, 2–5 symbols only): derive symbolscsv = join(uppercase(symbols), ",") then gate-cli info +coin-compare --symbols {symbolscsv} --format json. Map payload comparematrix[] (not comparisonmatrix) per [cli-version-routing.md](../_shared/cli-version-routing.md).

Run once (legacy or >5 symbols):

• gate-cli info marketsnapshot batch-market-snapshot --symbols {s1} --symbols {s2} … --scope full (the --symbols flag is a repeatable stringArray).

Then run per symbol in parallel:

• gate-cli info coin get-coin-info --query {symbol} --scope basic
• gate-cli info markettrend get-technical-analysis --symbol {symbol} (optional)

2.D trend

Shortcut (>= 0.7.6): gate-cli info +trend-analysis --symbol {symbol} --format json (lightweight TA; legacy path below for deep kline/indicator history).

• gate-cli info markettrend get-technical-analysis --symbol {symbol} --period {period|3d}
• gate-cli info markettrend get-kline --symbol {symbol} --timeframe {timeframe|1d} --size 120 --with-indicators true
• gate-cli info markettrend get-indicator-history --symbol {symbol} --timeframe {timeframe|1d} --indicators rsi --indicators macd --indicators ma30 --indicators ma200 --limit 120

2.E macro

• gate-cli info macro get-macro-summary
• gate-cli info macro get-economic-calendar --start-date {today} --end-date {today+14d} --importance high
• gate-cli info macro get-macro-indicator --indicator {indicator|CPI} --country {country|US} --mode series --size 12 (optional)
• If the user names a coin, also: gate-cli info marketsnapshot get-market-snapshot --symbol {symbol} --scope basic.

2.F researchplusnews

When shortcuts_enabled (>= 0.7.6):

1. Inherited single_coin shortcut: gate-cli info +coin-overview --symbol {symbol} --format json.
2. Child shortcut: gate-cli news +brief --coin {symbol} --time-range {time_range|24h} --format json.
3. Build skipids = union of both blocks’ replacescommandids (includes parent singlecoin newsaddons ids newsbrief, social_sentiment).
4. Run only legacy commands with id ∉ skipids — typically optional ugcscan from additionalcommands. Do not re-run the three replaced news commands or parent newsaddons.

Legacy only (shortcutsenabled == false OR per-block fallbackon_error for failed shortcuts):

• Info: single_coin legacy trio (get-coin-info, get-market-snapshot, get-technical-analysis).
• News: use additionalcommands below (do not also run singlecoin news_addons — duplicate ids):

• gate-cli news feed search-news --coin {symbol} --limit 10 --sort-by importance --time-range {time_range|24h}
• gate-cli news feed get-social-sentiment --coin {symbol} --time-range {timerange|24h} — clamp timerange to 1h / 24h / 7d before sending
• gate-cli news feed search-ugc --coin {symbol} --time-range {time_range|7d} --platform all --limit 20 (optional)
• gate-cli news events get-latest-events --coin {symbol} --time-range {timerange|7d} --limit 15 (optional) — clamp timerange to 1h / 24h / 7d before sending

Failure policy

• If a required command fails or returns an error payload, abort the playbook and surface the user-actionable CLI error.
• If an optional command fails, continue and mark the corresponding section as no data in Step 3.
• Never fabricate numbers; never fill a missing dimension with inferred values.

Step 3 — Synthesis

Aggregate the JSON payloads into the fixed 6-section report. Section order is mandatory and matches the product requirements spec.

Report template

## {subject} — Research report

### 1. Executive summary
- Core view (neutral framing: **stronger / softer / needs monitoring**; not investment advice)
- Up to 3 supporting data points
- Up to 2 main risk observations

### 2. Fundamentals and market position
{Positioning, sector, valuation (MC / FDV), funding / investors, unlocks. Sources: `info coin get-coin-info`.}

### 3. Market and trend
**Snapshot**
| Field | Value | Read |
|------|------|------|
| Price | ... | ... |
| 24h / 7d change | ... | ... |
| Funding | ... | ... |
| Sentiment / fear-greed | ... | ... |

**Technicals**
- Short term (1h / 4h): {bull / bear / neutral}
- Medium term (1d / 1w): {bull / bear / neutral}
- Key support / resistance: ...

Sources: shortcut aggregates (`agg_coin_overview`, `agg_market_overview`, etc.) or legacy commands (`get-market-snapshot`, `get-technical-analysis`, `get-kline`, `get-indicator-history`, `get-market-overview`, `get-coin-rankings`, `batch-market-snapshot`, `get-macro-summary`, `get-economic-calendar`, `get-macro-indicator`) as applicable. Map shortcut JSON fields per [cli-version-routing.md](../_shared/cli-version-routing.md).

### 4. Recent news and market tone
- **Factual events** (from `news feed search-news` / `news events get-latest-events`): ...
- **Community tone** (from `news feed get-social-sentiment` / `news feed search-ugc`): ...

Keep facts and community tone in separate subsections. If no news commands ran, mark **no data** for this section.

### 5. Risk notes
- Data-backed risk bullets (e.g. elevated RSI, near-term unlock, extreme funding, related incidents)
- Cite the originating command for each item

### 6. What to watch next
- Macro / unlock / protocol events in the next 7–14 days
- Technical triggers (e.g. “if price loses X, bias turns weaker”)

> This report is based on public data and tool output; it is not investment advice.

Decision thresholds (applied inside section 3 and 5)

Migrate hint (only if Step 0 status was readywithmigration_warning)

At the very end of the final user-facing report, append verbatim the single migration blockquote line defined under Migration hint in skills/shared/report-style.md (the line that begins with ⚙️ and references gate-cli migrate --dry-run). Do not paraphrase.