Archive Index

Browse the publication

Move between essays, the shelf, highlights, and the observatory without losing the editorial thread.

Essays / Organizational Design

The Editable Organization

Once the work of a company can be described as files, queues, tests, dashboards, and review loops, the organization stops being a chart and starts becoming an editable system.

Herman Boma · April 27, 2026 · 12 Min Read

A single sheet of paper on a drafting table casts an impossibly detailed shadow - an entire city skyline emerging from the document

The old organization was drawn as a chart. Boxes, lines, reporting paths, spans of control. The chart said who owned what, who approved what, and where information had to travel before something could happen.

The new organization is written as a set of editable surfaces: markdown files, prompts, dashboards, checklists, queues, schemas, runbooks, evaluation suites, review policies, routing rules, escalation criteria. The chart may still exist, but it is no longer where the organization actually lives. The organization lives in the artifacts that tell people and agents what to do next.

That shift sounds administrative until you notice the consequence: once an organization is expressed as files and feedback loops, it becomes editable in the same way software is editable. You can version it. Diff it. Test it. Fork it. Roll it back. Ask an agent to suggest a patch. Measure whether the patch improved the system or merely made the metrics look better.

This is the working definition:

An editable organization is one whose operating model is explicit enough to be changed deliberately, observed quickly, and improved as a system.

The important word is not automated. It is explicit.

Automation without explicit management documents produces speed without control. The company moves faster, but nobody can say exactly what rules are being executed. Work appears in Slack, Jira, Linear, GitHub, email, and meetings. People route around broken process with private judgment. Agents amplify whatever instructions they can see. The result is not an intelligent organization. It is an implicit organization moving at machine speed.

The editable organization begins by writing down the program it is already running.


The Program Was Always There

Every company already has a program.md. It is just usually scattered.

Part of it lives in onboarding docs. Part of it lives in the way senior people review work. Part of it lives in compensation systems, customer promises, incident rituals, launch checklists, and the private memory of the person everyone asks when the system behaves strangely.

These fragments are not decorative. They are executable. They determine which work gets prioritized, what quality means, when a decision is safe enough to make, who gets interrupted, what counts as an emergency, and how long an unresolved question is allowed to sit.

In a human-only organization, implicit process survives because people can fill in the gaps. A vague request becomes a conversation. A missing acceptance criterion becomes a meeting. A broken escalation path becomes a direct message to the person who knows the real rule.

Agents are less forgiving. They execute the visible instruction, not the cultural footnote. If the real rule is “ship fast, but never compromise trust,” the organization has to specify what trust means. If the real rule is “support can fix small bugs directly,” the organization has to specify the boundary between a small bug and a product decision. If the real rule is “this metric matters unless customers start complaining,” the organization has to specify what signal overrides the metric.

The editable organization is not created by adding agents. Agents reveal whether the organization was legible enough to run in the first place.


The Management Layer Becomes Source

In traditional software organizations, code was the scarce artifact. Specifications were often treated as temporary scaffolding: a PRD, a ticket, a design brief, a conversation in a planning meeting. The real thing was the implementation.

That hierarchy is inverting. When execution gets cheap, the specification becomes the scarce artifact. The code, deck, analysis, campaign, or support response is increasingly the build output. The durable object is the management layer: the instructions that determine what should be produced, how it should be evaluated, and what must not be broken along the way.

The same pattern appears in small autonomous research loops. There is an evaluation script that defines success. There is an execution layer that changes quickly. And there is a management document that tells the system what to try, what to ignore, how to log results, and when to keep going.

Scale that pattern up and the organization begins to look like this:

  1. Constraints define the boundaries: policy, brand, security, architecture, budget, legal exposure.
  2. Specifications define the work: the customer problem, success criteria, guardrails, and review expectations.
  3. Agents and people execute the work: code, analysis, outreach, operations, remediation.
  4. Evaluations decide whether the output is good enough: tests, customer signals, financial metrics, review rubrics, incident rates.
  5. Changes to the management layer decide whether the process itself should improve.

The fifth step is the important one. A normal organization asks, “Did the work succeed?” An editable organization also asks, “What should we change about the instructions that produced this work?”

The unit of improvement moves up a level. You are no longer merely improving an artifact. You are improving the system that produces artifacts.


What Becomes Editable

The first editable surface is the work spec. This is the obvious one: clearer tickets, better prompts, stronger acceptance criteria, sharper definitions of done.

But the deeper opportunity is not better tickets. It is editable operating design.

An editable sales loop can test whether the team should optimize for response time, depth of qualification, or long-term retention. An editable support loop can test which issues agents may resolve automatically and which must be escalated. An editable product loop can test whether a loop owner should ship a prototype directly or route through design review first. An editable research loop can test whether exploration should be broad and shallow or narrow and deep.

Each of these changes used to look like management philosophy. Now each can become a patch.

Not every patch should ship. That is why editable organizations need the same disciplines software needed when it became easy to change:

Editable surfaceGood patchBad patch
Success metricsAdds a guardrail metric to protect customer trustOptimizes one number while hiding damage elsewhere
Agent permissionsExpands autonomy inside a tested boundaryGrants broad authority because a demo worked once
Review policyMoves review closer to the riskAdds approval theater with no real judgment
Routing rulesSends work to the loop owner with the most contextCreates a maze because nobody wants accountability
Team structureRemoves a handoff that only preserved habitDeletes expertise before it has been encoded

This is why the editable organization is not the same as a flat organization, an automated organization, or an agent-first organization. It can contain hierarchy. It can contain humans doing slow judgment work. It can contain hard approval gates. The distinction is that those choices are explicit, inspectable, and revisable.


The Transposed Shape

Glass columns filled with colored liquids caught mid-rotation from vertical to horizontal - specialties becoming loops, expertise mixing at the pivot points

The most natural shape for an editable organization is not a stack of functions. It is a set of loops.

A functional organization reads vertically. Engineering owns implementation. Design owns interface quality. Support owns customer issues. Sales owns revenue. Every meaningful customer problem crosses multiple columns, and every crossing creates delay, context loss, and coordination overhead.

An agent-augmented organization can often read horizontally. One loop owner carries the problem from signal to shipped response, using agents and platform constraints to cover the execution domains they do not personally specialize in.

This does not eliminate specialists. It changes their job.

The specialist becomes a platform builder. The security expert encodes threat models, review gates, and safe defaults. The designer encodes component systems and taste criteria. The data engineer encodes schema rules and observability checks. The lawyer encodes policy boundaries. Their work becomes infrastructure that loop owners and agents can safely execute against.

In the old model, specialists did the work for each request. In the editable model, specialists make expertise reusable by turning it into constraints.

That is a hard transition because it changes status. The expert is no longer valuable only because they are the person who must touch every artifact. They are valuable because the organization keeps making better artifacts even when they are not personally in the loop.


Where Editing Fails

The editable organization has failure modes, and they are not subtle.

The first is metric capture. If the management layer says “close tickets within twenty-four hours,” the system will learn to close tickets. It may split complex issues into smaller tickets, resolve ambiguous requests prematurely, or train customers to stop reporting problems. The metric improves while the organization gets worse.

The defense is layered evaluation. A good management document does not specify only what to optimize. It specifies what to protect. Speed matters, but not if reopen rates rise. Revenue matters, but not if retention falls. Autonomy matters, but not if review quality collapses. The editable organization needs guardrails that are as explicit as goals.

The second failure is taste collapse. Some work can be verified by tests. Some work can be evaluated by numbers. Some work requires judgment that is still difficult to formalize: strategy, brand, hiring, narrative, architecture, product feel. If an organization treats every domain as equally editable, it will automate the parts of judgment it can describe and silently discard the parts it cannot.

The defense is honest classification. Work should be sorted by verifiability and taste-dependence before autonomy is granted. High-verifiability, low-taste work can run with little human review. High-taste work can use agents for drafting, exploration, and synthesis, but the final evaluation must stay with people who have earned the judgment.

The third failure is invisible authority. A document that routes work, grants permissions, or changes incentives is not neutral. It governs. If anyone can patch the management layer without ownership, the organization becomes easy to manipulate. If nobody can patch it, the organization becomes brittle.

The defense is governance for the source code of the company: ownership, review, audit trails, rollback, incident response, and a clear answer to the question “who is allowed to change the rules that change the work?”


The Practical Version

Most teams do not need a grand reorg. They need one editable loop.

Pick a recurring workflow where the output matters, the current process is visible enough to inspect, and the success criteria are not purely vibes. Support triage. Release readiness. Customer onboarding. Incident follow-up. Sales research. Data quality review. Feature intake.

Then write the operating file:

  1. Purpose: what this loop exists to achieve.
  2. Inputs: what signals enter the loop and where they come from.
  3. Actions: what people and agents are allowed to do.
  4. Constraints: what must never be violated.
  5. Evaluation: how output quality is measured.
  6. Escalation: when the loop must stop and ask for human judgment.
  7. Change policy: how the loop itself can be edited.

Run the loop for a week. Do not ask only whether the outputs improved. Ask where the instructions were wrong. Where did the agent need information that lived only in someone’s head? Where did the metric reward the wrong behavior? Where did review catch problems too late? Where did a human make the same judgment three times, suggesting the rule should be written down?

Then patch the operating file and run again.

That is the editable organization in miniature. Not a manifesto. A working loop whose source can be read.


Read Your Own Source

The reason this matters is not that agents are about to make companies infinitely productive. That framing is too shallow. The deeper shift is that agents make organizational instructions executable. Once instructions are executable, the quality of the instruction becomes inseparable from the quality of the organization.

This is uncomfortable because it removes a convenient ambiguity. Many organizations survive by keeping their real rules implicit. They say one thing, reward another, and rely on people to reconcile the contradiction. Agents do not solve that contradiction. They surface it.

The editable organization is the one willing to look.

It does not pretend every human judgment can be compiled into a prompt. It does not confuse measurement with meaning. It does not remove people from the management layer and call that progress. It makes the management layer visible enough that people can argue about the actual source of behavior instead of the symptoms.

The question is not whether your organization is becoming software. It already did, slowly, through dashboards, workflows, policies, queues, and documents. The question is whether the software is readable.

If it is readable, it can be edited.

If it can be edited, it can be improved.

And if it can be improved, the most important product your company ships may be the company itself.

Continue the thread