Shared Language

Type
Explainer
Updated
Known gaps (1)
  • Not yet addressed from the September 2026 site review. One abstract DDD principle; show a term carried through code and documentation.

Eric Evans' idea, summarized by Agile Alliance, is that the domain vocabulary should continue all the way into the source code.

In software engineering, we define a ubiquitous language as a language used by all team members within a bounded context to connect team activity with the software. This matters even more with agents because they infer structure from names. If naming is sloppy, the agent's reasoning is sloppy.

If a term is overloaded, it will be overloaded in prompts, code, tests, and bugs.

Fix 1: Define Language

Create a docs/ubiquitous-language.md file.

Use a skill to ensure that terms are unambiguously defined.

Type to search every note and essay.