Organizational Legibility

Making an organization's tacit work, rules and knowledge explicit and machine-readable — the precondition for AI to compound, and a technology of control that raises legitimacy questions.

Also known as: legibility, legible (to a machine), machine-legible, tacit knowledge, tribal knowledge, metis, flattening, L0-to-L2 problem, ontology, legitimacy, bus factor, visibility, artifact, assumptions as code, legible variety

How authors use it

Oldest first (extraction date when no publication date is known).

AuthorTheir termTheir meaning
Philosophy Eats AI: What Leaders Should Know
MIT Sloan Management Review · 2025-05-14
ontologyHow an organization labels, categorizes, and constitutes the things in its world — e.g., what counts as 'loyalty', 'customer experience', 'partnership'. AI training depends on these categorizations being explicit and coherent.
TBM 414: Legibility and Legitimacy
John Cutler from The Beautiful Mess · 2026-04-04
legibilityMaking organizational processes visible, interpretable, and machine-actionable through selective simplification — a technology of control, not a neutral transparency. Cutler (following Scott) treats legibility as enabling control by those who read the system, not as serving those being read.
TBM 414: Legibility and Legitimacy
John Cutler from The Beautiful Mess · 2026-04-04
legitimacyWhether control is accepted as justified by those subjected to it. Derived from law (lex), not observation — it is a normative, political concept, not a descriptive one. Legitimacy asks: who decided this was acceptable, and on what grounds?
#2: The Unsexy Truth of AI Adoption
Turing Post (Ksenia Se) · 2026-04-04
legible (to a machine)An organization is legible when it can describe its own work in a form that a machine can act on: explicit rules, documented exceptions, named conventions, defined approval chains — the actual processes, not the policy document version. Distinct from 'visible to management': legibility requires precision machines can work with.
#2: The Unsexy Truth of AI Adoption
Turing Post (Ksenia Se) · 2026-04-04
tacit knowledgeOrganizational knowledge that lives in people's heads, in informal practice, or in relationships — the actual rules for processing an invoice, the real approval chain (not the org chart version). Not captured anywhere, not describable in a form machines can act on. The primary blocker at L0-L1.
#2: The Unsexy Truth of AI Adoption
Turing Post (Ksenia Se) · 2026-04-04
bus factorUsed directly: the risk when critical knowledge lives in one person. Making work legible reduces bus factor. The construction firm case (224 commits of logic in one developer's head) is the exemplar.
Introduction
johnpcutler.github.io · 2026-04-10
visibilityGenuine understanding of what is happening in a system, as opposed to mere access to dashboards and status reports.
Introduction
johnpcutler.github.io · 2026-04-10
flatteningThe loss of nuance, context, and variability that occurs when complex work is forced into simplified representations for reporting or governance purposes.
Introduction
johnpcutler.github.io · 2026-04-10
legibilityThe formal clarity that organizations impose on complex work to make it readable at a distance -- often in tension with local understanding (metis). Draws on James C. Scott's usage.
Introduction
johnpcutler.github.io · 2026-04-10
ontologyThe system of categories, names, and relationships an organization uses to represent and reason about its work -- not a philosophy exercise but a practical design choice.
Introduction
johnpcutler.github.io · 2026-04-10
metisLocal, experiential, contextual knowledge that resists formal capture -- the practical understanding that people on the ground have versus what dashboards show. From James C. Scott via Greek concept.
Assumptions as code: SiriusXM's approach to platform prioritization
DX · 2026-04-10
assumptions as codeOrganizational assumptions (about users, usage patterns, incident frequency, etc.) stored in a Git repository as structured data, version-controlled and queryable by AI, so they can be validated, updated, and surfaced during planning.
#3: How to Build an AI-Native Startup from Day One
Will Schenk (TheFocus.AI) and Ksenia Se (Turing Post) · 2026-04-11
machine-legibleOrganizational knowledge stored in forms machines can read, search, and act on -- plain text, Markdown, transcripts, decision logs -- with naming conventions, version history, and ownership
#3: How to Build an AI-Native Startup from Day One
Will Schenk (TheFocus.AI) and Ksenia Se (Turing Post) · 2026-04-11
artifactAny piece of relevant work externalized into a durable, searchable form: notes, transcripts, plans, decisions, specs, summaries, reviews
Three Pillars of Platform Engineering: A Virtuous Cycle
Pratik Agarwal · 2026-04-20
tribal knowledgeOperational expertise that lives in people's heads or Slack threads rather than in tooling — a scaling problem disguised as a people problem.
Everyone wants to be AI-pilled. Most Companies Are Still Level 1
Ann Miura-Ko · 2026-05-01
legible (to a machine)Whether an organization's work — knowledge, processes, systems of record — exists in a form AI can actually read and act on, versus living undocumented in people's heads, meetings, and unintegrated SaaS tools. The first of the four diagnostic questions ('what can AI see?').
#5: AI Workflow Patterns: The Real Unit of AI Adoption in 2026
Turing Post (Will Schenk & Ksenia Se) · 2026-05-09
L0-to-L2 problemMaking the organization legible to itself — discovering and documenting the informal workflows that exist but have never been written down (references Article #2 in the series)
TBM 421: Minimally Viable Consistency (Part 3)
John Cutler · 2026-05-09
legible variety
The engineering manager role is splitting in two
Stephane Moreau · 2026-06-09
FlatteningThe reduction of management layers now underway — but happening as an unplanned byproduct of cost-driven layoffs and reorganizations rather than deliberate organizational design, which is why the future EM role is genuinely undecided.
Tony Seale's Post
Tony Seale · 2026-07-05
OntologyThe semantic layer supplying identity, type, relationship, constraint and meaning; 'how agent memory grows up' — the shared formal vocabulary a vault's fields link into.
TBM 428: Yes, Robot. Yes, Boss?
John Cutler (The Beautiful Mess) · 2026-07-06
legibility (context as control)Making an organization's work machine-readable from above — surveillance, standardization, simplification and administrative power. The dark twin of mētis: the same context-making that could enable hivemind can instead enable control.
Managers Are Not Overhead: They Are Infrastructure
David Michelson · 2026-07-22
flatteningremoving management layers / widening span of control — explicitly distinguished from contraction; flattening can coexist with an expanding, not shrinking, managerial role
TBM 437: AI and the Recontextualization Tax
John Cutler · 2026-09-03
FlatteningThe act of stripping detail and nuance from a working reality to produce a simplified representation (a report, roadmap, or overview) legible to a less-detail-tolerant audience.
Presentation: From Retrieval to Reasoning: Building Production-Ready Agentic AI Systems with Knowledge Graphs
Cassie Shum · 2026-09-12
visibility (agent/team visibility)Retrospectively queryable records of agent activity — tokens used, turns taken, cost per task, context bundle contents and size, tasks shipped over time — surfaced from the same graph that already holds context and provenance data, used for audits, reporting, and team-effectiveness review, not merely a live progress display for one user.

Documents (51)

Propositions touching this concept (64)

By publication month, oldest first (extraction month when no publication date is known).

2025-05

2025-11

2025-12

2026-03

2026-04

2026-05

2026-06

2026-07

2026-08

2026-09

2026-10

Tensions

Is code a durable artifact humans must keep reading, or an ephemeral byproduct regenerated from a spec?
from: What did the participants of the Thoughtworks 'Future of Software Engineering' Europe retreat (mid-2026) conclude about how agentic AI is reshaping software engineering?
Assessment: The retreat's own 'largest divide' (Ördög). It is unresolved inside the room and inside the individual essays: Herlein concedes the deterministic 'code is the better spec' counter is 'hard to wave off', and Ördög reports being ironically pulled toward the dark-factory camp by her own good-code practices. The crux is whether a fuzzy prose spec can ever be the durable source of truth when the stated quality bar is verifiability — a tension none of them resolves.
Reversibility as a hedge vs a one-way commitment to deeper autonomy.
from: What did the participants of the Thoughtworks 'Future of Software Engineering' Europe retreat (mid-2026) conclude about how agentic AI is reshaping software engineering?
Assessment: Incompatible risk models. Verraes treats deep AI-dependence as the danger to insure against; Herlein treats not-committing as the existential danger. They cannot both be the rational strategy: reversibility trades some upside for exit options, while flywheel-commitment trades exit options for compounding lead. The tie-breaker is empirical (will access/economics deteriorate?) and neither has evidence — Fowler's 'tokenpocalypse' data leans slightly toward Verraes.
If code is no longer the bottleneck, what is the new binding constraint?
from: What did the participants of the Thoughtworks 'Future of Software Engineering' Europe retreat (mid-2026) conclude about how agentic AI is reshaping software engineering?
Assessment: They agree code/delivery has ceased to be the constraint but name three different successors, with different investment implications — expand decision-making capacity (Vella), optimise for learning (Edwards-Alexander), or capture tacit knowledge (Herlein). These are complementary in principle but rivalrous for attention and budget; the disagreement matters because each implies a different 'first thing to fix.'
Is code a durable artifact to be maintained, or an ephemeral byproduct regenerated from a more durable source (spec/objective)?
from: What is the future of software development in the agentic/AI age?
Assessment: The most-cited open question of the corpus, and genuinely unresolved (Herlein: 'no consensus here. None.'). The 'code is the better spec' counter is strong — code is unambiguous, executable, deterministic, whereas a prose spec is reinterpreted each run, which sits in tension with verifiability being the quality bar. Ruby's move is the most defensible: it dissolves the code-vs-spec fight by locating durability in the evaluation rather than any representation. Verraes and Ördög expose the load-bearing empirical unknown — nobody has data on regenerate-vs-patch cost or on long-term evolvability of agent-maintained code.
Strategically, is the right move to accelerate adoption to build a permanent lead, or to decelerate and hedge against AI's risks?
from: What is the future of software development in the agentic/AI age?
Assessment: Nearly opposite bets: Herlein optimizes for a world where AI keeps getting cheaper and better and first-movers win permanently; Verraes and Fowler optimize for a world where AI gets costlier, curtailed, or unreliable. Herlein's 'permanent moat' rests on flywheel logic plus a single secondhand anecdote and ignores technology-diffusion catch-up dynamics; Verraes and Fowler's hedge is cheap insurance but under-examines whether reversion is actually achievable once specs, agents, and toolchains are deeply embedded and human familiarity has eroded. The disagreement is ultimately a bet on the trajectory of token economics, which nobody in the corpus can price.
Is preserving human understanding of the system a first-order value, or is comprehension safely offloadable so long as output is verifiable?
from: What is the future of software development in the agentic/AI age?
Assessment: The optimist-practitioner vs. skeptic-humanist axis. Fowler and Nilsson treat comprehension and craft as intrinsic goods whose loss is a harm even when output is fine; Herlein and Ocytko treat comprehension as instrumental — replaceable by verification and platform guardrails. The humanist camp has the stronger long-run argument (Fowler's cognitive-debt case and Ocytko's own 'who-guards-the-guards' problem both show verification and guardrails are themselves fallible artifacts that someone must understand), but the offloadable camp is describing what is actually happening at scale. The crux is whether verifiability can ever be robust enough to make understanding optional — which Ruby's own Goodhart gap (a passable oracle diverging from true intent) suggests it cannot fully be.
If code was never the bottleneck, what is the binding constraint now?
from: What is the future of software development in the agentic/AI age?
Assessment: A productive three-way split downstream of the shared 'code was never the bottleneck' finding. They are not incompatible so much as differently located — decision capacity (Vella) is organisational, learning (Edwards-Alexander) is about the team's rate of understanding the problem, and knowledge (Herlein) is about capturing rationale. But they imply different investments: expand downstream absorption, restructure around learning, or build knowledge-capture pipelines. The corpus has not reconciled which is the true binding constraint, and each author generalizes from a different vantage (a retreat-floor convergence, an org-design frame, a knowledge-engineering frame).

Open gaps (118)