SEC Shenanigans Orchestrator

Coordinate a strict 5-artifact pipeline.

Pre-Stage Data Fetch

Before running any fetch scripts, the Orchestrator must instruct agents to check the local filesystem for /<ticker> directories containing user-provided filings (10-K , 10-Q , .xlsx ). Only rely on external SEC crawls or fetch scripts if the local data is incomplete or missing.

If filing tables are not readily available locally, run:

python skills/sec-shenanigans-orchestrator/scripts/fetch_financial_sheets.py <TICKER>

Use output as numeric support material; keep forensic evidence anchored to filing sections.

Pipeline Order

• sec-filing-evidence-extractor -> evidence-table.md

• sec-shenanigans-classifier -> risk-register.md

• sec-red-flag-ratio-checks -> ratio-diagnostics.md

• sec-shenanigans-memo-writer -> shenanigans-memo.md , open-questions.md

Contract

Use exact filenames and required fields in references/bundle-contract.md .

Stop Conditions

• Missing artifact file required by next stage.

• Artifact exists but required fields are missing.

• Cross-file link errors (risk-register references unknown evidence_id , etc.).

Golden Path

Use this self-contained example set as formatting anchor:

• references/golden-path/evidence-table.md

• references/golden-path/risk-register.md

• references/golden-path/ratio-diagnostics.md

• references/golden-path/shenanigans-memo.md

• references/golden-path/open-questions.md

Output Bundle

Return all artifacts in this order:

• evidence-table.md

• risk-register.md

• ratio-diagnostics.md

• shenanigans-memo.md

• open-questions.md

For run profiles, read references/pipeline-profiles.md .