Sec Filing Analysis

SEC Filing Analysis Skill

This skill is used when Mira needs to analyze SEC disclosure itself, not merely cite SEC as a source.

It supports two routes:

• sec_supplement: lightweight SEC fact verification inside another research workflow.
• sec_filing_deep_dive: dedicated analysis of a filing such as 10-K, 10-Q, S-1, 8-K exhibit, DEF 14A, 13F, or Form 4.

Route Selection

Use sec_supplement when:

• the primary task is single-equity research, earnings analysis, monitoring, event delta, or portfolio review
• SEC data is needed to verify a fact, metric, filing timeline, share count, cash flow item, debt item, SBC, inventory, RPO/backlog, segment value, risk factor, or governance detail
• the output should update the active case evidence log, financial snapshot, or case notes

Use sec_filing_deep_dive when:

• the user explicitly asks to analyze a filing, annual report, quarterly report, S-1, proxy, 8-K exhibit, 13F, Form 4, or similar document
• a thesis depends on filing-level details that cannot be answered by a quick metric lookup
• a company release, management commentary, market-data page, or prior case conflicts with the filing
• accounting quality, risk-factor delta, related-party transactions, debt/liquidity, customer concentration, segment disclosure, ownership/control, dilution, or non-GAAP reconciliation is central to the conclusion

If a filing is not yet available, do not fabricate filing analysis. Write a source-gap refresh item and state what the later filing must verify.

SEC Authority Rules

• A specific issuer filing from SEC Archives, company IR, or filed exhibit can support issuer_primary_disclosure claims.
• SEC submissions metadata and companyfacts JSON are official regulatory data sources, but record them as the registry/source-class authority defines unless the case has a specific reason to classify the extracted claim differently.
• Companyfacts rows must record CIK, taxonomy, tag, unit, fiscal period, form, filed date, frame if available, and as-of date.
• Filing rows must record CIK, accession number, form type, filing date, report period, source URL, and section or exhibit when relevant.
• Do not treat an XBRL tag name as self-explanatory. If the tag is non-standard or company-specific, state the label/context and downgrade comparability.

Required Inputs

For sec_supplement:

• company_name
• ticker
• market
• target_question
• needed_metrics_or_sections
• research_cutoff_date
• active_case_path

For sec_filing_deep_dive:

• company_name
• ticker
• market
• filing_type
• filing_period_or_event
• filing_date
• accession_number_or_source_url
• analysis_cutoff_date
• research_question
• prior_release_or_thesis_optional

Source Retrieval Order

1. Identify CIK and ticker mapping.
2. Use SEC company submissions to confirm latest relevant filings and filing dates.
3. Use the specific SEC Archive filing or filed exhibit for textual filing analysis.
4. Use companyfacts only for structured fact extraction and cross-period metric checks.
5. Use company IR only as a navigation or duplicate-primary route when SEC rendering is unavailable.
6. Use market-data or media sources only for expectation, reaction, or context; they do not replace the filing.

SEC Supplement Output

Default output is templates/sec-supplement-source-note.csv plus updates to the active case:

• active case evidence-log.csv
• active case financial-snapshot.csv, if financial facts are extracted
• active case notes source note
• templates/source-gap-refresh.md, if a filing or section is missing

Supplement notes must answer:

• what exact SEC source was checked
• what claim or metric it verified
• what provenance fields allow reproduction
• whether the result confirms, corrects, or conflicts with the current case
• what must refresh next

SEC Filing Deep Dive Output

Default output package:

• filing-analysis.md
• filing-metric-table.csv
• filing-risk-delta.csv
• accounting-quality-check.csv
• evidence-log.csv

Optional outputs when relevant:

• thesis-impact.md
• event-delta.md
• updated research package or earnings package
• Step 4.5 critical interaction: one natural-language next question that routes to SEC supplement, event delta, thesis update, or an explicit waiver.

Analysis Flow

1. Filing Identity

Record:

• company name and ticker
• CIK
• accession number
• form type
• filing date
• report period or event date
• amendment status
• source URL
• analysis cutoff date

2. Filing Completeness Check

Check whether the filing includes the sections needed for the research question:

• financial statements and notes
• MD&A
• risk factors
• business description
• segment disclosure
• liquidity and capital resources
• debt, leases, commitments and contingencies
• customer concentration
• related-party transactions
• non-GAAP reconciliation
• share count, dilution, SBC, repurchases
• governance, control, compensation or ownership

Mark unavailable sections as source_gap, not as absent risk.