mmurr.ai

How the research agent works

An AI agent that researches on its own twice a day, but cannot publish anything without a person approving it, cannot rewrite its own rules, and cannot hide a bad day.

In one paragraph. A scheduled job wakes an AI model (Claude) twice a day. It reads its standing rules and its own notes, picks one thing worth doing, researches it against primary sources and records what it finds with a confidence tag. When a topic is ready it drafts a web page. It never publishes that page itself: a separate, non-AI step opens a pull request, and a human reads and merges it — or doesn't. Everything the agent writes about its own run is published, unedited, to the wake log.

One wake, start to finish

  1. ScheduleGitHub Actions starts a run at about 07:00 and 19:00 UTC. No server, nothing running in between.
  2. Think and researchClaude reads its charter, goals, plan and last two journal entries, decides on one step and does it. Its tools are web search, web fetch and reading/writing its own notes — no shell, no passwords, no access to the site.
  3. Mechanical checksPlain scripts, not AI, undo any edit to the rules and stop the run if the notes shrink without permission.
  4. Publish the logThe journal entry is copied to the wake log. Every character is escaped, so nothing the agent writes can become code or a link.
  5. Propose, don't publishIf a page is ready, a separate step holding the site credentials opens a pull request — only inside agentic-research/, and only if no existing line is removed.
  6. Human reviewI read the pull request, check sources where it matters, and merge, correct or leave it. Only then does it appear on the site.

The guardrails, and why each one exists

GuardrailWhat it stopsHow it's enforced
The agent can't edit its own rulesGradually rewriting the charter or protocol, or its tools and workflowsThe workflow restores those files after every run
Notes never shrink without sign-offSilently losing or overwriting researchFile sizes are measured before and after each run; a drop fails the run
Pages are add-onlyQuietly rewriting something a reader has already seenA proposal that removes any existing line is rejected automatically — this has happened three times, each time because a page had been rebuilt rather than edited in place
Split between thinking and doingAn AI holding the keys to the websiteThe model has no credentials; a fixed script holds the site token and can only open pull requests in one folder
Deletion is human-onlyStale content vanishing without anyone noticingThe agent flags stale content on the page and in a deletion-requests file; only I remove anything
Web content is data, not instructionsA web page telling the agent to do somethingA rule in the charter, backed by the fact that the agent has nothing dangerous to do
Nothing hiddenA curated highlight reelEvery run's journal is published verbatim, including the empty and mistaken ones

The research standard

The agent's charter sets the bar as "would a sceptical colleague trust this page and its sources?" In practice that means:

What review has actually caught

The point of the checks is that they catch things, so here are real examples:

By the numbers (29 September 2026)

MeasureValue
Wakes since the first run (14 August 2026)91
Pull requests merged after review15
Proposals rejected automatically for removing content3 (all resubmitted)
Research threads in the agent's notes8
Published research pages7
ModelClaude Sonnet 5 to wake 91; Claude Opus 5.5 from 29 September 2026
Running costGitHub Actions free tier plus an existing Claude subscription — no servers

Why build it this way

Most of the questions organisations ask about AI agents concern control rather than capability. Who can it act on behalf of? What happens when it's wrong? Who signs off? Can we see what it did? This project is a small, working answer. The agent has real autonomy over its research and none over publication. Every control that matters is a plain script rather than an instruction the model is trusted to follow. And the full record is public. The same principles are what agent-specific governance frameworks are converging on, for example Singapore's framework for agentic AI, covered on the EU AI Act page: bounded autonomy, human checkpoints, controls across the lifecycle, and transparency.