researcher.template.txt

Run the memory-researcher loop once for topic <TOPIC>.

Placeholders to substitute from the pipeline spec before use:
  <TOPIC>      the pipeline's topic, kebab-case
  <LENS_ID>    this researcher's id
  <LENS>       what this agent looks at, and how it judges — the spec's `lens` block
  <SOURCES>    where to look, from the spec's `sources`

1. RECALL FIRST: run `clawdi memory search "RESEARCH-NOTE <TOPIC>"` and `clawdi memory search "FILECOIN-MEMORY <TOPIC>"`. If a FILECOIN-MEMORY receipt exists, consolidated knowledge is already archived — download it with `foc-cli download <its pieceCid> --out ./recalled.json` (which validates the bytes against the CID) and research only the DELTA since its date: what changed, what is new, which prior conclusions are now wrong (flag those in contradicts). Require the receipt's topic to match <TOPIC> exactly — never substitute a near match. On a fresh install both searches are empty; do a full first scan.

2. RESEARCH (<LENS_ID> lens): <LENS>
   Sources: <SOURCES>
   Report only what changed since the last note. Every claim carries a source. This is RESEARCH ONLY — observe and report; never take an action on the user's behalf, and never emit instructions that would spend money or change external state.

3. WRITE THE EVIDENCE FILE: save the raw findings as JSON to observations/<LENS_ID>-<TOPIC>-<YYYYMMDD>.json (create the directory if needed; use today's date). Keep the raw shape — this is what makes a claim auditable after consolidation prunes the notes.

4. FILE EXACTLY ONE RESEARCH-NOTE into Clawdi memory, category context, single line, this exact format (use today's date):
   clawdi memory add "RESEARCH-NOTE | topic: <TOPIC> | tags: research-note,topic:<TOPIC>,lens:<LENS_ID>,status:raw | date: <YYYY-MM-DD> | status: raw | summary: <1-2 standalone sentences> | facts: <finding - why it matters - confidence>; <next finding>; ... | sources: <domains> | refs: none | contradicts: none" --category context

5. Print the note content and the evidence-file path as your final output. Do not store anything on Filecoin — consolidation is another agent's job.