Methodology inspired by publicly taught earnings-preview frameworks; all text is an original paraphrase.
Defaults
| Parameter | Default Value | Rationale |
|---|---|---|
| surprise_window | 8 quarters | Standard surprise history window |
| include_catalysts | true | Med prints move on catalysts as much as EPS |
| guidance_sensitivity | true | Guidance is the swing factor for pharma |
Preflight
Run canonical pre-flight per contracts/preflight.md. Propagate X-Agentii-Trace per contracts/x-agentii-trace-header.md.
Triggers
- "Preview [biotech ticker]'s upcoming earnings."
- "What should I expect at [ticker]'s next print?"
- "How has [ticker] surprised historically?"
- "Which catalysts land near [ticker]'s earnings date?"
- "Build an earnings preview with consensus estimates."
- "What's the guidance risk for [ticker] this quarter?"
- "Summarize the last few quarters for [ticker]."
- "Earnings + FDA calendar overlap for [ticker]."
- "What are the swing factors for [ticker]'s print?"
- "Historical reaction to [ticker]'s earnings surprises."
Production Grounding
- Med prints have TWO drivers: financials (revenue/EPS/guidance) and catalysts (PDUFA/AdCom/readouts). The catalyst overlay is mandatory — a clean quarter can be undone by a CRL days earlier.
- For pre-revenue biotechs, the print is mostly about cash runway + pipeline updates; consensus EPS is secondary.
- Grounding frameworks:
references/knowledge-frameworks.md(道/法 review knowledge).
Data Source Priority
search_earnings_calendar— estimates, actuals, surprise history, next date.search_xbrl_facts— revenue/EPS/margin trends.search_documents/read_source_*— prior-quarter commentary and guidance.- Knowledge layer:
search_investment_casesfor historical print reactions.
Methodology
Retrieval Scope
unstructured_document_search
Retrieval Strategy
- Resolve the earnings event:
search_earnings_calendarfor dates/estimates/surprises. - Pull fundamentals trend:
search_xbrl_factskey line items. - Catalyst overlay: nearest PDUFA/AdCom/readout vs print date.
- Ground with historical cases (print reactions) via knowledge tools.
Temporal Scope
See frontmatter temporal_scope block.
Tool Allowlist
See frontmatter allowed_tools.
Protocol
- Event & estimates
- Fundamental trend
- Catalyst overlay
- Swing-factor synthesis
Modes
- Standard (default): estimates + surprises + guidance.
- Pre-revenue: runway + pipeline + readout framing.
- Catalyst-overlap: print framed around nearby FDA events.
Tool Fallbacks
| Failure | Fallback |
|---|---|
| search_earnings_calendar empty | Use filings (search_documents) for dates; annotate coverage_gap |
| No catalyst data | Flag "catalyst overlay unavailable" |
| Knowledge tools empty | Proceed with structured data only |
Output File
{ticker}/{YYYY-MM-DD_HHMM}_earnings-preview-med_{affix}.md
Output Structure
- Executive Summary — setup for the print in 2-3 sentences
- Consensus & Surprise History — estimates table + surprise record
- Guidance & Swing Factors — guidance risk analysis
- Catalyst Overlay — FDA events near the print
- Historical Context — cases with /v/ citations
- Coverage Gaps — degraded flags
Error Handling
| Error | Fallback |
|---|---|
| Estimates missing | Present fundamentals trend only; flag |
| Date uncertain | Use calendar's best estimate + annotate |
Memory Load
See contracts/memory-load.md.
Snapshot
See contracts/snapshot-synthesis.md.
Final Summary (TUI)
Include ### Key Citations block with 0-10 clickable /v/ URLs.
References
contracts/citation-and-memory.mdcontracts/output-frontmatter-schema.mdcontracts/memory-load.mdcontracts/snapshot-synthesis.mdcontracts/preflight.mdreferences/knowledge-frameworks.md