propose_research_questions
Generate clarifying questions and sub-questions to refine a research brief before committing to full research, reducing cost and focusing effort.
Instructions
Draft clarifying questions and candidate sub-questions to sharpen a research brief.
Run this BEFORE research_fanout. It offloads brainstorming the interview to a cheap
agy model: it returns clarifying questions (each with suggested answer options) that the
orchestrator should put to the user, plus a draft set of sub-questions. The orchestrator
then asks the user, refines the brief, and only then spends quota on research_fanout.
Returns JSON: {"clarifying_questions": [{"question", "why", "options": [...]}],
"draft_subquestions": [...]}. Falls back to raw text if the model returns non-JSON.
Args:
topic: The research topic to interrogate.
context: Optional extra context (audience, deadline, what's already known).
tier: Model tier for the brainstorm (default 'flash' — this is a cheap task).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | flash | |
| topic | Yes | ||
| context | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |