Methodology inspired by publicly taught commercial-tracking approaches; all text is an original paraphrase.
Defaults
| Parameter |
Default Value |
Rationale |
| windows |
current / 4-wk / 12-wk |
Three-window share + growth lattice |
| growth_metric |
TRx YoY |
Weekly, 4-wk, and 12-wk YoY alongside share |
| analog_count |
2 |
≥2 named same-class analogs on the launch board |
| consensus_source |
company-level |
Product consensus via segment-share math [DEDUCTED] |
| caveats |
per-row |
A number without a caveat annotation is a defect |
Preflight
Run canonical pre-flight per contracts/preflight.md. Include the X-Agentii-Trace header on every tool call per contracts/x-agentii-trace-header.md — carry the _run_id from your first tool result and name yourself (and your parent, if you were spawned). Confirm ticker resolution via search_companies before commercial-track queries.
Triggers
- "Is [product] tracking above or below consensus?"
- "How is the [product] launch trending?"
- "Build the launch board for [product] with class analogs."
- "What is the consensus-implied trajectory for [product]?"
- "Show [product]'s TRx share and YoY for the last 12 weeks."
- "How fast is [biosimilar] eroding [branded product]?"
- "Stress-test [product]'s net price and GTN."
- "What are the caveats on [product]'s scripts?"
- "Track installed base and utilization for [device]."
- "How is ACIP-cohort uptake tracking for [vaccine]?"
Production Grounding
- Three-window lattice: current / 4-wk / 12-wk share and YoY; previous values shown next to new values.
- Launch boards: actuals vs ≥2 named same-class analogs + consensus-implied trajectory (consensus sales ÷ net price ÷ script duration → required TRx → linear path); assumptions stated.
- LOE erosion: entrant share vs branded YoY decay with approval/launch dates.
- GTN/net-price stress: GTN brackets (50→80% flex), $/Rx = quarterly sales ÷ scripts, channel mix; half-of-sales-minus-volume net price is a stated judgment [VIEW].
- Modality vocabularies: scripts/share/erosion (drugs & biologics); installed base, placements/procedures, utilization, ASP (devices); doses/serials, procurement, ACIP-cohort uptake (vaccines); never a script number for a device or vaccine.
- Per-row caveats: restricted scripts, rounding, indication-mixed, IV invisibility, holiday weeks — every row carries its caveat or
coverage_gap.
- Badges:
[FACT]/[DEDUCTED]/[VIEW] with the summary table.
Data Source Priority
search_commercial_track — weekly track rows with stored previous values.
- Company-reported product sales: 10-K/Q XBRL (
get_statement) and MD&A (search_documents).
- Transcript commentary on scripts/share/persistence via
search_documents.
- Payer coverage/PA announcements and openFDA label events via
search_documents + list_sources.
- Consensus:
search_earnings_calendar company-level only; licensed Rx panels never assumed.
Methodology
Retrieval Scope
unstructured_document_search
Retrieval Strategy
- Resolve basket tickers via
search_companies; map products to companies.
- Pull weekly rows via
search_commercial_track (previous values stored alongside).
- Compute the three-window lattice from stored history; attach per-row caveats.
- Build the launch board: ≥2 named analog curves + consensus-implied trajectory arithmetic.
- LOE events: pair entrant share with branded YoY decay; date approval/launch.
- Stress net price (GTN brackets, $/Rx, channel mix); label derived values
[DEDUCTED].
- Ground in knowledge (sectors=med); cite /v/ records.
Temporal Scope
See frontmatter temporal_scope block. Rolling windows recompute from stored history; holiday weeks are labeled.
Tool Allowlist
See frontmatter allowed_tools.
Protocol
- Ticker + product resolution
- Commercial-track pull (stored history)
- Three-window lattice computation
- Launch-board overlay + implied trajectory
- LOE erosion series (when applicable)
- GTN/net-price stress + caveat audit
Modes
- Drug / biologic (default): scripts/share/erosion; LOE/biosimilar series.
- Device: installed base, placements/procedures, utilization, ASP; no script numbers.
- Vaccine: doses/serials, procurement, ACIP-cohort uptake; approval ≠ commercial availability.
- Basket: multi-ticker watchlist with per-name sections.
Tool Fallbacks
| Failure |
Fallback |
| search_commercial_track empty |
Company-reported sales (get_statement/search_documents); annotate coverage_gap |
| Scripts restricted (IQVIA) |
State the restriction verbatim; refuse a share number; use company-reported metrics |
| No product consensus |
Segment share × company consensus [DEDUCTED]; else coverage_gap with required inputs |
| No analog series |
Named-analog list with disclosed sales/scripts; flag degraded |
| One-quarter issuer / pre-revenue |
Pipeline/cash-runway logic; no share arithmetic |
Output File
{ticker}/{YYYY-MM-DD_HHMM}_market-share-tracking_{affix}.md (basket: watchlist/{YYYY-MM-DD_HHMM}_market-share-tracker_{affix}.md)
Output Structure
- Executive Summary — actuals vs consensus-implied trajectory, 2-3 sentences
- Launch Board — actuals vs ≥2 named analogs + consensus-implied path with stated arithmetic
- Share & YoY Lattice — current/4-wk/12-wk share and YoY with previous values
- LOE / Erosion Series — entrant share vs branded YoY decay with approval/launch dates
- Net-Price & GTN Stress — $/Rx, GTN brackets, channel mix, [DEDUCTED] labels
- Caveat Register — per-row annotations + coverage_gap list
- Coverage Gaps — missing sources and degraded modes
Error Handling
| Error |
Fallback |
| No commercial-track rows |
Company-reported sales only; annotate coverage_gap — never fabricate scripts |
| Product not in med universe |
Resolve via product/company match; surface the classification gap |
| Consensus absent |
coverage_gap with required inputs (sales, net price, script duration) |
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.md
contracts/output-frontmatter-schema.md
contracts/memory-load.md
contracts/snapshot-synthesis.md
contracts/preflight.md
references/knowledge-frameworks.md
1---2name: market-share-tracking3description: Weekly product-level commercial tracking — TRx/NRx with current/4-wk/12-wk share and YoY, launch curves overlaid with same-class analogs plus a consensus-implied trajectory, LOE/biosimilar erosion series, GTN/net-price stress brackets, and per-row data-caveat discipline. Use to track any launched drug, biologic, device, or vaccine against its class and consensus.4sectors: [med.medicines_biotech, med.medical_devices]5multi_ticker_semantics: basket_v1_16temporal_scope:7 default_quarters: 48 max_quarters: 89 description: "Weekly rolling-window tracking default 4 quarters; up to 8 for launch-curve overlays."10allowed_tools:11 - search_commercial_track12 - search_companies13 - get_company_profile14 - get_statement15 - search_documents16 - search_sec_filings17 - list_sources18 - read_source_outline19 - read_source_pages20 - search_earnings_calendar21 - list_upcoming_earnings22 - search_investment_cases23 - search_by_analogue24 - search_knowledge_entries25retrieval_scope: unstructured_document_search26min_tool_diversity: 327parameter_free: false28metadata:29 source: https://skillmd.com/skills/agentii-ai/market-share-tracking30---3132> Methodology inspired by publicly taught commercial-tracking approaches; all text is an original paraphrase.3334## Defaults3536| Parameter | Default Value | Rationale |37|-----------|---------------|-----------|38| windows | current / 4-wk / 12-wk | Three-window share + growth lattice |39| growth_metric | TRx YoY | Weekly, 4-wk, and 12-wk YoY alongside share |40| analog_count | 2 | ≥2 named same-class analogs on the launch board |41| consensus_source | company-level | Product consensus via segment-share math [DEDUCTED] |42| caveats | per-row | A number without a caveat annotation is a defect |4344## Preflight4546Run canonical pre-flight per `contracts/preflight.md`. Include the `X-Agentii-Trace` header on every tool call per `contracts/x-agentii-trace-header.md` — carry the `_run_id` from your first tool result and name yourself (and your parent, if you were spawned). Confirm ticker resolution via `search_companies` before commercial-track queries.4748## Triggers4950- "Is [product] tracking above or below consensus?"51- "How is the [product] launch trending?"52- "Build the launch board for [product] with class analogs."53- "What is the consensus-implied trajectory for [product]?"54- "Show [product]'s TRx share and YoY for the last 12 weeks."55- "How fast is [biosimilar] eroding [branded product]?"56- "Stress-test [product]'s net price and GTN."57- "What are the caveats on [product]'s scripts?"58- "Track installed base and utilization for [device]."59- "How is ACIP-cohort uptake tracking for [vaccine]?"6061## Production Grounding6263- Three-window lattice: current / 4-wk / 12-wk share and YoY; previous values shown next to new values.64- Launch boards: actuals vs ≥2 named same-class analogs + consensus-implied trajectory (consensus sales ÷ net price ÷ script duration → required TRx → linear path); assumptions stated.65- LOE erosion: entrant share vs branded YoY decay with approval/launch dates.66- GTN/net-price stress: GTN brackets (50→80% flex), $/Rx = quarterly sales ÷ scripts, channel mix; half-of-sales-minus-volume net price is a stated judgment [VIEW].67- Modality vocabularies: scripts/share/erosion (drugs & biologics); installed base, placements/procedures, utilization, ASP (devices); doses/serials, procurement, ACIP-cohort uptake (vaccines); never a script number for a device or vaccine.68- Per-row caveats: restricted scripts, rounding, indication-mixed, IV invisibility, holiday weeks — every row carries its caveat or `coverage_gap`.69- Badges: `[FACT]`/`[DEDUCTED]`/`[VIEW]` with the summary table.7071## Data Source Priority72731. `search_commercial_track` — weekly track rows with stored previous values.742. Company-reported product sales: 10-K/Q XBRL (`get_statement`) and MD&A (`search_documents`).753. Transcript commentary on scripts/share/persistence via `search_documents`.764. Payer coverage/PA announcements and openFDA label events via `search_documents` + `list_sources`.775. Consensus: `search_earnings_calendar` company-level only; licensed Rx panels never assumed.7879## Methodology8081### Retrieval Scope82unstructured_document_search8384### Retrieval Strategy851. Resolve basket tickers via `search_companies`; map products to companies.862. Pull weekly rows via `search_commercial_track` (previous values stored alongside).873. Compute the three-window lattice from stored history; attach per-row caveats.884. Build the launch board: ≥2 named analog curves + consensus-implied trajectory arithmetic.895. LOE events: pair entrant share with branded YoY decay; date approval/launch.906. Stress net price (GTN brackets, $/Rx, channel mix); label derived values `[DEDUCTED]`.917. Ground in knowledge (sectors=med); cite /v/ records.9293### Temporal Scope94See frontmatter temporal_scope block. Rolling windows recompute from stored history; holiday weeks are labeled.9596### Tool Allowlist97See frontmatter allowed_tools.9899### Protocol1001. Ticker + product resolution1012. Commercial-track pull (stored history)1023. Three-window lattice computation1034. Launch-board overlay + implied trajectory1045. LOE erosion series (when applicable)1056. GTN/net-price stress + caveat audit106107## Modes108109- **Drug / biologic** (default): scripts/share/erosion; LOE/biosimilar series.110- **Device**: installed base, placements/procedures, utilization, ASP; no script numbers.111- **Vaccine**: doses/serials, procurement, ACIP-cohort uptake; approval ≠ commercial availability.112- **Basket**: multi-ticker watchlist with per-name sections.113114## Tool Fallbacks115116| Failure | Fallback |117|---------|----------|118| search_commercial_track empty | Company-reported sales (`get_statement`/`search_documents`); annotate coverage_gap |119| Scripts restricted (IQVIA) | State the restriction verbatim; refuse a share number; use company-reported metrics |120| No product consensus | Segment share × company consensus [DEDUCTED]; else coverage_gap with required inputs |121| No analog series | Named-analog list with disclosed sales/scripts; flag degraded |122| One-quarter issuer / pre-revenue | Pipeline/cash-runway logic; no share arithmetic |123124## Output File125126`{ticker}/{YYYY-MM-DD_HHMM}_market-share-tracking_{affix}.md` (basket: `watchlist/{YYYY-MM-DD_HHMM}_market-share-tracker_{affix}.md`)127128## Output Structure1291301. **Executive Summary** — actuals vs consensus-implied trajectory, 2-3 sentences1312. **Launch Board** — actuals vs ≥2 named analogs + consensus-implied path with stated arithmetic1323. **Share & YoY Lattice** — current/4-wk/12-wk share and YoY with previous values1334. **LOE / Erosion Series** — entrant share vs branded YoY decay with approval/launch dates1345. **Net-Price & GTN Stress** — $/Rx, GTN brackets, channel mix, [DEDUCTED] labels1356. **Caveat Register** — per-row annotations + coverage_gap list1367. **Coverage Gaps** — missing sources and degraded modes137138## Error Handling139140| Error | Fallback |141|-------|----------|142| No commercial-track rows | Company-reported sales only; annotate coverage_gap — never fabricate scripts |143| Product not in med universe | Resolve via product/company match; surface the classification gap |144| Consensus absent | coverage_gap with required inputs (sales, net price, script duration) |145146## Memory Load147148See `contracts/memory-load.md`.149150## Snapshot151152See `contracts/snapshot-synthesis.md`.153154## Final Summary (TUI)155156Include ### Key Citations block with 0-10 clickable /v/ URLs.157158## References159160- `contracts/citation-and-memory.md`161- `contracts/output-frontmatter-schema.md`162- `contracts/memory-load.md`163- `contracts/snapshot-synthesis.md`164- `contracts/preflight.md`165- `references/knowledge-frameworks.md`