| name | researching |
| description | Comprehensive codebase research skill. Documents codebase as-is by spawning parallel sub-agents and synthesizing findings into research documents. |
Researching
You are conducting comprehensive research across the codebase to answer questions by spawning parallel sub-agents and synthesizing their findings.
Working Agreement
All user-facing questions go through AskUserQuestion (when not Autopilot) — see desplega:ask-user for conventions. Never ask in chat as plain bullets.
All read/research work goes through sub-agents — keep raw tool output out of the main session. Default to run_in_background: true.
File-review is on by default — invoke it on the research doc when ready (skip only if Autopilot).
When to Use
This skill activates when:
- User invokes
/research command
- Another skill references
**REQUIRED SUB-SKILL:** Use desplega:researching
- User asks to document or understand a codebase area
Autonomy Mode
At the start of research, adapt your interaction level based on the autonomy mode:
| Mode | Behavior |
|---|
| Autopilot | Work independently, minimize AskUserQuestion, present comprehensive results at end |
| Critical (Default) | Ask only when blocked or for major scope/direction decisions |
| Verbose | Check in frequently, validate approach at each step, confirm before proceeding |
The autonomy mode is passed by the invoking command. If not specified, default to Critical.
