New Research

New research note

Research belongs in the repo, traceable to sources, and is never silently deleted (R9). This scaffolds one note per topic.

When this fires

"start a research note" / "capture these sources" / beginning any multi-source investigation whose findings should outlive the session.

Fast path — if the Agentsmith CLI is available

Run agentsmith new-research "topic name" — use .agentsmith/agentsmith on macOS/Linux or .agentsmith\\agentsmith.cmd on Windows when the command is not on PATH. It slugifies the title and writes docs/research/<slug>.md from the template (it won't overwrite an existing file).

Fallback — no CLI

1. slug = the topic lowercased, every run of non-alphanumeric characters → -, ends trimmed.
2. If docs/research/<slug>.md already exists, STOP — append to it, never overwrite.
3. Otherwise create it with a no-delete banner (obsolete → move to docs/research/_archive/, R9) and these sections:
   • Question / scope
   • Sources consulted — url or citation; what you actually opened, dated.
   • Findings — each traceable to a source above; mark single-sourced / uncertain items.
   • Open questions / what was NOT checked.

Report

Name the file created and remind the operator to commit it (R9 — research lives in git, not memory). Every finding you add later must cite a source already in the note.