Ubiquitous language is the answer to so many pains of agentic coding

Sun, 02 Aug 2026 00:00:00 +0000

I’m prone to being overly enthusiastic when something seems to fit perfectly puzzles I try to solve. Right now I’m in that state exactly. Ubiquitous language is the answer to so many pains of agentic coding. Part of my current experiment vocabulary started as “Workflow”, then it gave birth to sibling “Component”, then “Fabric” was extracted from “Component” when its meaning got refined, and then “Fabric” revealed “Substrate” underneath. Each of the evolving terms guiding both me and the agents in the correct direction, constraining what conceptually makes sense within the bigger picture defined by vocabulary.

A shared language earns you the right not to read the code

Mon, 27 Jul 2026 00:00:00 +0000

Adopting ubiquitous language (where agents are heavily responsible for keeping you, the codebase, and the vocabulary in alignment—otherwise, drift will kill you) greatly improves alignment between what you want and what agents deliver.

There is still tactical cognitive debt. You have no idea about the details of delegated implementation, but that’s OK. You decided to be a Lieutenant General, not a Lieutenant, so you move divisions, not platoons.

You note that a particular operation introduces side effects that break everything that follows. You can change the implementation to mitigate them; you can ask an agent to do it—it might be enough to move forward. Until a minute, hour, day, or month later, when you or an agent breaks the silent, tribal contract you made by fixing the implementation to be pure and idempotent. It won’t fly at scale. Shit, it won’t fly even in domain discovery mode for a non-trivial personal project.

Agentic Coding on Gniewomir Świechowski

Ubiquitous language is the answer to so many pains of agentic coding

A shared language earns you the right not to read the code