research

name	research
description	Investigate a question against high-trust primary sources and capture the findings as a cited Markdown file. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated.

If your environment supports background subagents, spin one up to do the research so you keep working while it reads. Otherwise, do the research yourself in this session.

The job:

1. Investigate the question against primary sources — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it.
2. Write the findings to a single Markdown file, citing each claim's source.
3. Save it where the repo already keeps such notes; match the existing convention. If there is no convention, save to .plan/research/<slug>.md and say where.