research
Installation
SKILL.md
Do research in this session. A subagent reads instead in three cases. The user asks to give the reading to a subagent. A draft spec launches its AFK decisions. Or the payload is too large for the session: over about 2,000 lines, or images. Guard the context window tells how. The subagent returns the note, not the payload.
- Sort the question. A question about how a library, service, or standard behaves goes to its owner, in step 2. A question about why our code has its shape goes to its history, in step 3.
- Read the owner of the fact: the vendor documentation, the source code, the specification, or a live endpoint response. A blog post, a forum answer, or a summary only points you to the owner. It is never the citation.
- Read the history as why.md says. First pin the code. Then read each source that why.md lists. Name every source that the session cannot reach.
- Return one Markdown note, with the source after each claim. Write the note to the path that the caller asked for. When the caller gave no path, use the place where the repo keeps similar notes. When there is no such place, choose a location, and name it in the reply.
Rules:
- A citation points at the owner. For behavior, that is the vendor, the source, the spec, or the live endpoint. For intent, it is the commit, PR, ticket, doc, or message that holds the decision.
- Never invent a citation. A search that finds nothing is an answer. Write it in the note as a gap.