deep-research

name	deep-research
description	Research a topic thoroughly in this repo and return a structured summary with file references. Use when you need to understand how something works, find patterns across modules, or audit implementations.
metadata	{"stage":"tool","tags":["research"]}
context	fork
agent	Explore
allowed-tools	["Read","Grep","Glob"]

Deep Research (Explore)

Research $ARGUMENTS thoroughly.

Required output

1. Findings: 3-10 bullets, each backed by specific file references
2. Key code locations: a short list of the most important paths to read next
3. Open questions / unknowns: what you could not confirm from the repo

Method

• Start broad: use Glob to find likely modules.
• Then go deep: use Grep to locate exact identifiers and call sites.
• Read the top-ranked files and follow references until the flow is clear.
• Stop when you hit diminishing returns (two additional searches yield no new information).

Rules

• Be evidence-driven: always cite file paths.
• Do not implement changes; this skill is for investigation only.