Research Notes

Raw research notes produced by the /research-topic skill. Inputs to the content pipeline, not finished articles.

This folder holds raw research notes generated by the /research-topic skill. These are inputs to the content pipeline, not finished articles.

What Research Notes Are

When the evolution loop runs a research-topic task, it:

1. Searches the web for recent writing on the topic
2. Synthesises findings into a structured note with sources and confidence scores
3. Saves the note here as a .md file
4. Queues an expand-topic task to convert the note into a publishable article

Research notes are not published to the site. They are internal working documents.

Format

Each research note includes:

---
title: "Research: [topic]"
research_date: YYYY-MM-DDTHH:MM:SS+00:00
sources: []
confidence: low/medium/high
draft: true
---

Followed by:

• Summary — key findings in 2–3 paragraphs
• Key claims — bullet list of assertions with source citations
• Gaps — what the research didn’t resolve
• Suggested angle — recommended thesis for the expand-topic article

Lifecycle

research-topic skill → research note (here)
                     → expand-topic task queued in todo.md
                     ↓
expand-topic skill → draft article in the appropriate section

Once an expand-topic article is created, the research note can be archived or deleted. The evolution loop tracks pending conversions in evolution-state.yaml under task_chains.pending_articles.