---
description: Deep research workflow using researcher subagent
agent: researcher
subtask: true
permalink: opencode-config/commands/research
---

Research the following topic deeply and return a concise, evidence-backed report.

Topic:
$ARGUMENTS

Requirements:

- Read relevant basic-memory notes first (`search_notes` with `project="<repo-project-name>"`) for existing related research and decisions. Also check `project="main"` for cross-project guidance.
- If scope is ambiguous, ask one focused clarification question using the question tool.
- Provide findings, tradeoffs, and recommended approach.
- Record durable project-specific insights in per-repo project notes (`write_note` with `project="<repo-project-name>"`). Record cross-project reusable insights with `project="main"`. Use tags and WikiLink cross-references.