/research

description: Research a topic from the web and build teaching-quality notes with real sources
argument-hint: <a topic or question to research>

Research the topic in `$ARGUMENTS` and turn it into notes that teach.

1. **Recall + fit.** Read `.agents/learned/conventions.md` if present and see how this vault is organized, so the result lands in the right place in the right shape. 2. **Research.** Search the web and fetch authoritative sources — papers, official docs, primary references. Prefer primary/real sources over second-hand summaries, keep the URLs for citation, and note where sources disagree or are uncertain. 3. **Pick the altitude.** A focused question → one strong note plus a source note. A broad topic → a small collection with an index, concept notes, and a concept-graph canvas if there are 3+ units. (See "Choose the altitude" in `.agents/ingestion-workflow.md`.) 4. **Write** to the standard in `.agents/style-guide.md`: open from the real question; explain mechanism, assumptions, and limits; use the artifacts that genuinely teach (runnable code, an equation, a diagram); and cite sources in a `Sources` section with links. 5. **Wire & validate** every wikilink, then **reflect** (journal entry + any durable lesson).