Editorial

The rest of this site teaches, and teaching material has no opinion. This is where the opinion goes. Each piece starts from something that actually happened in artificial intelligence or in software architecture — a release, a result, a failure, a shift in how the work is done — and argues its way to a position: what genuinely changed, what is only being marketed as change, and what a working architect should do differently because of it. Positions are arguable on purpose, and everything they rest on is linked and dated.

51 editorials 6 strands 362 cited sources 84,496 words

How architecture is actually done — reviews, ADRs, diagrams, documentation and the craft of deciding.

Practice & Method 17 October 2026 8 min read New

The plan was the answer

Claude Managed Agents now lets an agent write the program that orchestrates up to a thousand other agents, run it at once, and keep its code out of view. That is how databases treat a query plan. A database can hide its plan because the plan cannot change the answer. This one decides what the answer is.

Dynamic workflows hide an agent's orchestration program the way a database hides a query plan, but a plan may be private only when it cannot change the result, and this one decides what is read, what is retried and what counts as finished.

Read it → 3 sources agentsorchestrationworkflowsdesign review
Practice & Method 12 October 2026 8 min read New

Deleted for posterity

On 2 October a merged Kubernetes design document was reverted out of the tree — 2,020 lines removed — because a maintainer concluded it had been written with undisclosed AI assistance. The project reserves a status for proposals that are kept as historical documents, and has nowhere in the repository to put the fact that decided this one.

Kubernetes requires AI disclosure in the pull request description and forbids the commit trailer that would carry it, so when provenance decided the fate of a merged design document, the only way the record could express doubt was to delete it.

Read it → 9 sources decision recordsprovenancecode reviewopen source
Practice & Method 10 September 2026 8 min read

The second copy is the one that runs

The same commit trailer is required by the Linux kernel, required by Node.js, and forbidden by Kubernetes. Major projects are now writing their contribution rules down twice — once for people, once for the machine — and nothing checks that the two versions still agree.

Every serious project now keeps two copies of its contribution process, one addressed to contributors that carries the authority and one addressed to agents that carries the effect, and the second copy is a derived artefact whose derivation nothing enforces.

Read it → 9 sources agent instructionscontribution policyopen sourceprocess documentation