Research

If decision-making:

• "What decision are you trying to make?"
• "Any specific criteria or constraints I should focus on?"

If writing/creating:

• "What's the output? (Blog post, report, presentation?)"
• "Who's the audience?"

Keep it natural — 2-3 questions max. Don't interrogate.

Step 2: Spawn Research Agent

Once you have context, use sessions_spawn to run the research:

sessions_spawn(
  task: "Research: [FULL TOPIC WITH CONTEXT]
  
Use Gemini CLI to research this topic. Run:

gemini --yolo \"[RESEARCH PROMPT]\"

The research prompt should ask Gemini to cover:
1. Overview & Core Concepts - what is this, terminology, why it matters
2. Current State - latest developments, major players
3. Technical Deep Dive - how it works, mechanisms, key techniques
4. Practical Applications - real-world use cases, tools available
5. Challenges & Open Problems - technical, ethical, barriers
6. Future Outlook - trends, predictions, emerging areas
7. Resources - key papers, researchers, communities, courses

Save the output to: ~/clawd/research/[slug]/research.md

Be thorough (aim for 500+ lines). Include specific examples and citations.

IMPORTANT - When research is complete:
1. Send a wake event to notify the main agent immediately:
   cron(action: 'wake', text: '🔬 Research complete: [TOPIC]. Key findings: [2-3 bullet points]. Full report: ~/clawd/research/[slug]/research.md', mode: 'now')
2. When asked to produce an announce message, reply exactly: ANNOUNCE_SKIP",
  label: "research-[slug]"
)

Important: Include all context from your conversation in the task so the sub-agent understands the full picture.

Step 3: When You Receive Wake Event

You'll receive a wake with the research summary. Then:

• Share the findings with the user
• Offer to read the full report or dive deeper on sections

Output Location

Research saved to:

~/clawd/research/<slug>/research.md

Tips

• Research typically takes 3-8 minutes depending on complexity
• Gemini CLI uses your Google AI subscription quota
• The --yolo flag auto-approves file operations (non-interactive)
• Check ~/clawd/research/ for all past research
• Always include conversation context in the spawn task for better results