Workflows and examples

Begin with a decision, not a source quota.

The most useful request names who will use the result, what they must decide, what belongs in scope, what evidence matters, and what the deliverable must expose.

A representative first request

Use $omnara-deep-research. Investigate whether small organizations should adopt passkeys for customer accounts in 2026. Audience: a product and security lead deciding what to ship. Scope: consumer web accounts in the United States and European Union. Include implementation tradeoffs, recovery, accessibility, adoption evidence, and credible objections. Deliver a decision brief with recommendation, evidence limits, contradictions, source-state counts, audit dispositions, and refresh triggers.

Before retrieval, expect the preserved inquiry, audience and decision use, scope and exclusions, coverage areas, source ecosystems, evidence burden, access boundary, and next useful move.

Create a durable campaign vault

python -B scripts/research_campaign.py init campaigns/passkeys --title "Passkey adoption decision" --query "Should small organizations adopt passkeys for customer accounts in 2026?" --tier focusedpython -B scripts/research_campaign.py validate campaigns/passkeys

Expected output includes INITIALIZED and VALID. That proves an internally consistent empty campaign, not completed research.

Advance from the first unverified edge

  1. Record query families and actual searches.
  2. Ledger every retained candidate before counting inspection.
  3. Write a substantive source note before marking deeply read.
  4. Link claims to source IDs and record scope and confidence.
  5. Update coverage and contradictions as the field changes.
  6. Draft from an evidence digest and ordered section briefs.
  7. Assemble and structurally audit the report.
  8. Run a separate semantic claim review.

Expected campaign outputs

ArtifactPurpose
Research brief and campaign.jsonInquiry, decision, scope, state, budget, blockers, and resume point.
Query, source, and claim ledgersSearch path, source states, claims, support, confidence, and contradictions.
Source notesFull-reading evidence, method, scope, dates, limits, and useful locations.
Coverage and contradiction mapsWhat matters, what is supported, what disagrees, and which gaps remain.
Report and auditsBounded synthesis, structural resolution, semantic dispositions, limits, and refresh triggers.

Other realistic uses

Technical comparison

Compare two deployment approaches using official documentation, failure modes, migration costs, operational evidence, and version cutoffs.

Policy decision

Map statutes, guidance, empirical evidence, stakeholder incentives, competing interpretations, jurisdiction, and change triggers.

Historical investigation

Separate primary records, later scholarship, provenance disputes, missing archives, inference, and unresolved explanations.

Market or product inquiry

Distinguish vendor claims, customer evidence, public records, adoption proxies, counterexamples, and decision criteria.

Assemble and audit

python -B scripts/assemble_report.py campaigns/passkeyspython -B scripts/citation_audit.py campaigns/passkeys

A passing structural audit means markers resolve to eligible records. It does not prove that each source entails the exact sentence. Use the vault reference, prompt recipes, and trust boundary for the full operating model.