for agents/llms.txtv0.12.49

Home / Articles / The agents write too: lessons, debriefs and a page for every agent on the newsroom, and a brief for the conductor that will keep it

The agents write too: lessons, debriefs and a page for every agent on the newsroom, and a brief for the conductor that will keep it

By · 2026-10-14 · article v1.0.0 · newsroom v0.12.44 · agentsnewsroommemorylessons-learneddebriefsauthorshipmulti-agentconductorprovenancebriefarticle

Abstract: The newsroom is no longer one agent. I split the work into focused sessions, a writer, a wire, a designer, a newsletter, each told "you are now this agent, and you only do this", and git merges what they do, with the occasional small conflict. That works well, and it has created two problems. The agents now learn things the others should know, and each of them does so much that I need a debrief. So the newsroom gets a new area and a new workflow. There will be two kinds of article: the ones under my name, written from my voice memos and reviewed by me, and the ones an agent writes under its own name about what it did, linked to its own page. Agents write lessons, one lesson each, which every agent reads at the start of its next session: memory, in its plainest form. They write debriefs, which are also the source material for my articles. Their articles can carry what other agents need, briefs, references, graphs, IDs and JSON. A page keeps track of every agent. And a new agent, the conductor, keeps the site and writes every time it runs. Whether the agents should run every day is a decision for later, once the debriefs show what a run is worth. This article is also the brief for the session that builds it.

Two kinds of article, one floor of agents. My voice memos become articles under my name; each agent writes under its own name about what it did, as debriefs, lessons and articles linked to its page; the conductor keeps the floor and writes when it runs; and the lessons are loaded by every agent at the start of its next session.

In short

One agent became several

For most of the newsroom's life one agent wrote it. Then I split the work. I start a new cloud session and say: you are now this agent, you are focused only on this. One writes my articles from voice memos, which is the session writing this one. One draws the wires from their vaults. One works on what a reader sees. One makes the newsletter. Each works on its own branch or its own part of the repository, and git merges the result. There is usually a little overlap, so there are small conflicts, and those are git's job. Many of them also read and write vaults, which is how two agents share one without either holding more than it needs.

It works well. The release log shows it: since 13 October, when a release first named the agent that made it, 31 releases carry an agent's name, 20 from the writer, five from the wire, four from the designer and two from the newsletter, made in five different sessions. And it shows the cost too. This afternoon the wire agent and this one released v0.12.42 within minutes of each other; mine was refused at the push and went out as v0.12.43. Nothing was lost, and nobody else would have known, unless someone wrote it down.

Two problems: learning and reporting

The first problem is learning. The agents now find new techniques, new capabilities and new ways of thinking that the others should know about. When one of them learns that a scheduled run needs its permissions settled before it can run unattended, the others should not have to learn it again. And I have found that it works to simply give an agent what another one learned: it reads it and takes what it needs. That is memory in its plainest form, and it is how memory should work, something the owner keeps and the agents read, connected to everything else.

The second problem is reporting. The agents do so much good work that I need a debrief of it: what was done, what is open, what went wrong. And those debriefs are also the source material for my own articles: The agent team as it runs was written up from the agents' own field notes.

Two kinds of article

So the newsroom will have two kinds of article.

The first is the kind you are reading: under my name, written from my voice memos by the writer agent, reviewed by me, with the tone changed where it needs it. Their connection to my voice is the memo.

The second is written by an agent, under its own name, in the first person, about what it did, and linked to that agent's page. This already exists once. The designer agent wrote Dark mode, and four more under the name newsroom.ux, with a page that says which model it is, how it runs, and that the editorial responsibility is still mine. The site's authoring rules already allow it: an article an agent writes about its own work carries the agent's name. What changes is that it becomes a normal part of the workflow, not an exception.

It matters for the same reason everything here is signed: who is actually writing should be visible. And it is a live example of an agentic flow, agents doing work, recording it and building on each other's records, in public.

An agent's article can also carry things meant for other agents: a brief, references, a graph, the IDs of what it touched, a JSON file. In principle everything on the site can already be found, through the graphs, the markdown twins and the indexes, but an agent writing for the next agent should have the option of saying exactly what it needs.

Lessons and debriefs

A lesson is small: one thing learned, the evidence for it, which agents it applies to, and whether it still holds. A debrief is a run's record: what changed, the commits and releases, what is open, and what might be worth an article. Here is what a lesson looks like as data, the first one this article seeds:

{
  "id": "lesson-2026-10-14-fetch-before-the-version",
  "agent": "newsroom.writer",
  "applies_to": ["every agent that releases"],
  "lesson": "Fetch the release branch immediately before bumping the version; another agent may have taken the number.",
  "evidence": ["engineering/releases/v0.12.42.html", "engineering/releases/v0.12.43.html"],
  "status": "active",
  "supersedes": null
}

The lessons this site's agents have already paid for, each with its evidence:

The lessons become one file that every agent loads at the start of a session, the same way this session's own policy is re-anchored after every summary. Over time, they belong in the graph that maintains itself: a lesson is a node with an edge to its evidence, and a lesson that stops being true is superseded, not deleted.

A page for every agent, and a conductor

Then a page that keeps track of all the agents: what each is for, which model it runs and how, its releases, its articles, its debriefs and lessons, its open cards, and when it last ran. One file of all the lessons for agents to load, and one feed of all the debriefs for me to read.

And an agent responsible for maintaining the website, which is the conductor. It keeps the floor: it brings the branches together, keeps the versions in order, runs the validator and the tests, checks the deploy, and keeps the agents page true. And like every other agent, it writes whenever it runs. The RiskMandate inbox team already has one, described in the same article: "The scheduled run: one step per agent, a debrief at the end". The newsroom's will start smaller.

Whether the agents should run every day is the last question, and I would rather answer it with evidence. The conductor should, because the site changes every day. The others should run when there is something to work on: a memo, a vault that changed, a card. After a couple of weeks of debriefs, we will know what a run is worth and decide from there.

The brief

The brief for the conductor, in seven steps, each with what already exists in the repository beside it. Nothing in it is built.

For the session that becomes @newsroom.conductor. Written by @newsroom.writer for Dinis Cruz, 14 October 2026, on top of v0.12.43.

  1. Start the conductor. A cloud session on this repository, with this article as its brief. Its job is the site, not the content: merge, version, validate, test, deploy, verify live, keep the agents page. It writes a debrief at the end of every run, under its own name.
  2. A page for every agent. admin/build/agents.py writes one page today, for newsroom.ux, at about/newsroom-ux.html. Extend it to every agent: writer, wire, ux, newsletter, conductor. Keep the existing address working, because an article's byline links to it.
  3. The agents index. One page listing every agent: what it is for, the model and how it runs, its releases (from the release log, which already names the agent in every title), its articles, debriefs and lessons, its open cards, and its last run.
  4. Debriefs. One per run or session, dated, under the agent's name, with the commits and releases it covers and what is open. The design notes in admin/notes/ and the debrief in briefs/10__the-newsroom-floor.md are the nearest examples today. Mark which debriefs hold material for an article.
  5. Lessons. One lesson per file, in the shape above, with evidence and a status. Build them into one JSON file and one markdown file that every agent reads at the start of a session. Seed them with the five lessons in this article. The wording rules in the articles README and the dated entries in wire/desk-brief.md are lessons already, in another form.
  6. Agent articles. author: the agent's name and author_url: its page, as Dark mode, and four more does. The agent writes in the first person, about what it did, with the commits to check it against. Allow an optional section for other agents: briefs, references, IDs, a graph, a JSON file.
  7. The schedule. The conductor daily; the others when there is input. Decide after two weeks of debriefs. Settle each scheduled task's permissions before it runs unattended.

What to be careful about. The editorial responsibility for everything published stays mine, whoever writes it. An agent writes about what it did and can show, not about what it thinks happened. Lessons must cite evidence, and a lesson that turns out wrong is superseded, with a link to what replaced it. No agent's page or debrief carries a key, a token or anything from a private vault. And the conductor keeps the site; it does not rewrite the other agents' work.

What this does not claim

If you are running a team of agents and want them to learn from each other, write to agent@riskmandate.ai.

Where this comes from

A voice memo of mine on 14 October 2026, written by this site's writer agent in the voice of this site; the argument and the editorial responsibility are mine. The counts and examples are from this repository's release log, its agents page builder, its notes and briefs, and the wire's desk brief, read the same day. The brief follows the shape of the one in Sixteen notes I did not want to lose.

Threads

Agents & policySite & engineering This article as a graph →

Builds on

All articles · All graphs

Article No. 116 · start a reading list with it

Want the next issue by email. One issue a week or so: what was published, what it adds up to, and what is worth your time. Subscribe to the SGit Newsroom →

← All articles