research is an archived example, not installed by init. Copy it from examples/init-pack/ with its dependency closure, or ask create-workflow for one, then run it:
research asks a tool-capable agent to inspect the repo and gather context before planning or implementation.
The research UI shows the tool-capable agent inspecting the repo and external sources before any planning.
Inputs
Use it when
- The task touches unfamiliar code, or external docs and dependency behavior matter.
- Want file references and prior art before committing to a plan (follow with
planormission).
Use something else when
- Already have enough context and just need a plan: use
plan. - Ready to build: use
research-plan-implement, which runs this research step for you.
Resume & retry
research is read-only: it gathers context without changing the repo and returns it in the output. Runs are durable and resume with up --resume.