Skip to main content
Research turns workspace configuration and external evidence into immutable artifacts. A completed research run is required before current prompt regeneration.

​
Requirements

  • Products and services must be filled in.
  • The operator must provide OpenRouter and Exa credentials.
  • The workspace needs enough competitor and ICP configuration for the requested stages.
  • The credit operation must reserve successfully.
An on-demand research run is limited to one start per workspace per hour. Research also uses the shared workspace job slot. A running measurement, recommendation-generation job, or SEO refresh blocks the start before the research worker launches.

​
Five stages

1

Product and service map

Builds a structured map from the immutable workspace settings staged for the run.
2

Competitor discovery and profiles

Combines configured competitors with Exa evidence derived from Search Console queries.
3

SERP topic map

Uses product queries and Search Console queries to collect and group Exa search evidence.
4

Market summary

Summarizes product, competitor, analytics, and authority evidence. Missing GA4 evidence is recorded as a risk rather than filled with a guess.
5

ICP query patterns

Produces query patterns for each ICP from completed upstream artifacts and Search Console evidence.
The artifact registry includes product_service_map, competitor_profile, serp_topics, market_summary, icp_query_patterns, and site_audit. The five-stage worker produces the market and ICP artifacts described above. Technical site audits have their own pipeline.

​
Artifact contract

Each artifact includes:
  • A strict kind and schema version
  • The research run and credit operation identifiers
  • UTC observation times
  • Source envelopes with signal, URL, or upstream artifact references
  • Canonical content and source digests
  • A SHA-256 artifact digest
Provider attempts are also persisted. Once an attempt has responded, it is immutable. An ambiguous outcome is not automatically resent because that could duplicate provider cost.

​
Completion and eligibility

Only artifacts from a completed research run can appear in the latest eligible view. Artifacts written before a failed run are retained for diagnosis but cannot feed prompt regeneration. Research becomes stale seven days after completion. The UI can still show the old trace, but prompt regeneration refuses it.
A completed artifact proves what the pipeline observed and derived. It does not prove that every external source was available or current. Read source timestamps and recorded risks.

​
Trace view

Use a run’s trace to follow:
Matching digests establish lineage. They do not imply that later prose was copied verbatim from a source.