Doctrine
The Borders
— min

Promises bind the weak; contracts bind the strong.

APIs are borders between polities. Make them stable, versioned, and backward-compatible — or make them nothing at all.

Listen to this essay Audio will be available when the essay is published
— / —

Preview of what is coming

The essay will be organised around five movements, in the editorial tradition of these doctrines:

  • The sutra, restated at length — the principle, the corollaries, and the test that distinguishes a kingdom that follows it from a kingdom that merely cites it.
  • Real-world collapses — three public or near-public case studies where the principle was ignored, with a precise anatomy of how the failure cascaded.
  • Real-world victories — three cases where the principle was followed against pressure, and the system survived what would have ended a less principled kingdom.
  • The anti-patterns — the common ways an organisation rationalises the abandonment of the principle, with a worked refutation of each rationalisation.
  • The operating cadence — the weekly, monthly, quarterly, and annual practices that keep the principle alive in a system whose people will, eventually, change.

Until the full essay is published, the shorter statement of the sutra on the Doctrine page is the canonical reference. Subscribe via the RSS feed to be notified when the deep-dive is published.


Composed inHTML / CSS / JS — no frameworks
TypeFraunces · Inter · JetBrains Mono
SeriesSystem Nīti · APIs
Sutra06 of 15 — The Borders
Other essays in the doctrine
07 · Scaling Armies that cannot coordinate lose battles. The Armies · ~6,000 words 11 · Security An open gate invites invasion. The Watch · ~6,000 words 12 · Deployment A wise king does not burn the city with each celebration. The Coronation · ~6,000 words