stock-brief

# Stock brief Give a tight, decision-useful read on **one ticker** from AlphaAI's enriched feed. Not a price quote — a *news* brief: what's been happening, who's buying or selling, and what to keep an eye on. ## Steps 1. **Resolve the ticker.** If the user gave a company name, not a symbol, call `alphai_tickers(q=...)` to find it. If `alphai_ticker_news` returns `unknown_ticker=true`, tell the user and stop — don't invent coverage. 2. **Pull the ticker feed.** Call `alphai_ticker_news(ticker, collapse_stories=true)`. `collapse_stories` folds syndicated reprints into one row each and adds a `sources_count` corroboration signal — prefer it for a clean brief. Insider news is included by default; keep it. 3. **Optional context.** If the user wants the wider tape, call `alphai_trending(limit=5)` and note any market-level story that touches this name or its sector. 4. **Deep-dive on demand.** If one story clearly drives the brief and the user wants detail, fetch it with `alphai_article(uid)` for the full enrichment (ticker analysis, key entities). The article *body* is not served — work from the enrichment and summary. ## Output Keep it to a screen. Structure: - **One-line read** — the single most important thing about this name right now. - **Top stories** — 3–5 bullets, each: headline · relevance score · one-clause "why it matters". Lead with the highest `relevance_score`. - **Insider activity** — any Form 4 / 13F rows from the feed: who, buy or sell, size if given. "No notable insider activity in the window" is a valid line. - **Watch next** — 1–2 concrete things that would change the picture. ## Guardrails - Every story carries a 1–10 `relevance_score`; lead with the high ones and say the score so the user can calibrate. - This is news, not advice. Don't issue buy/sell calls or price targets — summarize what the reporting says and let the user decide. - If the feed is thin, say so plainly rather than padding. A short honest brief beats a long speculative one.