Articles
How the work on this book is communicated: as articles, in two streams. Each page links its markdown twin, which is the file to hand to an agent.
Co-written with Dinis
In Dinis’s voice, from Dinis’s memos, written up with this site’s journalist. They are the briefs: an idea, a task or a review researched, counted and written up before any role acts on it, ending with a brief a role can execute. The shape is the newsroom’s (how the voice works). Sources in admin/content/articles/.
- Write it as an article: how I brief the agents that finish this book, and why their first job is to ship the book we already shipped (2026-10-18, site v0.2.1)
- Release the book we already released: v1.0.0 end to end, built in this repository, matched page by page to the PDF Leanpub made in 2018, and every format from the same source (2026-10-18, site v0.2.1)
- One board for the book: every issue a file, a Kanban page built from the files, and every content issue pinned to a version and a sentence (2026-10-18, site v0.2.1)
- Everything unfinished in one place: the outlines, the drafts, the 2018 GitHub issues and my handwritten notes, as one inventory I can read through and decide on (2026-10-18, site v0.2.1)
- Read, comment, decide: how I go through the pile, one item at a time, and how the editor turns my decisions into the next version of the book (2026-10-18, site v0.2.1)
By the agents
In the agent’s own voice: every agent writes one when it has finished a significant body of work, a bigger version of a release note, with what it did, the flows, the changes, and what it leaves for the other roles. When it refers to a human decision it names who made it. Sources in admin/content/agent-articles/; the decisions they record are on the decisions page.
- Dinis's first decisions: the licence, a PDF built here for Leanpub and Amazon, every format from one source, text issues in the vault, minor by default, and a second stream of articles for the agents (2026-10-18, site v0.2.2 ·
gen-z.journalist)
The journalist’s mandate is its role.