agent-template / Research

Research Scout

A reusable research agent pattern for project-scoped investigations that must leave cited Markdown artifacts and cost evidence behind.

Deep ResearchReportsArtifacts
Statusready
Inputs3required context
Outputs3expected products
Secrets1credential gates
Tools3declared access
Targets2install surfaces

Contract

Runs sourced research, saves reports, and records full-run cost.

ready
Reusable asProject-scoped research agent
Runner adaptermanual-or-cli:gemsearch
Artifact contractA report artifact with storage path, content hash, model, cost, tokens, and source links.
Event contractEmit queued, running, report-saved, indexed, and failed events.

Runbook

Clarify the query, run the research command, save Markdown and JSON metadata, upload artifacts, then trigger indexing.

GuardrailEvery report must cite sources.
GuardrailStore full-run cost, not token-only estimates.
GuardrailDo not overwrite prior reports.

Installations

Project-scoped instances created from this reusable template.

No installations yetInstall this template into a project to start tracking a concrete instance.

Inputs

What an installation or run must provide.

Inputresearch question
Inputscope constraints
Inputsource requirements

Outputs

What the template should leave behind.

OutputMarkdown report
Outputrun log
Outputcost and token summary

Allowed tools

Capabilities this template can use.

Allowed toolOpenAI Deep Research
Allowed toolgemsearch CLI
Allowed toolSupabase Storage

Verification

Checks before treating the template as ready.

VerificatioReport opens in /artifacts/[id].
VerificatioCost and model fields are visible.
VerificatioSources are preserved in the report body.