<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>The Gauge — The Clear Pipe</title>
    <link>https://theclearpipe.com/blog/</link>
    <atom:link href="https://theclearpipe.com/feed.xml" rel="self" type="application/rss+xml"/>
    <description>Dispatches from inside the pipe — notes on building connected, visible companies.</description>
    <language>en</language>
    <lastBuildDate>Wed, 19 Aug 2026 13:00:00 GMT</lastBuildDate>
    <item>
      <title>The meeting that should be a gauge</title>
      <link>https://theclearpipe.com/blog/the-meeting-that-should-be-a-gauge/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/the-meeting-that-should-be-a-gauge/</guid>
      <pubDate>Wed, 19 Aug 2026 13:00:00 GMT</pubDate>
      <description>Most recurring meetings exist to move information that a number could move better. A test for which ones to delete and what has to exist first.</description>
      <content:encoded><![CDATA[<p>Most recurring meetings are instruments. Badly built, expensively operated instruments, but instruments — their actual function is to move information from the people who have it to the people who need it, on a schedule.</p>
<p>Which means they&#39;re competing with a gauge, and they usually lose.</p>
<h2 id="the-test">The test</h2>
<p>For each recurring meeting, ask: <strong>what information moves here that couldn&#39;t move as a number?</strong></p>
<p>Sort what happens into three buckets.</p>
<p><strong>Status transfer</strong> — &quot;here&#39;s where things stand.&quot; This is a gauge wearing a costume. It&#39;s slower than a number, less accurate (it&#39;s assembled from memory under mild social pressure), it requires everyone&#39;s simultaneous attention, and it produces no record anyone will read afterward. Delete it and publish the number.</p>
<p><strong>Decisions</strong> — several people with different information converging on a choice. This genuinely needs a meeting, or at least a synchronous exchange. Keep it. But notice that a decision meeting takes twenty minutes when the status is already known, and ninety when it isn&#39;t — which is why deleting the status transfer makes the decisions better rather than just cheaper.</p>
<p><strong>Alignment and relationship</strong> — building shared context, disagreeing productively, the human stuff. Real and irreplaceable. Also, in most companies, about 10% of the calendar time allocated to meetings that claim it as their purpose.</p>
<p>Run this on a real calendar and the typical result is that half to two-thirds of recurring meeting time is status transfer.</p>
<h2 id="what-has-to-exist-first">What has to exist first</h2>
<p>Here&#39;s the part people skip, and skipping it is why &quot;we cancelled our status meetings&quot; so often gets quietly reversed a month later.</p>
<p>You cannot delete a status meeting until the gauge exists. Otherwise you haven&#39;t removed an instrument, you&#39;ve gone dark — and the meeting will come back, correctly, because a bad instrument beats no instrument.</p>
<p>The replacement needs three properties:</p>
<ol><li><strong>Automatic.</strong> Nobody assembles it. If a person compiles the update, you&#39;ve kept the meeting and removed the part where people could ask questions.</li><li><strong>Pushed.</strong> It arrives, in a channel people already read. A dashboard someone must remember to visit will be visited for two weeks and then never.</li><li><strong>Owned.</strong> Each number has a name attached. The meeting provided accountability through the discomfort of reporting bad news to a room; the gauge has to provide it some other way, and a name is the cheapest way.</li></ol>
<p>Get those three right and the status meeting can go. Miss any one and it&#39;ll be back by the end of the quarter.</p>
<h2 id="what-improves">What improves</h2>
<p><strong>The information gets better.</strong> A number computed automatically doesn&#39;t round off the inconvenient parts. A status update delivered verbally by the person responsible is, inevitably and without any dishonesty, the most reasonable available version of events.</p>
<p><strong>It arrives sooner.</strong> A weekly meeting means bad news waits up to seven days for its slot. A gauge moves when the thing moves. Most operational problems are cheap to fix on day one and expensive on day six.</p>
<p><strong>Everyone gets it at once.</strong> In a meeting, the room learns. Everyone else learns through retelling, degraded and delayed. A published gauge reaches the whole company simultaneously, including the people who&#39;d never have been invited but are affected anyway.</p>
<p><strong>The meetings you keep get better.</strong> A decision meeting where everyone already knows the numbers starts at the actual question. That&#39;s the biggest win and it&#39;s the one nobody predicts — deleting meetings improves the remaining ones more than it saves time.</p>
<h2 id="the-residual">The residual</h2>
<p>One caveat, and it&#39;s real. Meetings do something gauges don&#39;t: they create a moment where someone can say <em>&quot;that number is up but I&#39;m worried anyway.&quot;</em></p>
<p>Intuition arriving ahead of the data is genuinely valuable, and a pure-gauge culture can lose it — because there&#39;s no forum for a concern that isn&#39;t yet a number, and unspoken concerns don&#39;t route themselves.</p>
<p>So keep a short, low-frequency forum whose only agenda is &quot;what are you worried about that the gauges don&#39;t show?&quot; Fifteen minutes. No status. It&#39;s the highest-value meeting most companies don&#39;t have, and it&#39;s affordable precisely because you deleted the other ones.</p>]]></content:encoded>
      <category>playbook</category>
      <category>operations</category>
      <category>meetings</category>
    </item>
    <item>
      <title>What we publish, and why</title>
      <link>https://theclearpipe.com/blog/what-we-publish-and-why/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/what-we-publish-and-why/</guid>
      <pubDate>Tue, 18 Aug 2026 13:00:00 GMT</pubDate>
      <description>A specific list of what goes public across the portfolio, what stays private, and the rule that decides which is which.</description>
      <content:encoded><![CDATA[<p>&quot;Build in the open&quot; is easy to say and mostly said vaguely. Here&#39;s the specific version — what actually goes public across the portfolio, what doesn&#39;t, and the rule that draws the line.</p>
<h2 id="the-rule">The rule</h2>
<p><strong>If it describes the customer&#39;s experience of us, it&#39;s public. If it describes our internal strategy or someone&#39;s private data, it isn&#39;t.</strong></p>
<p>That&#39;s the whole test. It&#39;s simple enough to apply in a hallway, which is the requirement for a rule that has to survive contact with a bad week.</p>
<h2 id="whats-public">What&#39;s public</h2>
<p><strong>Operational latency.</strong> How long our processes take, at median and P90. Response times, resolution times, onboarding duration. A customer is experiencing these numbers whether or not we publish them; publishing only changes whether they have to guess.</p>
<p><strong>Incident history.</strong> What broke, when, for how long, what we did, what we changed. Written within a week, permanent, not quietly retired after a quarter. An incident history that only contains recent incidents is a marketing page.</p>
<p><strong>Agent reasoning.</strong> Every automated decision that affects a user is inspectable by that user, with the inputs consulted and the path taken. Largo&#39;s traces, Richie&#39;s citations, OnChainMind&#39;s on-chain record. This is the one we&#39;ve spent the most engineering on and the one I&#39;d give up last.</p>
<p><strong>Override and acceptance rates.</strong> How often humans disagree with our systems. This is unusual to publish and I understand why — it looks like advertising your error rate. It reads that way for about a week. After that it reads as <em>these people know how their system performs</em>, which is a claim most vendors cannot make.</p>
<p><strong>Pricing, in full.</strong> Every tier, every limit, every overage. &quot;Contact us for pricing&quot; is a statement that the price depends on what we think you&#39;ll pay.</p>
<p><strong>Roadmap direction.</strong> Not dates — direction. What we&#39;re working toward and what we&#39;ve decided not to do.</p>
<h2 id="whats-private">What&#39;s private</h2>
<p><strong>Customer data.</strong> Obviously, and absolutely. Transparency about our operations never extends to transparency about the people using them. These get confused surprisingly often, usually by someone arguing that if we&#39;re so committed to openness we should publish some aggregate that turns out to be re-identifiable.</p>
<p><strong>Individual performance.</strong> Team-level gauges are public internally. Individual evaluations aren&#39;t. A person&#39;s performance review is not an operational metric and treating it as one produces a culture where nobody takes a risk.</p>
<p><strong>Unannounced strategy.</strong> What we&#39;re considering, who we&#39;re talking to, what we might acquire or shut down. Real competitive information with real consequences for people&#39;s jobs.</p>
<p><strong>Model parameters and prompts.</strong> The reasoning is public. The exact configuration that produces it isn&#39;t. This is the closest call on the list and we revisit it — the argument for publishing is that it would let others verify our claims; the argument against is that it&#39;s the one piece of genuine edge in an otherwise open system. Currently the second one wins, and I&#39;m not fully comfortable with it.</p>
<h2 id="what-we-got-wrong">What we got wrong</h2>
<p>Two things worth naming, since a post about transparency that only lists successes is exactly the failure it&#39;s describing.</p>
<p><strong>We published a status page before we could keep it accurate.</strong> For about six weeks it showed green during two degradations. Worse than no status page, because it converted &quot;we don&#39;t know&quot; into &quot;they told us it was fine.&quot; A transparency artifact you can&#39;t maintain is a liability, not a virtue. Now the page is driven by the same gauges the on-call rotation uses, so it can&#39;t diverge from reality without someone noticing.</p>
<p><strong>We over-published early metrics.</strong> In the first months of one company, we posted numbers that were real but so small and volatile that they were noise. It felt honest. It actually misled — readers extracted trends from what was essentially random variation, including us. Now we publish a number only once it has enough volume to mean something, and we say explicitly when we&#39;re withholding for that reason.</p>
<h2 id="why-bother">Why bother</h2>
<p>Three reasons, in ascending order of how much I believe them.</p>
<p><strong>It&#39;s a differentiator.</strong> True, and the weakest reason. Differentiators erode.</p>
<p><strong>It forces us to fix things.</strong> A number you&#39;ve published is a number you can&#39;t quietly let slide. This is real and it works, and it&#39;s slightly embarrassing that external pressure does what internal discipline should.</p>
<p><strong>It&#39;s the only way to be believed.</strong> Every company claims their AI is trustworthy. The claim is now worthless — it costs nothing and everyone makes it. What&#39;s left is showing the work: the trace, the citation, the ledger, the published rate at which we&#39;re wrong.</p>
<p>You can&#39;t assert your way into trust anymore. Glass reveals, or it doesn&#39;t.</p>]]></content:encoded>
      <category>thesis</category>
      <category>transparency</category>
      <category>portfolio</category>
    </item>
    <item>
      <title>PLAY.PAUSE.PLAI. and the speed of a prompt</title>
      <link>https://theclearpipe.com/blog/play-pause-plai-and-the-speed-of-a-prompt/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/play-pause-plai-and-the-speed-of-a-prompt/</guid>
      <pubDate>Mon, 17 Aug 2026 13:00:00 GMT</pubDate>
      <description>When production cost falls to nearly zero, the constraint moves. What a music label looks like when making the thing is the easy part.</description>
      <content:encoded><![CDATA[<p>PLAY.PAUSE.PLAI. is an AI music label. It produces and publishes original catalogs at, roughly, the speed of a prompt.</p>
<p>The reaction that sentence gets is usually about whether the music is any good, which is a fair question and not the one I find most interesting. The interesting question is structural: <strong>what happens to a business when the expensive part becomes free?</strong></p>
<p>Because that&#39;s the actual event here. Recorded music used to require studios, session players, engineers, and weeks. Now the production segment of the pipe costs approximately nothing and takes approximately no time.</p>
<p>The naive expectation is that you get more music. You do. That&#39;s not the important part.</p>
<h2 id="the-constraint-moves">The constraint moves</h2>
<p>When production was expensive, it was the constraint, and the entire industry organized around it. A&amp;R existed to decide what was worth the production spend. Contracts existed to finance it and recoup it. Release schedules existed because studio time was a resource to allocate.</p>
<p>Take away the cost and every one of those structures loses its reason for existing. What&#39;s left is the thing production expense was previously masking: <strong>nobody can find anything.</strong></p>
<p>Discovery was never the constraint before because supply was limited by cost. Now supply is effectively unlimited, and the binding constraint is attention — which is not a thing you can prompt your way through.</p>
<p>This is the general pattern, and it&#39;s why this post is on a business blog and not a music one. When AI removes a cost, it doesn&#39;t make the business easier. It moves the constraint to the next segment downstream, which is usually a segment nobody has been optimizing, because it was never the bottleneck.</p>
<p><strong>Find the new constraint before your competitors do, and you have a business. Celebrate the removed cost and ship more volume into a constraint you haven&#39;t identified, and you have a very efficient way to be ignored.</strong></p>
<h2 id="what-we-instrument">What we instrument</h2>
<p>Given that, the label&#39;s gauges aren&#39;t about production. Production throughput is meaningless — we could make it arbitrarily large by asking, and the number would tell us nothing.</p>
<p>What we watch:</p>
<p><strong>Time from concept to published.</strong> Still worth measuring, but not as a speed metric. It&#39;s a <em>seam</em> metric: production is instant, so any elapsed time in this number is entirely handoffs and approvals. It&#39;s the purest measurement of pipe friction I&#39;ve ever had access to, because the work itself contributes nothing.</p>
<p><strong>Catalog utilization.</strong> What fraction of released tracks are getting any plays at all? This is the discovery constraint made visible. When volume goes up and utilization goes down, we&#39;re producing into a void — efficiently.</p>
<p><strong>Cost per placement.</strong> Not cost per track, which trends to zero and is uninformative. The cost of getting a track to an actual listener, which is where all the money and effort now live.</p>
<p><strong>Human intervention rate.</strong> How often a person changes the output before release. Same joint as everywhere else in the portfolio: the seam between machine proposal and human acceptance. Falling toward zero would worry me, for the same reason it worries me in Largo and Richie — it usually means nobody&#39;s reviewing, not that everything&#39;s perfect.</p>
<h2 id="the-uncomfortable-part">The uncomfortable part</h2>
<p>I&#39;ll say the obvious thing directly: a lot of what an AI label can produce is competent and forgettable. Cheap production doesn&#39;t create taste, and volume is not a substitute for it.</p>
<p>The mistake would be treating that as a model problem to be solved with better generation. It isn&#39;t. It&#39;s a <strong>selection</strong> problem, and selection is the segment that got more valuable when production got cheaper — the classic result whenever a cost collapses. The scarce input in a world of infinite supply is judgment about what deserves to exist.</p>
<p>So the label&#39;s real product isn&#39;t the generation pipeline. Anyone can have one of those by the end of the week. It&#39;s the selection layer: what gets released, under what identity, to whom — and the honest instrumentation of whether those choices are working, which is what stops taste from decaying into vibes.</p>
<p>Same two laws as everything else here. Build the label as connected segments, so the pipeline is assembly rather than reinvention. Put glass on the joint where taste enters, because that joint is now the entire business.</p>]]></content:encoded>
      <category>portfolio</category>
      <category>play pause plai</category>
      <category>ai</category>
      <category>creative</category>
    </item>
    <item>
      <title>Your onboarding is a pressure test</title>
      <link>https://theclearpipe.com/blog/your-onboarding-is-a-pressure-test/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/your-onboarding-is-a-pressure-test/</guid>
      <pubDate>Sun, 16 Aug 2026 13:00:00 GMT</pubDate>
      <description>The path from signup to first real value crosses more internal seams than any other process you run. Which makes it the best diagnostic instrument you own.</description>
      <content:encoded><![CDATA[<p>If I get one process to examine in a company, I ask for onboarding.</p>
<p>Not because it&#39;s the most important — retention usually matters more, and product quality more than that. Because onboarding is the process that <strong>crosses the most seams</strong>. A new customer touches sales, provisioning, data migration, billing, support, and product in their first two weeks. Every one of those transitions is a joint, and every joint is a place your pipe either flows or doesn&#39;t.</p>
<p>Onboarding isn&#39;t just a process. It&#39;s a pressure test that your customers run on your entire operation, for free, continuously.</p>
<h2 id="what-the-readings-tell-you">What the readings tell you</h2>
<p><strong>Time from payment to first real use.</strong> Not first login — first time the customer did the thing they bought the product to do. This number is the closest thing to a single-figure summary of your operational health, because it can only be short if every segment and every seam works.</p>
<p>Every day in that number is sitting in a specific place. Find it. It&#39;s almost never where the team assumes; when we measured it at one portfolio company, 60% of the elapsed time was a single seam where provisioning waited on a data file nobody had asked the customer for yet.</p>
<p><strong>Number of times the customer has to repeat themselves.</strong> Count how many times a new customer supplies information they already gave you. Each repetition is a seam where the upstream Out didn&#39;t match the downstream In — a fitting that doesn&#39;t fit, exposed by the one person in the process who can see across all your internal boundaries.</p>
<p>Customers experience this as sloppiness. Diagnostically it&#39;s precise: each repetition names a specific broken handoff.</p>
<p><strong>Where they go quiet.</strong> Instrument the drop-offs. The step where new customers stop responding is the step that&#39;s too hard, too unclear, or too far from the value they were promised. Silence is data, and it&#39;s the data most companies discard as &quot;they weren&#39;t a good fit.&quot;</p>
<p><strong>How many humans they meet.</strong> Not inherently bad — high-touch is a real strategy. But if a customer meets six people and each one re-establishes context, you don&#39;t have high-touch service, you have an uncoordinated pipe with a friendly interface on top.</p>
<h2 id="why-this-beats-an-internal-audit">Why this beats an internal audit</h2>
<p>You could map these seams internally. You should. But an internal review has a blind spot: everyone evaluates the process from inside their own segment, where it looks fine, because from inside a segment it always does.</p>
<p>A new customer has no such loyalty and no such context. They experience the whole pipe as one thing, and they notice every joint — because a joint that leaks is precisely what &quot;this feels disorganized&quot; means from the outside.</p>
<p>That&#39;s an outside-in view of your operations that you cannot generate any other way. Most companies collect it and then aggregate it into a satisfaction score, which throws away all the diagnostic information and keeps the part that makes people feel bad.</p>
<h2 id="the-instrumentation">The instrumentation</h2>
<p>Three gauges, and they&#39;re cheap:</p>
<ol><li><strong>Median and P90 days from payment to first real use</strong>, with the elapsed time broken down by step so you can see where it sits.</li><li><strong>Repeat-information count</strong> — how many times the customer supplied something you already had.</li><li><strong>Step-level drop-off</strong> — where do new customers go silent.</li></ol>
<p>Publish them weekly. Give each one an owner. And review the P90 case specifically, by name, every week — not the aggregate. The customer who took thirty-one days had a specific experience with a specific cause, and that cause is present at some rate in every onboarding you run.</p>
<h2 id="the-thing-to-resist">The thing to resist</h2>
<p>The reflex when onboarding is slow is to assign someone to shepherd customers through it. A dedicated onboarding manager. A concierge.</p>
<p>That works, immediately and visibly, which is why it&#39;s so tempting. It also <strong>hides the problem permanently.</strong> You&#39;ve hired a person whose full-time job is compensating for seams that don&#39;t fit, and once that person exists, the seams will never be fixed — because from the outside everything now looks fine, and the cost has been converted into a salary line that grows with your customer count.</p>
<p>Fix the fittings first. Then, if high-touch is genuinely your strategy, add the human — and let them do work that adds value instead of work that patches leaks.</p>]]></content:encoded>
      <category>playbook</category>
      <category>customers</category>
      <category>operations</category>
    </item>
    <item>
      <title>When to add a valve</title>
      <link>https://theclearpipe.com/blog/when-to-add-a-valve/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/when-to-add-a-valve/</guid>
      <pubDate>Sat, 15 Aug 2026 13:00:00 GMT</pubDate>
      <description>Approval steps are the most over-used control in business. Three tests for whether a gate is protecting you or just adding delay and diffusing responsibility.</description>
      <content:encoded><![CDATA[<p>Something goes wrong, and the reflex is to add an approval step. A second pair of eyes. A sign-off. A gate.</p>
<p>Gates are valves — they stop flow until a condition is met — and valves are legitimate infrastructure. But they&#39;re the most over-installed component in business, because adding one feels like taking action and the cost is paid by someone else, later, in small increments that never get attributed back to the decision.</p>
<p>Three tests before you install one.</p>
<h2 id="test-1-does-the-approver-have-information-the-doer-lacks">Test 1: Does the approver have information the doer lacks?</h2>
<p>The only good reason for a gate is an <strong>information asymmetry</strong>. The approver knows something the person doing the work cannot know: broader context, a legal constraint, a commitment made elsewhere.</p>
<p>If the approver is looking at the same information and applying the same judgment, the gate adds nothing but delay. Worse, it degrades: a reviewer who never finds problems stops looking carefully, and within two months you have a rubber stamp that everyone treats as a control. That&#39;s worse than no gate, because now the doer relies on review that isn&#39;t happening.</p>
<p>The honest check: <strong>what&#39;s your rejection rate?</strong> If a gate rejects nothing over fifty passes, it isn&#39;t a control. Either remove it or find out what it was supposed to be catching.</p>
<h2 id="test-2-is-the-failure-it-prevents-worse-than-the-delay-it-causes">Test 2: Is the failure it prevents worse than the delay it causes?</h2>
<p>Every gate has a price: units of work times the delay per unit.</p>
<p>A gate that adds four hours to a process running two hundred times a month costs eight hundred hours of elapsed time a year. Against that, what does it prevent? How often, and how bad?</p>
<p>Sometimes the math is obvious in favor — irreversible actions, regulatory exposure, anything that ends with a customer&#39;s money in the wrong place. Often it isn&#39;t, and nobody has done the arithmetic because the delay is diffuse and the prevented failure is vivid. Vividness beats arithmetic in most meetings, which is precisely why you should write the arithmetic down.</p>
<h2 id="test-3-could-a-gauge-do-this-job-instead">Test 3: Could a gauge do this job instead?</h2>
<p>The best alternative to a gate is usually detection.</p>
<p>A gate stops every unit to prevent a rare failure. A gauge lets everything through and tells you immediately when something looks wrong. If the action is <strong>reversible</strong>, the gauge is almost always the better trade: you pay a small cost on the rare bad case instead of a small cost on every case.</p>
<p>The decision rule I use:</p>
<ul><li><strong>Irreversible and high-impact</strong> → valve. Stop it before it happens.</li><li><strong>Reversible</strong> → gauge. Let it flow, watch closely, fix fast.</li><li><strong>Irreversible and low-impact</strong> → gauge, plus a written policy. Not everything irreversible deserves a queue.</li></ul>
<p>Most gates I encounter are protecting against reversible failures. They were added after a bad week, they&#39;ve never been revisited, and they&#39;ve become part of how the company describes itself.</p>
<h2 id="the-hidden-cost-nobody-counts">The hidden cost nobody counts</h2>
<p>Beyond delay, gates do something worse: <strong>they move responsibility off the person doing the work.</strong></p>
<p>When your judgment gets reviewed, you stop exercising judgment. You produce something that will pass review, which is a different and smaller objective. Over time the doer becomes an executor and the approver becomes a bottleneck, and the organization loses the thing it most needed — people who own their outcomes.</p>
<p>This is why gates proliferate so easily. Each one is locally reasonable and the aggregate is a company where nobody decides anything alone and everything takes six days.</p>
<h2 id="valves-you-should-keep">Valves you should keep</h2>
<p>Not an argument against all gates. Keep the ones where:</p>
<ul><li>The action is genuinely irreversible (money out, data deleted, a public commitment made).</li><li>The approver holds real context the doer can&#39;t have.</li><li>The rejection rate is meaningfully above zero — proof it&#39;s doing work.</li><li>The gate has an SLA, so it&#39;s a valve and not a black hole.</li></ul>
<p>That last one is non-negotiable and almost always missing. <strong>A gate without a response-time commitment isn&#39;t a control, it&#39;s a queue of unknown depth.</strong> If you can&#39;t say how long approval takes at P90, you don&#39;t have an approval step — you have a place where work goes to wait for someone&#39;s attention.</p>
<p>Put a gauge on your valves. Otherwise the thing you installed to make the pipe safer is the thing that&#39;s clogging it, and you won&#39;t be able to prove it either way.</p>]]></content:encoded>
      <category>playbook</category>
      <category>operations</category>
      <category>decisions</category>
    </item>
    <item>
      <title>Build the boring pipe first</title>
      <link>https://theclearpipe.com/blog/build-the-boring-pipe-first/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/build-the-boring-pipe-first/</guid>
      <pubDate>Fri, 14 Aug 2026 13:00:00 GMT</pubDate>
      <description>The interesting part of a product is rarely the part that determines whether it works. A case for spending your first month on the plumbing nobody demos.</description>
      <content:encoded><![CDATA[<p>Every product has an interesting part — the model, the algorithm, the insight, the thing you&#39;d put on a slide. And every product has a boring part: getting data in, moving it between steps, handling the cases that don&#39;t fit, getting results back out to a human, recording what happened.</p>
<p>Teams start with the interesting part. It&#39;s why they took the job, it demos well, and it&#39;s the part that feels like the actual product.</p>
<p>I&#39;ve come to think that&#39;s backwards, and I&#39;ve paid for the lesson enough times to say it plainly: <strong>build the boring pipe first, with a placeholder where the interesting part goes.</strong></p>
<h2 id="what-boring-pipe-first-means-concretely">What &quot;boring pipe first&quot; means concretely</h2>
<p>Week one, the system does something end to end. Real input arrives through the real intake path. It moves through every segment. A result comes out and reaches a human in whatever form they&#39;ll actually receive it. Every step logs what it did.</p>
<p>The interesting segment is a stub. A rule of thumb, a lookup table, a hardcoded response, a human doing it by hand behind an API. Whatever&#39;s fastest.</p>
<p>You now have a complete pipe with one segment that&#39;s obviously bad — and that is a dramatically better position than a brilliant segment with no pipe around it.</p>
<h2 id="why-it-wins">Why it wins</h2>
<p><strong>You find out what the interesting part actually needs to do.</strong> Requirements written before anything runs end to end are guesses. Once real inputs flow through, half the assumptions collapse — the data is dirtier, the cases are weirder, and the output has to fit a workflow nobody described. Every hour spent perfecting a model against imagined requirements is an hour at risk.</p>
<p><strong>The stub is often good enough for longer than you&#39;d think.</strong> I&#39;ve shipped stubs that stayed in production for months because the rest of the pipe delivered most of the value. That&#39;s not a failure of ambition, it&#39;s the correct allocation of effort — and you only discover it by running a complete system and watching where the value actually comes from.</p>
<p><strong>You get gauges before you get results.</strong> A complete pipe can be instrumented at every joint on day one. So when the real segment goes in, you have a baseline to compare against. Teams that build the interesting part first ship it into a dark pipe and then argue about whether it helped.</p>
<p><strong>Integration surprises arrive while they&#39;re cheap.</strong> The auth quirk, the rate limit, the format nobody documented, the compliance step nobody mentioned. These always exist, they always take longer than expected, and finding them in week one is very different from finding them in week ten with a launch date.</p>
<h2 id="why-teams-resist">Why teams resist</h2>
<p>Because the boring pipe is unrewarding to build and impossible to demo. &quot;We wired up the whole flow and the core logic is a lookup table&quot; is a terrible standup update. &quot;We got the model to 91%&quot; is a great one, even when it&#39;s a model that will never see real data in the shape it was trained on.</p>
<p>There&#39;s also a status dimension. The interesting part is the part that requires expertise. Plumbing feels like work anyone could do — which is exactly wrong, since designing the fittings between segments is the highest-leverage design work in the system, and it&#39;s the work that determines whether the interesting part can ever be replaced.</p>
<h2 id="the-version-ive-settled-on">The version I&#39;ve settled on</h2>
<p>Two weeks, three rules:</p>
<ol><li><strong>Every segment exists</strong>, however stupidly. No gaps, no &quot;we&#39;ll add the intake later.&quot;</li><li><strong>Every joint is instrumented.</strong> Throughput, latency, quality. Even if the numbers are meaningless at first — especially then, because you&#39;re establishing the plumbing that will carry the meaningful numbers.</li><li><strong>One real user runs one real unit of work through it.</strong> Not a test fixture. A person, with a thing they actually needed, receiving a result they actually use.</li></ol>
<p>If you can do those three in two weeks, you have a business you can improve segment by segment, forever, with a gauge telling you whether each improvement helped.</p>
<p>If you can&#39;t, you&#39;ve learned something important about where the hard part really is — and it&#39;s almost never where you thought.</p>]]></content:encoded>
      <category>playbook</category>
      <category>product</category>
      <category>infrastructure</category>
    </item>
    <item>
      <title>Latency is a trust metric</title>
      <link>https://theclearpipe.com/blog/latency-is-a-trust-metric/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/latency-is-a-trust-metric/</guid>
      <pubDate>Thu, 13 Aug 2026 13:00:00 GMT</pubDate>
      <description>How long something takes is usually filed under performance. It is really a statement about how much of your process a customer has to hold in their head.</description>
      <content:encoded><![CDATA[<p>Speed gets discussed as an efficiency concern. Faster is cheaper, faster is more throughput, faster means we need fewer people.</p>
<p>All true, and all beside the point. The reason latency matters is psychological, and once you see it that way you measure it differently.</p>
<h2 id="what-waiting-actually-costs-the-customer">What waiting actually costs the customer</h2>
<p>When a customer is waiting on you, they&#39;re carrying the request. They have to remember it exists. They have to decide whether it&#39;s time to follow up. They have to guess whether silence means progress or means they&#39;ve been forgotten.</p>
<p>That cognitive load is the real cost of latency, and it scales nonlinearly. A two-hour wait costs almost nothing — they&#39;ve forgotten they asked. A two-day wait costs a follow-up email and a small deposit of doubt. A two-week wait costs the relationship, not because two weeks is objectively unbearable but because by then they&#39;ve constructed an explanation for the silence, and the explanation is never generous.</p>
<p>Which means the same latency has wildly different costs depending on one variable: <strong>whether they know what&#39;s happening.</strong></p>
<h2 id="the-equation">The equation</h2>
<p>A customer&#39;s tolerance for waiting is roughly:</p>
<blockquote><p>tolerance = expectation ÷ uncertainty</p></blockquote>
<p>Give someone a credible expectation — <em>this takes about four days, and you&#39;ll hear from us Thursday</em> — and four days is fine. Leave them uncertain and four days is an eternity, because they&#39;re paying attention the entire time.</p>
<p>This is why the status page beats the speed improvement more often than engineers expect. Cutting a process from six days to four is real work and delivers a 33% improvement in a number. Telling the customer it&#39;s a six-day process, and showing them where in the six days they are, often delivers more satisfaction for a tenth of the effort.</p>
<p>Both are worth doing. Only one of them is usually on the roadmap.</p>
<h2 id="how-to-measure-it-properly">How to measure it properly</h2>
<p>Three rules, learned the hard way.</p>
<p><strong>Measure end to end, not per segment.</strong> Every team&#39;s individual latency can look excellent while the total is terrible, because the waiting happens at the seams. The customer experiences the total. Nobody internally is looking at it.</p>
<p><strong>Measure from the customer&#39;s first ask.</strong> Not from when the ticket was created, or when it reached the right team, or when it was triaged. From the moment they asked. All the internal routing time is time they were waiting, and excluding it produces a number that flatters you and describes nobody&#39;s experience.</p>
<p><strong>Watch P90 hardest.</strong> The median is the customer who had a normal experience and won&#39;t remember it. P90 is the customer who is composing a message about you right now. If you only get to publish one latency number, publish P90 — it&#39;s the one with information in it.</p>
<h2 id="the-gauge-thats-better-than-latency">The gauge that&#39;s better than latency</h2>
<p>If you can only build one thing, build <strong>time-to-first-signal</strong>: how long from a customer&#39;s request until they receive something real — a human acknowledgment, an ETA, a status change they can see.</p>
<p>It&#39;s usually cheap to move, often automatable, and it collapses the uncertainty term in the equation above. A customer who knows what&#39;s happening will wait a long time without resentment. A customer in the dark starts churning at hour six.</p>
<p>Same principle as everything else here. <strong>A visible process is tolerable at speeds an invisible one is not.</strong> The pipe doesn&#39;t have to be fast if it&#39;s clear — but if it&#39;s dark, it had better be instant, because uncertainty is the thing people can&#39;t stand.</p>]]></content:encoded>
      <category>field note</category>
      <category>metrics</category>
      <category>customers</category>
    </item>
    <item>
      <title>The cost of a black box</title>
      <link>https://theclearpipe.com/blog/the-cost-of-a-black-box/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/the-cost-of-a-black-box/</guid>
      <pubDate>Wed, 12 Aug 2026 13:00:00 GMT</pubDate>
      <description>Opacity is never free. It just bills you later, in currencies that do not appear on any invoice — and it charges compound interest.</description>
      <content:encoded><![CDATA[<p>Nobody chooses opacity on purpose. It&#39;s the default. Building a system that explains itself takes more work than building one that just returns an answer, so under deadline you ship the answer and promise yourself you&#39;ll add the explanation later.</p>
<p>That&#39;s a loan. Here&#39;s the repayment schedule.</p>
<h2 id="you-pay-in-debugging">You pay in debugging</h2>
<p>A black box that misbehaves cannot be diagnosed, only replaced or guessed at. Every incident becomes archaeology: reconstruct the inputs, hypothesize a cause, try a fix, wait to see if it recurs.</p>
<p>I&#39;ve watched a team spend three weeks on a bug that a reasoning trace would have made obvious in twenty minutes. The trace would have taken two days to build. That&#39;s the exchange rate, and it&#39;s not a one-time payment — you make it again at every incident, forever, and the interval between incidents shrinks as the system grows.</p>
<h2 id="you-pay-in-trust-on-a-delay">You pay in trust, on a delay</h2>
<p>Customers accept opacity while things work. The bill arrives the first time something goes wrong.</p>
<p>&quot;Why did this happen?&quot; is a question you must answer to keep a customer. With a black box, the honest answer is &quot;we&#39;re not sure,&quot; and the dishonest answer is a plausible story you&#39;ve assembled after the fact. The first loses the customer. The second loses them later, with interest, when the story turns out to be wrong.</p>
<p>The asymmetry is what makes this expensive: opacity&#39;s benefit is small and continuous (slightly faster shipping), while its cost is large and lumpy (arriving all at once, on the worst day, to the customer you can least afford to lose).</p>
<h2 id="you-pay-in-your-own-teams-confidence">You pay in your own team&#39;s confidence</h2>
<p>This one is under-discussed and I think it&#39;s the largest.</p>
<p>When a system can&#39;t be inspected, people stop believing they understand it. They stop making changes near it. They route around it. The black box becomes a no-go zone that accumulates workarounds, and the workarounds become their own undocumented system.</p>
<p>You can spot it in the language. &quot;We don&#39;t touch that.&quot; &quot;It works, don&#39;t ask.&quot; &quot;Only Sam knows how that behaves.&quot; Each of those sentences is a black box charging rent, and the rent is your team&#39;s willingness to improve the product.</p>
<h2 id="you-pay-in-optionality">You pay in optionality</h2>
<p>An inspectable segment can be replaced — you know what it takes in, what it puts out, and how to tell whether the replacement is better. A black box can only be replaced by rewriting everything that touches it, because nobody knows precisely what it does.</p>
<p>This is how vendors lock you in, and how internal systems become load-bearing beyond anyone&#39;s intent. The lock-in isn&#39;t contractual. It&#39;s epistemic: you can&#39;t leave because you can&#39;t specify what you&#39;d be replacing.</p>
<h2 id="the-one-honest-defense">The one honest defense</h2>
<p>There&#39;s a real argument for opacity: some things are genuinely your edge, and describing them gives it away.</p>
<p>Fine — but be precise about the scope. In practice, almost none of what companies keep dark is edge. Your onboarding time isn&#39;t edge. Your uptime isn&#39;t edge. Your support response distribution isn&#39;t edge. Your model&#39;s reasoning about a customer&#39;s specific case isn&#39;t edge — the weights might be, the explanation isn&#39;t.</p>
<p>The test: <strong>would a competitor learn something they could use from this?</strong> Not &quot;would I be embarrassed&quot; — embarrassment is not a business rationale, it&#39;s an incentive to fix the underlying thing. Almost everything companies hide is hidden because it&#39;s unflattering, and unflattering is exactly the category where visibility does the most good, because visible problems get fixed and hidden ones get explained.</p>
<h2 id="interest-compounds">Interest compounds</h2>
<p>The worst property of opacity is that it grows on its own. A dark segment makes the segments around it harder to observe, because their inputs now come from somewhere unaccountable. Debug the neighbor and the trail ends at the box.</p>
<p>Dark spreads. Clarity also spreads, in the same way and for the same reason — an inspectable segment makes its neighbors easier to reason about, because you can trust what&#39;s arriving.</p>
<p>Which direction your system drifts is decided by a hundred small choices made under deadline. That&#39;s the honest version: nobody decides to build a black box. They decline to build the glass, sixty times, each time for a good reason.</p>]]></content:encoded>
      <category>thesis</category>
      <category>transparency</category>
      <category>trust</category>
    </item>
    <item>
      <title>Replaceable is a compliment</title>
      <link>https://theclearpipe.com/blog/replaceable-is-a-compliment/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/replaceable-is-a-compliment/</guid>
      <pubDate>Tue, 11 Aug 2026 13:00:00 GMT</pubDate>
      <description>The most valuable people I have worked with made themselves unnecessary as fast as possible. The industry rewards the opposite, which is a problem worth naming.</description>
      <content:encoded><![CDATA[<p>There&#39;s a piece of career advice that circulates quietly, and it isn&#39;t wrong about how organizations behave: make yourself indispensable. Become the person who understands the thing nobody else understands. Job security follows.</p>
<p>It&#39;s rational, it works, and it&#39;s corrosive — because a company made of indispensable people is a company that cannot grow, cannot delegate, and cannot survive an ordinary amount of turnover. Every indispensable person is a segment with no fitting on either end. Nothing snaps on. Nothing can be swapped in when they&#39;re out.</p>
<p>I&#39;d rather run a company where &quot;you&#39;ve made yourself replaceable&quot; is the highest compliment available.</p>
<h2 id="what-replaceable-actually-means">What replaceable actually means</h2>
<p>Not interchangeable. Not undervalued. Not easily fired.</p>
<p><strong>Replaceable means the work you do has a described interface.</strong> Someone else could pick it up — with a ramp-up, with your notes, with the gauge you&#39;ve been watching — without conducting a two-month excavation of how the thing works.</p>
<p>That&#39;s a property of the <em>work</em>, not of the person. And the person who produces it is doing something genuinely difficult: they&#39;ve had to understand their own job well enough to describe it, which is a much higher bar than being able to do it.</p>
<p>Most people can do their job. Considerably fewer can explain what &quot;done&quot; means, what has to be true before they can start, and how you&#39;d know if they were doing it badly. The people who can are the ones I want more of.</p>
<h2 id="the-test">The test</h2>
<p>Someone is replaceable when three things are true:</p>
<ol><li><strong>Their inputs and outputs are written down</strong> — actually written down, somewhere a new person could find, not held as tacit knowledge that only surfaces in conversation.</li><li><strong>Their work produces a number someone else reads.</strong> If they&#39;re the only person who knows how it&#39;s going, they&#39;re not replaceable no matter how good the documentation is.</li><li><strong>They&#39;ve been out for two weeks and it was fine.</strong> The empirical test. Everything else is theory.</li></ol>
<p>That third one is the honest audit, and it&#39;s free — vacations happen anyway. Watch what breaks. What breaks is what wasn&#39;t described.</p>
<h2 id="why-its-hard-to-reward">Why it&#39;s hard to reward</h2>
<p>The problem is that this work is invisible by construction. Someone who makes their segment legible produces <em>an absence of drama</em>. No heroics, no late-night saves, no urgent expertise required. Just a thing that runs.</p>
<p>Meanwhile the person who holds an undocumented critical process is highly visible — you hear their name every time something breaks, and you hear it again when they fix it. Organizations reliably promote that person, which teaches everyone watching exactly the wrong lesson.</p>
<p>The fix isn&#39;t a values statement. It&#39;s making legibility a measured output rather than a virtue. In practice:</p>
<ul><li><strong>A segment isn&#39;t done until its interface is written.</strong> Not a separate documentation task that gets deprioritized. Part of done.</li><li><strong>Handoff coverage is a real metric.</strong> For each segment: how many people could run this? Publish it. Anything sitting at one is a risk with a name on it, visible to everyone including the person in it.</li><li><strong>Praise the absence.</strong> When someone&#39;s two-week absence passes without incident, say so publicly and attribute it to the work they did to make that true. Otherwise nobody notices, which is the whole problem.</li></ul>
<h2 id="the-connection">The connection</h2>
<p>The law of flow says segments connect because they have defined fittings. A person who is indispensable is a segment whose fittings are undefined — nothing else can attach to it, and the whole pipe narrows to their throughput.</p>
<p>That&#39;s not a knock on them. It&#39;s usually a consequence of being the person who stepped up when something needed doing and never got the time to describe it afterward. The failure is organizational: we hired for a situation instead of defining a segment, and then rewarded the person for absorbing the ambiguity.</p>
<p>The most valuable thing anyone on my teams does is make their own work handoff-ready. It looks like a career risk. It&#39;s the opposite — the people who can describe a segment cleanly are exactly the people you want defining the next one, and there&#39;s always a next one.</p>]]></content:encoded>
      <category>field note</category>
      <category>teams</category>
      <category>operations</category>
    </item>
    <item>
      <title>Agents need gauges more than guardrails</title>
      <link>https://theclearpipe.com/blog/agents-need-gauges-more-than-guardrails/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/agents-need-gauges-more-than-guardrails/</guid>
      <pubDate>Mon, 10 Aug 2026 13:00:00 GMT</pubDate>
      <description>Guardrails stop the failures you predicted. Gauges catch the ones you didn&#39;t. Most teams spend their entire safety budget on the first kind.</description>
      <content:encoded><![CDATA[<p>Every team shipping autonomous systems builds guardrails. Allow-lists, spend caps, approval gates, prohibited actions. Good. Necessary. Do it.</p>
<p>But guardrails have a structural limitation that gets glossed over: <strong>a guardrail can only stop a failure you thought of in advance.</strong> It&#39;s a hypothesis about how things go wrong, encoded as a rule. Which means your guardrails are exactly as good as your imagination was on the day you wrote them, and no better.</p>
<p>The failures that actually hurt are the ones nobody modeled. For those you don&#39;t need a rule. You need to <em>notice</em>, quickly, that something has changed.</p>
<p>That&#39;s a gauge.</p>
<h2 id="the-distinction">The distinction</h2>
<p>A guardrail is a constraint: <em>never spend more than $500 without approval.</em></p>
<p>A gauge is an observation: <em>here is the distribution of what we&#39;re spending, updated continuously, with a target and a trend.</em></p>
<p>The guardrail catches the runaway. The gauge catches the drift — the slow migration of behavior into a region nobody prohibited because nobody imagined it. And drift is the characteristic failure of autonomous systems, because they&#39;re consistent. A human doing something slightly wrong varies, and the variation gets noticed. A machine does the same slightly-wrong thing four thousand times with perfect consistency, and consistency reads as correctness right up until someone checks.</p>
<h2 id="the-four-gauges-every-agent-needs">The four gauges every agent needs</h2>
<p><strong>Override rate.</strong> How often does a human change or reject what the agent proposed? The single highest-information number in an AI system. Trending down: the agent is learning your business. Trending up: the world moved. Flat at zero: nobody is reviewing, which is not the same as being right.</p>
<p><strong>Input drift.</strong> Is the agent seeing the same <em>kind</em> of thing it saw last month? Track the distribution of inputs, not just the volume. Most silent failures start here — the world changes shape, the agent keeps applying yesterday&#39;s judgment, and every individual decision looks locally reasonable.</p>
<p><strong>Escalation rate.</strong> How often does the agent decline to act and hand off? Also a two-sided number. Too high means it&#39;s not carrying its weight. Too low, especially if it&#39;s falling, often means it has become confident about cases it shouldn&#39;t be confident about — and false confidence looks exactly like competence in every metric except this one.</p>
<p><strong>Time-to-notice.</strong> When something did go wrong, how long until a human knew? This is the meta-gauge, and the only one that tells you whether the rest of your instrumentation works. A team with excellent dashboards and a four-day time-to-notice is dark and doesn&#39;t know it.</p>
<h2 id="why-teams-skip-this">Why teams skip this</h2>
<p>Guardrails feel like safety. They&#39;re concrete, they&#39;re demonstrable, you can list them in a security review, and each one is a satisfying artifact: <em>we thought of this failure and we prevented it.</em></p>
<p>Gauges feel like overhead. They don&#39;t prevent anything. They just tell you what&#39;s happening, and most of the time what&#39;s happening is fine, so the work looks unrewarded — right up to the day it&#39;s the only reason you caught something.</p>
<p>There&#39;s also an uncomfortable asymmetry. Guardrails make you look responsible. Gauges make you <em>accountable</em> — they produce a record of what your system actually did, including on the days you&#39;d rather not discuss. That&#39;s the same nerve cost the law of clarity always exacts, and it&#39;s why the instrumentation work keeps losing to the constraint work in planning meetings.</p>
<h2 id="the-ratio">The ratio</h2>
<p>If your agent safety budget is more than 70% guardrails, you&#39;re preparing for the failures you can imagine and blind to the rest.</p>
<p>Concretely, for any autonomous segment: no guardrail ships without its corresponding gauge. If you&#39;re capping spend, you&#39;re also publishing the spend distribution. If you&#39;re gating an action for approval, you&#39;re also tracking how often approval is denied — because an approval gate with a 100% approval rate isn&#39;t a control, it&#39;s a formality, and you can only know which one you have by measuring it.</p>
<p>Guardrails are how you survive the failures you predicted. Gauges are how you survive the rest — which, historically, is most of them.</p>]]></content:encoded>
      <category>thesis</category>
      <category>agents</category>
      <category>ai</category>
      <category>metrics</category>
    </item>
    <item>
      <title>The pipe test for a new idea</title>
      <link>https://theclearpipe.com/blog/the-pipe-test-for-a-new-idea/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/the-pipe-test-for-a-new-idea/</guid>
      <pubDate>Sun, 09 Aug 2026 13:00:00 GMT</pubDate>
      <description>Five questions I ask before starting anything. They take twenty minutes and they have killed more of my ideas than the market ever got a chance to.</description>
      <content:encoded><![CDATA[<p>I get more ideas than I can build, which is a normal condition and not a boast — the constraint on a portfolio is never idea supply. Choosing badly is the expensive failure, and it&#39;s expensive in a slow way: you don&#39;t find out for a year, and the year is gone regardless.</p>
<p>So I run everything through five questions first. They&#39;re all versions of the two laws, applied before there&#39;s anything to look at.</p>
<h2 id="1-what-flows-through-it">1. What flows through it?</h2>
<p>Name the unit. A signed contract. A resolved ticket. A released track. A completed tax filing.</p>
<p>If the answer is abstract — &quot;we help teams collaborate better&quot; — there&#39;s no pipe yet. There&#39;s a hope about an outcome. You cannot measure, instrument, price, or improve a thing you can&#39;t count, and the inability to name the unit at the idea stage reliably predicts the inability to name it two years in.</p>
<h2 id="2-what-are-the-fittings">2. What are the fittings?</h2>
<p>What does this connect to on either end? Where does the input come from today, and where does the output go?</p>
<p>A product with no defined fittings has to become someone&#39;s whole world to be adopted, which is a much harder sell than being a segment they can snap in. The best businesses I&#39;ve been part of attach to something already flowing. The worst asked everyone to redirect their existing flow into a new system first, and were rewarded with pilots that never expanded.</p>
<h2 id="3-whats-the-gauge">3. What&#39;s the gauge?</h2>
<p>What single number tells you it&#39;s working — and could you show it to a customer without translation?</p>
<p>If the only available answer is a vanity number (signups, usage, &quot;engagement&quot;) the value proposition isn&#39;t clear enough yet. Real products have a number that a customer would recognize as a description of their own life getting better: days saved, dollars found, errors avoided.</p>
<h2 id="4-what-goes-dark-if-this-succeeds">4. What goes dark if this succeeds?</h2>
<p>The one people skip, and the one that has saved me the most.</p>
<p>Every automation replaces some human observation, and that observation was doing work nobody wrote down. If this idea works at scale, what will nobody be watching anymore? What will you find out late that you currently find out early?</p>
<p>If you can&#39;t answer, you&#39;re not ready to build it. If you can answer and the answer is frightening, that&#39;s your first gauge — build it before you build the feature.</p>
<h2 id="5-whats-the-smallest-complete-segment">5. What&#39;s the smallest complete segment?</h2>
<p>Not the smallest <em>feature</em>. The smallest thing with a real In, a real Out, and a gauge on the joint.</p>
<p>An MVP that does half a job for everybody is worse than useless: it produces feedback about a thing you&#39;d never ship. A complete segment that handles one narrow case end to end produces feedback you can act on, because someone actually ran work through it and either got value or didn&#39;t.</p>
<p>The distinction is: does the unit come out the other end? If yes, it&#39;s a segment, however narrow. If no, it&#39;s a demo.</p>
<h2 id="what-the-test-is-really-doing">What the test is really doing</h2>
<p>Every question is the two laws in disguise.</p>
<p><em>What flows, what are the fittings, what&#39;s the smallest complete segment</em> — that&#39;s <strong>pipes connect</strong>. Can this thing exist as a piece of a larger system, or does it demand to be the system?</p>
<p><em>What&#39;s the gauge, what goes dark</em> — that&#39;s <strong>glass reveals</strong>. Will you be able to see whether this is working, and will it make anything else harder to see?</p>
<p>Twenty minutes, five questions. Most ideas die on question one, which is a gift — a bad idea killed at the whiteboard costs nothing, and the same idea killed by the market costs a year and a team&#39;s belief that you know what you&#39;re doing.</p>]]></content:encoded>
      <category>playbook</category>
      <category>product</category>
      <category>decisions</category>
    </item>
    <item>
      <title>Dashboards lie by omission</title>
      <link>https://theclearpipe.com/blog/dashboards-lie-by-omission/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/dashboards-lie-by-omission/</guid>
      <pubDate>Sat, 08 Aug 2026 13:00:00 GMT</pubDate>
      <description>Every number on the screen was true. The picture they assembled was false. Three ways honest metrics produce a dishonest view, and what to add.</description>
      <content:encoded><![CDATA[<p>The most dangerous reporting I&#39;ve encountered wasn&#39;t fabricated. Every figure was computed correctly from real data by people acting in good faith.</p>
<p>It was still wrong, because a dashboard is an argument about what matters, and arguments can mislead entirely through what they leave out.</p>
<p>Three failure modes, all of which I&#39;ve shipped myself.</p>
<h2 id="1-the-average-that-hides-the-tail">1. The average that hides the tail</h2>
<p>&quot;Median response time: 2.1 hours.&quot; Excellent. Everyone&#39;s happy.</p>
<p>P90: 31 hours. P99: four days.</p>
<p>The median describes the experience of the customer having a normal day. The tail describes the experience of the customer having a problem — who is, by definition, the customer whose opinion of you is being formed right now, and the one most likely to tell other people about it.</p>
<p>Averages and medians are optimized for reassurance. They tell you the system usually works, which you already believed. Every gauge worth publishing needs a tail number next to it, because <strong>the tail is where the churn is</strong>.</p>
<h2 id="2-the-rate-that-hides-the-denominator">2. The rate that hides the denominator</h2>
<p>&quot;Conversion is up 12% this month.&quot; Real number, correctly computed.</p>
<p>Traffic was down 40%. The remaining visitors were disproportionately people who already knew what they wanted. Conversion went up because the top of the funnel collapsed and only the pre-sold were left.</p>
<p>Any ratio can move for two reasons, and the good one and the bad one look identical in the ratio. <strong>Never publish a rate without its numerator and denominator visible.</strong> It costs one line of layout and it eliminates an entire genre of confident wrong conclusion.</p>
<h2 id="3-the-snapshot-that-hides-the-trend">3. The snapshot that hides the trend</h2>
<p>A number without history is a fact without meaning. &quot;Churn: 3.2%.&quot; Is that good? Nobody can say. Good relative to what?</p>
<p>Show four weeks and it becomes information. Show a target and it becomes actionable. A snapshot invites everyone to bring their own prior about what&#39;s normal, and people&#39;s priors are anchored to whatever they last heard in a meeting.</p>
<h2 id="what-to-add">What to add</h2>
<p>Four things, every gauge, no exceptions:</p>
<ol><li><strong>The tail</strong>, not just the center.</li><li><strong>The denominator</strong>, not just the rate.</li><li><strong>The trend</strong>, not just today.</li><li><strong>The target</strong>, so the reader doesn&#39;t need context you have and they don&#39;t.</li></ol>
<p>That&#39;s four times as much ink per number, which is precisely why you should publish a quarter as many numbers. Eleven well-dressed metrics beat forty naked ones, every time, because the naked ones require interpretation and interpretation doesn&#39;t happen on a busy Tuesday.</p>
<h2 id="the-omission-that-matters-most">The omission that matters most</h2>
<p>Here&#39;s the one almost nobody includes: <strong>what isn&#39;t on the dashboard.</strong></p>
<p>A short line at the bottom — <em>not currently instrumented: partner-sourced deals, enterprise renewals, the migration path</em> — does more for honest decision-making than any tile above it. It converts an unknown unknown into a known one, and known gaps get filled.</p>
<p>Without it, a dashboard implicitly claims completeness. Readers assume that if something mattered, it&#39;d be shown. That assumption is almost always false, and it&#39;s the mechanism by which a company convinces itself it&#39;s watching the business while an entire segment runs dark in plain sight.</p>
<p>The law of clarity isn&#39;t &quot;publish numbers.&quot; It&#39;s <em>glass reveals</em> — and glass that only covers the flattering half of the pipe is a mirror.</p>]]></content:encoded>
      <category>field note</category>
      <category>metrics</category>
      <category>transparency</category>
    </item>
    <item>
      <title>Write the interface before the org chart</title>
      <link>https://theclearpipe.com/blog/write-the-interface-before-the-org-chart/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/write-the-interface-before-the-org-chart/</guid>
      <pubDate>Fri, 07 Aug 2026 13:00:00 GMT</pubDate>
      <description>Most companies hire a role and then discover what it does. Reversing that order costs an hour and prevents a category of problem that reorgs cannot fix.</description>
      <content:encoded><![CDATA[<p>The standard way to add capacity is to define a role, hire a person, and let the actual job emerge from what that person turns out to be good at.</p>
<p>It works, in the sense that the work gets done. It also manufactures situations — undefined steps held together by one person&#39;s judgment — at exactly the rate you&#39;re hiring. Two years of that and you have a company whose processes cannot be described, only staffed.</p>
<p>The alternative takes an hour and inverts the order: <strong>define the segment, then hire the person who fits it.</strong></p>
<h2 id="what-define-the-segment-means">What &quot;define the segment&quot; means</h2>
<p>Before you write a job description, write these four lines:</p>
<ul><li><strong>In</strong> — what arrives, from where, in what state</li><li><strong>Out</strong> — what leaves, to whom, in what state</li><li><strong>Gauge</strong> — the number that says this segment is healthy</li><li><strong>Rate</strong> — how much throughput it needs to handle</li></ul>
<p>That&#39;s the interface. Notice it says nothing about seniority, background, or which tools get used. Those are implementation. The interface is the contract.</p>
<p>If you can&#39;t write those four lines, you don&#39;t have a role yet. You have a feeling that things are busy, and hiring against a feeling is how you end up with a person who is undeniably working hard on something nobody can quite describe.</p>
<h2 id="what-it-changes">What it changes</h2>
<p><strong>The job description writes itself, and it&#39;s honest.</strong> &quot;Own the seam between closed-won and first successful import. Target: median under three days, P90 under seven. Currently at 4.1 and 9.&quot; A candidate reads that and knows exactly what they&#39;d be accountable for. The ones who don&#39;t want that job select out, which is the entire purpose of a job description and something most of them fail to do.</p>
<p><strong>You find out whether you needed a person.</strong> Roughly a third of the time, writing the interface reveals that the segment is well-defined enough to automate, or that it&#39;s really two segments and only one is overloaded. Those are cheaper answers than a hire, and you only get to them by making the work explicit first.</p>
<p><strong>Onboarding gets short.</strong> A new hire with a defined In, Out, and gauge is productive in days, because the ambiguity that normally eats the first two months has been resolved before they arrived. The expensive part of onboarding isn&#39;t learning the tools. It&#39;s discovering what the job actually is, which the interface hands over on day one.</p>
<p><strong>The role survives the person.</strong> When someone leaves a defined segment, you replace a segment. When someone leaves a situation, you lose a capability and spend a quarter reconstructing it from artifacts and other people&#39;s memories.</p>
<h2 id="the-objection">The objection</h2>
<p>&quot;Our work is too fluid to define like that.&quot;</p>
<p>Sometimes true. Early-stage companies genuinely have work that changes shape monthly, and premature definition would be a cost with no benefit.</p>
<p>But it&#39;s true much less often than it&#39;s claimed. The usual meaning of &quot;too fluid to define&quot; is &quot;we haven&#39;t looked closely enough to describe it,&quot; and the tell is that the same work has been happening for eighteen months. Fluid work changes. Undescribed work just hasn&#39;t been examined.</p>
<p>The honest test: pick the role you&#39;d call the most fluid, and try to write the four lines. If you can&#39;t, ask the person doing the job to write them. In my experience they can, usually in ten minutes, and frequently with visible relief — because being accountable for an undefined job is worse for the person in it than for anyone else.</p>
<h2 id="the-connection-to-the-law">The connection to the law</h2>
<p>Pipes connect because segments have fittings. An org chart tells you who reports to whom, which is a fact about authority and not about flow. A pipe diagram tells you how work moves.</p>
<p>Hiring against the org chart adds a person to a box. Hiring against the interface adds a segment to a pipe — with a defined inlet, a defined outlet, and a gauge on the joint.</p>
<p>One of those compounds. The other one accumulates.</p>]]></content:encoded>
      <category>playbook</category>
      <category>hiring</category>
      <category>segments</category>
    </item>
    <item>
      <title>Handoffs are where companies leak</title>
      <link>https://theclearpipe.com/blog/handoffs-are-where-companies-leak/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/handoffs-are-where-companies-leak/</guid>
      <pubDate>Thu, 06 Aug 2026 13:00:00 GMT</pubDate>
      <description>Nobody owns the space between two teams, which is exactly why most of your lost time lives there. Four questions that find the leak.</description>
      <content:encoded><![CDATA[<p>Ask a company where its time goes and you&#39;ll get answers about work: this team is under-resourced, that project is complicated, we&#39;re waiting on the vendor.</p>
<p>Measure it and you&#39;ll find something different. Most of the elapsed time in a typical business process isn&#39;t spent doing anything. It&#39;s spent <em>waiting at a seam</em> — sitting in a queue between one team finishing and another starting.</p>
<p>I&#39;ve measured this in enough places to stop being surprised. In an eleven-step onboarding process we mapped last year, the actual work took about four hours. The elapsed time was nine days. Everything else was handoff.</p>
<h2 id="why-seams-are-invisible">Why seams are invisible</h2>
<p>A step has an owner. The seam between two steps has none.</p>
<p>Each team measures its own segment, honestly, and reports good numbers. Sales closes fast. Onboarding executes in two hours. Both are true. Neither of them is measuring the four days a deal sits between &quot;closed&quot; and &quot;someone in onboarding noticed.&quot;</p>
<p>This is a structural blind spot, not a people problem. Every incentive points inward at the segment; nothing points at the space between segments. So the space between segments is where all the slack accumulates, and it accumulates invisibly because no dashboard has a tile for it.</p>
<h2 id="the-four-questions">The four questions</h2>
<p>At every seam in your process, ask:</p>
<p><strong>1. Does work arrive, or does someone have to go find it?</strong> Pull-based seams — where the downstream team checks a queue, a shared inbox, a folder — are slower than push-based ones by a factor that scales with how busy the downstream team is. And they degrade silently: nothing breaks, things just take longer, and the delay is invisible unless you&#39;re timing the seam specifically.</p>
<p><strong>2. Does everything needed arrive together?</strong> If the receiving team routinely has to go back upstream for one more detail, the upstream Out and the downstream In don&#39;t match. Every unit of work through that seam pays the round trip. Fixing the mismatch is usually an afternoon and pays forever.</p>
<p><strong>3. Would anyone notice if the queue stopped?</strong> If work quietly stopped arriving, how long until someone asked? In most companies the honest answer is &quot;when a customer complains.&quot; A seam with no alarm is a seam that can fail completely without generating a signal.</p>
<p><strong>4. Who is accountable for the seam itself?</strong> Not the sending team, not the receiving team. Someone whose number is the <em>total</em> time across the boundary. Without this, both teams optimize their own side and the seam belongs to no one.</p>
<h2 id="the-cheapest-fix-in-operations">The cheapest fix in operations</h2>
<p>Instrument the seams before you do anything else.</p>
<p>For each handoff, record two timestamps: when the upstream step completed, and when the downstream step started. Publish the median and the P90 of the gap.</p>
<p>That&#39;s it. No new tooling, no process redesign, no reorg. Two timestamps and a weekly number.</p>
<p>I have never once seen this done for the first time without producing a genuine surprise — a seam eating days that everyone assumed took hours. And the fix, once the number is visible, is almost always small: an automated notification, a shared definition of &quot;ready,&quot; one person made accountable for the boundary.</p>
<p>The reason it stays broken is not that it&#39;s hard. It&#39;s that nobody could see it.</p>
<h2 id="the-deeper-version">The deeper version</h2>
<p>A seam that leaks is a fitting that doesn&#39;t fit. The law of flow says segments connect because their inlets and outlets are defined; a leaking seam means one of those definitions is missing or wrong.</p>
<p>Which gives you the permanent fix, as opposed to the patch. Write down what the upstream segment produces and what the downstream segment requires. Compare them. The gap is your leak, in writing, before you&#39;ve spent a minute on process improvement.</p>
<p>Most companies try to fix handoffs by asking people to communicate better. Communication is what you need when the interface is undefined. Define the interface and the communication becomes unnecessary — which is the point, because &quot;remember to tell them&quot; is not a system, it&#39;s a hope.</p>]]></content:encoded>
      <category>playbook</category>
      <category>operations</category>
      <category>handoffs</category>
    </item>
    <item>
      <title>Shared infrastructure is the point</title>
      <link>https://theclearpipe.com/blog/shared-infrastructure-is-the-point/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/shared-infrastructure-is-the-point/</guid>
      <pubDate>Tue, 04 Aug 2026 13:00:00 GMT</pubDate>
      <description>Four companies, one set of pipes. What actually shares cleanly across a portfolio, what doesn&#39;t, and the test we use to tell them apart before writing the code.</description>
      <content:encoded><![CDATA[<p>Four companies in the portfolio — Largo, Richie, OnChainMind, PLAY.PAUSE.PLAI. — in four unrelated markets. Ambient software, tax, autonomous trading, and a record label. Nothing about their customers overlaps.</p>
<p>Their plumbing overlaps almost completely.</p>
<p>That&#39;s not a coincidence and it isn&#39;t luck. It&#39;s the direct consequence of building every company as segments with defined fittings: when four businesses all expose the same shape of joint, the same infrastructure snaps onto all four.</p>
<h2 id="what-shares">What shares</h2>
<p><strong>Identity and permissions.</strong> One system. Every company needs to know who a user is and what they&#39;re allowed to touch, and there is nothing differentiating about any company&#39;s answer to that question.</p>
<p><strong>The action ledger.</strong> This is the big one. Every portfolio company records agent decisions the same way: trigger, inputs consulted, reasoning, action taken, outcome, human override if any. Largo logs a drafted email. Richie logs a proposed deduction. OnChainMind logs a trade. Same schema, same query interface, same replay tooling.</p>
<p>Building that four times would have been four times the work and produced four incompatible things. Building it once meant that a debugging tool written for Largo works on Richie&#39;s pipeline the day it ships.</p>
<p><strong>The gauge layer.</strong> Throughput, latency, quality, and override rate at every joint — computed by the same service, posted to the same weekly digest format, with the same target-and-delta presentation. A new company gets instrumented on day one instead of in month six, which means it&#39;s never dark, which means its first real problem shows up as a number instead of a crisis.</p>
<p><strong>Evaluation harness.</strong> Feed a segment historical inputs, compare its outputs against what actually happened, report the drift. Domain-agnostic by construction, because it operates on the fitting rather than on the contents.</p>
<p><strong>Publishing.</strong> This site, the feed, the docs, the status pages. One static pipeline, four sets of content.</p>
<h2 id="what-doesnt-share">What doesn&#39;t share</h2>
<p>This is the more useful list, because the failure mode of a portfolio is over-sharing, and it&#39;s a much more expensive mistake than under-sharing.</p>
<p><strong>Domain models.</strong> A transaction in Richie and a transaction in OnChainMind have almost nothing in common beyond the word. Every attempt I&#39;ve seen to build a &quot;universal entity model&quot; across genuinely different domains produces an abstraction so loose it carries no meaning and so central that nobody can change it. We didn&#39;t try.</p>
<p><strong>Judgment.</strong> How Richie decides a position is defensible has no relationship to how OnChainMind decides a trade is permitted. This is the actual product in each company. Sharing it would mean none of them is any good.</p>
<p><strong>Interfaces.</strong> A tax review screen and an ambient assistant surface answer to totally different rhythms. We share design tokens and a component library. We don&#39;t share layouts, and we don&#39;t share flows.</p>
<h2 id="the-test">The test</h2>
<p>Before anything becomes shared infrastructure, it has to pass one question:</p>
<blockquote><p><strong>Does this depend on what the business does, or only on the shape of the joint?</strong></p></blockquote>
<p>The action ledger depends only on the shape: something decided, something happened, a human agreed or didn&#39;t. That&#39;s true in every domain, so it shares.</p>
<p>A deduction classifier depends entirely on what the business does. It doesn&#39;t share, and any version of it that did would be so generic it&#39;d be useless in tax and unusable everywhere else.</p>
<p>This test is cheap to apply and it has been right nearly every time. When we&#39;ve violated it — twice, both times because a thing <em>looked</em> general — we ended up with an abstraction that grew a special case per company until it was four systems wearing a trench coat. Both got split back apart, and the split was more expensive than the original duplication would have been.</p>
<p><strong>Duplication is cheaper than the wrong abstraction.</strong> Old advice. Still true. Worth restating because the pull toward premature sharing is strongest exactly when you have several companies and a tidy mind.</p>
<h2 id="what-it-actually-buys">What it actually buys</h2>
<p>The obvious answer is cost, and cost is the least of it.</p>
<p><strong>A new company starts instrumented.</strong> Day one, it has identity, a ledger, gauges, and a publishing path. The first version of a new product is the version most likely to go dark, because everything is urgent and instrumentation always feels like it can wait. Shared infrastructure removes that choice — the gauges are there because they came with the fittings.</p>
<p><strong>Lessons transfer.</strong> The override-rate insight from Largo — that clustered overrides pointed at a permissions problem, not a model problem — was directly applicable to Richie, because both measure the same joint the same way. That transfer is only possible because the measurement is identical. Four companies each measuring their own thing their own way would have learned that lesson four separate times, or three times too few.</p>
<p><strong>People transfer.</strong> Someone who has worked on one company&#39;s pipeline can read another&#39;s. Not the domain logic — that takes months in any company — but the structure, the ledger, the gauges, the deploy path. That&#39;s most of the ramp-up cost in practice.</p>
<h2 id="the-honest-caveat">The honest caveat</h2>
<p>Shared infrastructure creates shared failure modes. When the ledger service has a bad day, four companies have a bad day. We accept that, and we pay for it with the boring things: hard SLAs on the shared layer, graceful degradation in every consumer, and a rule that no company&#39;s critical path can be blocked by a shared service that&#39;s merely <em>slow</em>.</p>
<p>The alternative — four companies each building their own version of the same undifferentiated plumbing, four times as much surface area, four times as many places to be dark — is worse in every direction that matters.</p>
<p>Pipes connect. That&#39;s the first law, and a portfolio is just the largest available demonstration of it.</p>]]></content:encoded>
      <category>playbook</category>
      <category>portfolio</category>
      <category>infrastructure</category>
    </item>
    <item>
      <title>An audit trail is a product feature</title>
      <link>https://theclearpipe.com/blog/an-audit-trail-is-a-product/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/an-audit-trail-is-a-product/</guid>
      <pubDate>Fri, 31 Jul 2026 13:00:00 GMT</pubDate>
      <description>OnChainMind writes every trading decision to a public ledger before it executes. That constraint cost us performance and bought us something worth more.</description>
      <content:encoded><![CDATA[<p>OnChainMind runs autonomous trading agents. Every decision — the reasoning, the inputs, the policy that permitted it — is written to an on-chain record. Before execution, not after.</p>
<p>That ordering is the whole design, and it&#39;s worth explaining why, because &quot;we log our trades&quot; is table stakes and &quot;we commit our reasoning before we act&quot; is a different animal.</p>
<h2 id="logging-after-the-fact-proves-nothing">Logging after the fact proves nothing</h2>
<p>A record written after execution can be edited, curated, or simply omitted when the result is embarrassing. Every fund in the world can produce a trade log. Almost none of them can produce a log of the trades they <em>considered and rejected</em>, or the reasoning that preceded a position that went badly.</p>
<p>That&#39;s not because they&#39;re dishonest. It&#39;s because a post-hoc record is inherently a story about what happened, and stories get written by people who know the ending. The record is compiled by the same process that has an interest in how it reads.</p>
<p>Commit the reasoning first — timestamped, immutable, before the outcome is known — and the incentive disappears. You can&#39;t curate a record you wrote before you knew whether you&#39;d want to.</p>
<h2 id="what-it-costs">What it costs</h2>
<p>Being honest about the trade-offs, because a post that only lists benefits isn&#39;t a field note, it&#39;s marketing.</p>
<p><strong>Latency.</strong> Committing before acting adds time between decision and execution. In some strategies that&#39;s fatal, and we simply don&#39;t run those. The portfolio is deliberately restricted to strategies where a bounded delay doesn&#39;t destroy the edge. That&#39;s a real constraint on what OnChainMind can be, chosen on purpose.</p>
<p><strong>Legibility of your edge.</strong> Publishing reasoning means publishing something about how you think. We&#39;ve had this argument internally more than once. The resolution we landed on: the reasoning is public, the parameters aren&#39;t, and in practice an edge that dies from being described was never much of an edge. Most of what&#39;s valuable is execution and adaptation, neither of which transfers by reading a log.</p>
<p><strong>Nowhere to hide.</strong> The bad weeks are as public as the good ones. Permanently. This is the cost people underestimate, and it&#39;s not a technical cost — it&#39;s a nerve cost, paid on the specific days you&#39;d least like to pay it.</p>
<h2 id="what-it-buys">What it buys</h2>
<p><strong>Debuggability.</strong> When an agent does something surprising, we don&#39;t reconstruct — we read. The reasoning is right there, exactly as it was, uncontaminated by what we learned afterward. This has cut incident post-mortems from days of archaeology to an afternoon of reading, and it removes the worst failure mode of a post-mortem: a plausible reconstruction that&#39;s wrong, adopted as fact, leading to a fix for a bug that never existed.</p>
<p><strong>A hindsight-proof record.</strong> Anyone can look at a losing position and construct a story about why it was reasonable at the time. With a pre-committed record, you don&#39;t get to. Either the reasoning holds up against what was knowable then or it doesn&#39;t, and the record settles it in about thirty seconds. This has made our internal reviews dramatically less political.</p>
<p><strong>Trust that doesn&#39;t require belief.</strong> We don&#39;t ask anyone to take our word for the track record. The record is on-chain. Verify it yourself, or don&#39;t — the claim doesn&#39;t depend on your assessment of our character. In a category that has burned people repeatedly, &quot;you don&#39;t have to trust us&quot; is a stronger pitch than any assurance we could offer.</p>
<p><strong>Agents that are safe to run unattended.</strong> This is the one that matters most operationally. An autonomous agent with a public, pre-committed reasoning trail can be monitored by anyone, including automated policy checks. We can assert invariants against the reasoning itself — <em>this agent may never justify a position on grounds we&#39;ve prohibited</em> — and catch a drift in behavior before it becomes a drift in P&amp;L.</p>
<h2 id="the-general-principle">The general principle</h2>
<p>I&#39;ve come to think of the audit trail as the pipe&#39;s glass wall, in the most literal sense the metaphor allows. It&#39;s not documentation <em>about</em> the system. It&#39;s the system, visible while it runs.</p>
<p>And it follows the pattern I keep hitting: <strong>transparency infrastructure becomes product infrastructure.</strong> We built the on-chain record so users wouldn&#39;t have to trust us. It turned into our debugger, our post-mortem process, our policy enforcement layer, and — as of this quarter — an API that other people are building monitoring on top of.</p>
<p>That keeps happening. The gauge you build to prove you&#39;re honest becomes the gauge you use to run the thing. I no longer treat this as a happy accident; I treat it as a design heuristic. When you&#39;re deciding whether the transparency work is worth it, assume you&#39;ll get a second product out of it, because so far we always have.</p>
<h2 id="the-rule">The rule</h2>
<p><strong>If an agent can&#39;t explain a decision before making it, it doesn&#39;t get to make it.</strong></p>
<p>That&#39;s not an ethics statement, though it&#39;s compatible with one. It&#39;s an engineering constraint that keeps the pipe clear at the exact joint where autonomous systems tend to go dark — the moment between judgment and action, which is invisible by default and where everything expensive happens.</p>]]></content:encoded>
      <category>portfolio</category>
      <category>onchainmind</category>
      <category>agents</category>
      <category>transparency</category>
    </item>
    <item>
      <title>Richie shows its work</title>
      <link>https://theclearpipe.com/blog/richie-shows-its-work/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/richie-shows-its-work/</guid>
      <pubDate>Mon, 27 Jul 2026 13:00:00 GMT</pubDate>
      <description>In tax, an answer without a citation is worthless — and possibly dangerous. Building for that constraint produced a better product than building for accuracy alone would have.</description>
      <content:encoded><![CDATA[<p>Richie finds money hiding in your finances. Deductions you missed, elections you didn&#39;t know existed, timing you could have handled differently. It&#39;s tax intelligence, and tax is an unusually honest domain to build AI into, because it has a property most domains lack:</p>
<p><strong>An answer without a citation is worth nothing.</strong></p>
<p>Not &quot;less.&quot; Nothing. If Richie tells you that you can deduct something and can&#39;t point to why, you cannot act on it. Your accountant won&#39;t sign it. You can&#39;t defend it under examination. A confident, unsourced, correct answer and a confident, unsourced, wrong answer are indistinguishable at the moment you receive them, and the cost of the second one is measured in penalties.</p>
<p>That constraint shaped the product more than any feature decision we made.</p>
<h2 id="structure-follows-the-constraint">Structure follows the constraint</h2>
<p>Because the citation is non-negotiable, Richie couldn&#39;t be built as a model that reads your finances and emits conclusions. The pipe had to have segments you could inspect independently:</p>
<ol><li><strong>Ingest</strong> — normalize the raw financial record. Out: a set of transactions and entities with provenance attached to each one.</li><li><strong>Classify</strong> — decide what each thing <em>is</em> for tax purposes. Out: a classification plus the rule that produced it.</li><li><strong>Apply</strong> — match classified facts against positions that could apply. Out: a candidate list, each with the authority it rests on.</li><li><strong>Quantify</strong> — compute the dollar impact and the confidence. Out: a number and a range.</li><li><strong>Present</strong> — explain it to a human in the order a human would ask.</li></ol>
<p>Five segments, five defined outputs, each independently inspectable. That&#39;s not architecture astronautics — it&#39;s forced by the domain. When a user asks &quot;why do you think this,&quot; the answer has to be assembled from a chain of steps that each kept their receipts. You can&#39;t reconstruct a citation after the fact from a system that didn&#39;t keep one.</p>
<p>The thing I&#39;d underline for anyone building in a regulated space: <strong>the audit requirement isn&#39;t a tax on your architecture, it&#39;s a specification for it.</strong> It told us where the joints go. Domains without that forcing function often end up as one giant opaque step, not because that&#39;s better but because nothing stopped it.</p>
<h2 id="what-showing-the-work-means-in-practice">What &quot;showing the work&quot; means in practice</h2>
<p>Every number Richie surfaces expands into a chain:</p>
<blockquote><p><strong>$4,180 — home office, simplified method</strong> Because: 312 sq ft of exclusive use (from your floor plan, uploaded March 3) · you filed Schedule C in 2024 and 2025 · the simplified method yields more than actual expense for your utility profile (comparison shown) · authority: IRC §280A(c)(1), Rev. Proc. 2013-13.</p></blockquote>
<p>Every clause in that chain links to the input it came from or the rule it applied. A user can walk the whole thing. An accountant can walk the whole thing faster and reject the one clause they disagree with, without discarding the other four.</p>
<p>That last property is the one I underestimated. <strong>Inspectable reasoning fails gracefully.</strong> When a black box is wrong, the user learns that the product is unreliable and stops trusting all of it. When a transparent chain is wrong, the user learns that <em>one link</em> is wrong, corrects it, and keeps the rest. The first failure mode costs you the customer. The second one is just editing.</p>
<h2 id="the-gauge-that-runs-the-roadmap">The gauge that runs the roadmap</h2>
<p>Richie&#39;s core gauge is the <strong>acceptance rate by position type</strong>: of the opportunities we surface, what fraction does the user (or their accountant) actually accept and file.</p>
<p>Not model accuracy. Not confidence scores. Acceptance — the joint between what the machine proposed and what a human was willing to put their name on.</p>
<p>It&#39;s a brutal metric because it&#39;s honest about things accuracy hides. A position can be technically correct and still get rejected because the documentation burden isn&#39;t worth $200, or because the user doesn&#39;t want the audit-risk profile, or because the explanation didn&#39;t land. All three of those are product failures. None of them show up in an eval.</p>
<p>Sorting the roadmap by acceptance rate produced a very different quarter than sorting by model performance would have. The lowest-acceptance category wasn&#39;t the one where we were least accurate — it was the one where we were accurate and <em>unconvincing</em>. We fixed the explanation, not the model, and acceptance moved eleven points.</p>
<h2 id="what-we-wont-do">What we won&#39;t do</h2>
<p>We won&#39;t surface a position we can&#39;t cite. Not with a disclaimer, not behind a &quot;speculative&quot; label, not as a &quot;you may want to ask about this.&quot;</p>
<p>There&#39;s real pressure to. The volume of found money goes up if you loosen the standard, and volume is a great number to put in a deck. But the entire value of the product is that a user can act on what it says. One unsourced claim that costs someone a penalty converts Richie from a tool into a liability, and no amount of found money buys that back.</p>
<p>This is what the law of clarity looks like when it has teeth. Not &quot;we publish a dashboard.&quot; A rule that costs you something real, held to when there&#39;s a good argument for breaking it.</p>
<p>Glass is only a feature if you don&#39;t paint over the parts you&#39;d rather not show.</p>]]></content:encoded>
      <category>portfolio</category>
      <category>richie</category>
      <category>fintech</category>
      <category>trust</category>
    </item>
    <item>
      <title>Largo, or what an ambient assistant owes you</title>
      <link>https://theclearpipe.com/blog/largo-building-behind-glass/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/largo-building-behind-glass/</guid>
      <pubDate>Mon, 20 Jul 2026 13:00:00 GMT</pubDate>
      <description>An assistant that watches your workday is the most invasive product category we have built. Which is exactly why it has to be the most transparent one.</description>
      <content:encoded><![CDATA[<p>Largo watches your workday. That&#39;s the product. It sees what you&#39;re working on across your desktop and phone, notices the moments where an agent workflow would help, and runs it.</p>
<p>Say that sentence to someone cold and watch their face. It is, on its surface, the most invasive category of software anyone has shipped to knowledge workers. And the reaction is correct — that&#39;s a lot of access to hand to a piece of software, and most of the industry&#39;s track record with that kind of access is not reassuring.</p>
<p>Which is why Largo is the clearest test of the thesis in the portfolio. If &quot;built behind glass&quot; is a real design constraint and not a slogan, it has to survive the product where opacity would be most tempting and most profitable.</p>
<h2 id="the-rule-we-started-from">The rule we started from</h2>
<p><strong>Anything Largo can see, you can see. Anything Largo does, you can replay.</strong></p>
<p>Not &quot;we take privacy seriously.&quot; Not a policy page. A structural property of the system, enforced by how it&#39;s built rather than by what we promise.</p>
<p>Concretely:</p>
<ul><li>Every capture Largo makes is listed, timestamped, and inspectable in a local log you can open at any time.</li><li>Every action it takes on your behalf records its trigger, its inputs, the steps it ran, and the result. You can replay that trace step by step.</li><li>Every capture and every trace can be deleted, individually or in bulk, and deletion means deletion — not a flag on a row we keep.</li></ul>
<p>That third one has real engineering cost. It constrains how we cache, what we can embed, and how derived state gets invalidated. We paid it anyway, because a delete button that leaves the data behind is a lie with a UI on top of it, and once you&#39;ve told one of those the rest of the transparency story is worthless.</p>
<h2 id="what-surprised-us">What surprised us</h2>
<p>I expected the visible log to be a trust feature — something users would check once during evaluation, feel reassured by, and never open again.</p>
<p>It&#39;s a <em>usability</em> feature, and it&#39;s the most-used surface in the product after the main assistant view.</p>
<p>People open the log to answer questions like &quot;what was I doing on Tuesday afternoon,&quot; &quot;what did it change in that document,&quot; and &quot;why did it do that.&quot; The audit trail turned out to be a memory prosthetic. We built it to prove we weren&#39;t hiding anything and shipped a feature people use to recover their own week.</p>
<p>I keep finding versions of this. <strong>Transparency infrastructure has a habit of turning into product.</strong> The log becomes search. The trace becomes debugging. The gauge becomes a status page customers cite in support tickets. You build it for trust and it pays rent in utility.</p>
<h2 id="where-it-got-hard">Where it got hard</h2>
<p>Two places, and neither was where I expected.</p>
<p><strong>Ambient capture has no natural boundary.</strong> A pipe with defined inputs is easy to reason about. &quot;Everything on your screen&quot; is not an input, it&#39;s a firehose, and the honest version of the law of flow says a segment needs a <em>defined</em> inlet. We ended up defining capture by workspace context rather than by time — Largo attaches to what you&#39;ve told it you&#39;re working on, and it lets go when you leave. That&#39;s a narrower product than &quot;sees everything.&quot; It&#39;s also the only version I&#39;d install on my own machine.</p>
<p><strong>Traces are only useful if they&#39;re legible.</strong> Our first implementation logged everything faithfully and produced a wall of JSON that told a normal person nothing. Technically complete, practically dark. Glass you can&#39;t see through is just an expensive wall.</p>
<p>The rewrite renders each action as a plain-language narrative — <em>read the thread, extracted three dates, checked your calendar, drafted a reply, waited for approval</em> — with the raw record one click underneath. The completeness didn&#39;t change. The legibility did, and legibility is the thing the law of clarity is actually asking for.</p>
<h2 id="the-gauge-we-publish-internally">The gauge we publish internally</h2>
<p>The number the Largo team watches most closely is the <strong>approval override rate</strong>: how often a user changes or rejects an action Largo proposed.</p>
<p>We don&#39;t want it at zero. Zero would mean either that Largo only does trivial things, or — much worse — that people have stopped reading the proposals and are approving on reflex. A healthy override rate is nonzero and slowly declining, which reads as <em>the system is proposing real work, users are genuinely evaluating it, and it&#39;s getting better at knowing what you&#39;d want</em>.</p>
<p>Watching that number changed a product decision. Overrides clustered hard in one workflow, and the pattern in the corrections was consistent: users kept narrowing the scope of what Largo touched. That wasn&#39;t a model quality problem, which is what we&#39;d assumed for a month. It was a permissions design problem. We shipped a scope control, and the override rate in that workflow dropped by two-thirds.</p>
<p>We would not have found that by reading the model evals. It was visible only at the joint — the seam between what Largo proposed and what a human accepted.</p>
<h2 id="why-this-generalizes">Why this generalizes</h2>
<p>Every product in the portfolio has a version of this seam. Richie proposes a tax position and a human accepts it. OnChainMind proposes a trade and a policy accepts it. PLAY.PAUSE.PLAI. proposes a release and an ear accepts it.</p>
<p>The seam between machine judgment and human acceptance is the most information-dense joint in an AI company, and it&#39;s the one nearly everyone leaves uninstrumented — because model evals feel like the rigorous thing to measure, and they&#39;re measuring the segment rather than the fitting.</p>
<p>Put a gauge on that joint. It&#39;ll tell you more about your product than any benchmark will.</p>]]></content:encoded>
      <category>portfolio</category>
      <category>largo</category>
      <category>agents</category>
      <category>trust</category>
    </item>
    <item>
      <title>What AI actually changes about the pipe</title>
      <link>https://theclearpipe.com/blog/what-ai-changes-about-the-pipe/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/what-ai-changes-about-the-pipe/</guid>
      <pubDate>Mon, 13 Jul 2026 13:00:00 GMT</pubDate>
      <description>The speed story is the boring one. The real shift is that the cost of making a business legible collapsed, which turns opacity from a constraint you inherit into a choice you make.</description>
      <content:encoded><![CDATA[<p>The standard claim about AI in business is that it makes things faster. That&#39;s true and it&#39;s the least interesting thing you can say about it, because speed alone doesn&#39;t change structure. A faster clog is still a clog. A dark process running at four times the rate goes wrong four times as fast, and you find out on the same delay.</p>
<p>The change that actually matters is different, and it took me a while to see it clearly.</p>
<p><strong>AI collapsed the cost of making a business legible.</strong></p>
<p>For most of business history, understanding your own operations was expensive. Explaining a process well enough for someone else to run it took real work. Instrumenting a workflow meant an engineering project. Reading everything that happened last week — every ticket, every call, every handoff — was simply impossible at any budget, so companies sampled and inferred and called it management.</p>
<p>All three of those costs fell by roughly an order of magnitude, at the same time, in about two years. That&#39;s the event. Everything else is downstream of it.</p>
<h2 id="three-specific-collapses">Three specific collapses</h2>
<p><strong>Describing a process is now nearly free.</strong> Point a model at the artifacts of a workflow — the tickets, the transcripts, the commits, the emails — and it will produce an accurate description of what actually happens, as distinct from what the process document claims. The gap between those two things used to require a consultant and six weeks. It now requires an afternoon, and the output is better because it&#39;s derived from evidence rather than interviews.</p>
<p>This matters because <em>a described process is a segment</em>. The In and the Out become explicit. Once they&#39;re explicit, the step can be delegated, replaced, parallelized, or automated. Description is what turns a situation into a segment, and description just got cheap.</p>
<p><strong>Reading everything is now possible.</strong> Not sampling. Everything. Every support conversation, every sales call, every code review. The gauges you can build on top of exhaustive reading are qualitatively different from the ones built on aggregates — you can measure <em>why</em> things happen, not just how often, and &quot;why&quot; was previously a thing you could only guess at from a sample of ten.</p>
<p><strong>Doing the work is now delegable to a segment that doesn&#39;t sleep.</strong> This is the part everyone leads with, and it&#39;s real. But notice the ordering: it&#39;s third, and it depends on the first two. An agent can only run a process that&#39;s been described, and you can only trust it if you&#39;re reading what it did.</p>
<h2 id="the-trap">The trap</h2>
<p>Here&#39;s where I&#39;ve watched teams go wrong, more than once, including in my own portfolio.</p>
<p>Automation applied to a <em>situation</em> — an undefined, uninstrumented step — doesn&#39;t produce a segment. It produces a faster, darker situation. You&#39;ve replaced a person who at least noticed when things felt wrong with a system that has no such instinct, running at a volume no human is reviewing.</p>
<p>The failure looks like this: the agent handles the first four hundred cases beautifully. Case four hundred and one is subtly different. The agent handles it confidently and wrongly, and then handles the next three thousand of the same kind exactly as wrongly, because nothing in the loop was watching for a change in the distribution. You find out from a customer. By then the error is in the data, the invoices, and the reputation.</p>
<p>A human in that seat would have felt the wrongness by case three. Not because humans are smarter — because humans are <em>continuous observers</em> by default, and that observation was doing load-bearing work nobody had written down.</p>
<p>When you automate, you have to replace that observation explicitly. That&#39;s what a gauge is for, and it&#39;s why the law of clarity isn&#39;t a nice-to-have in an AI-operated company. It&#39;s the thing that makes automation safe enough to be worth doing.</p>
<h2 id="what-this-means-for-how-you-build">What this means for how you build</h2>
<p>Three practical consequences.</p>
<p><strong>Instrument before you automate, not after.</strong> The gauge has to exist first, because its job is to tell you whether the automation is working. Build the number, watch a human produce it for two weeks so you know its normal range, then hand the segment over. Now you have a baseline and a live signal — and a rollback story that isn&#39;t &quot;we noticed vibes were off.&quot;</p>
<p><strong>Measure the override rate.</strong> The single most useful gauge in an AI-operated segment is how often a human disagrees with the machine and changes the outcome. Trending down means the system is learning your business. Trending up means the world moved and the system didn&#39;t. Flat at zero means nobody is reviewing, which is not the same as being right and is much more dangerous than a high override rate.</p>
<p><strong>Make the reasoning inspectable, not just the result.</strong> An agent that outputs an answer is a black box that happens to be fast. An agent that outputs an answer plus the path it took — inputs consulted, rules applied, alternatives rejected — is a segment with glass walls. The second one can be debugged, audited, improved, and defended to a customer. The first can only be trusted or replaced.</p>
<h2 id="the-bet">The bet</h2>
<p>Cheap intelligence makes opacity optional. When it costs nothing to describe, read, log, and publish what your business is doing, choosing not to is a decision — and increasingly a visible one, because your competitor&#39;s decision to be legible is right there for a customer to compare against.</p>
<p>I think that&#39;s the arbitrage of this decade. Not &quot;we use AI.&quot; Everyone will use AI, in eighteen months it&#39;ll be like saying you use electricity. The durable advantage is <em>we run in the open, and here&#39;s the gauge to prove it</em> — because the tooling that makes transparency cheap has arrived, and most companies will still choose the dark.</p>]]></content:encoded>
      <category>thesis</category>
      <category>ai</category>
      <category>agents</category>
      <category>transparency</category>
    </item>
    <item>
      <title>The dashboard nobody reads</title>
      <link>https://theclearpipe.com/blog/the-dashboard-nobody-reads/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/the-dashboard-nobody-reads/</guid>
      <pubDate>Mon, 06 Jul 2026 13:00:00 GMT</pubDate>
      <description>We built a beautiful metrics wall and watched it go stale in eleven days. What replaced it was uglier, smaller, and actually changed decisions.</description>
      <content:encoded><![CDATA[<p>We built a metrics wall for one of the portfolio companies in the spring. Thirty-one tiles. Real-time. It looked like the bridge of a ship.</p>
<p>Eleven days later I checked the analytics on the dashboard itself — which is a thing you should always do, and which almost nobody does — and found that after the first week, it had three regular viewers. All three were on the team that built it.</p>
<p>The dashboard wasn&#39;t wrong. Every number on it was accurate, live, and correctly computed. It was simply <em>unreadable</em>, in the specific sense that no one could look at it and know what to do next. And a number that doesn&#39;t change a decision is a number that costs money to maintain and returns nothing.</p>
<h2 id="why-it-failed">Why it failed</h2>
<p>Three reasons, and I think they&#39;re the standard three.</p>
<p><strong>It answered a question nobody was asking.</strong> The tiles were organized by data source — everything we could get from Stripe, everything from the product, everything from support. That&#39;s a convenient way to <em>build</em> a dashboard and a useless way to read one. Nobody arrives at a screen wondering &quot;what does Stripe know.&quot; They arrive wondering &quot;are we okay, and if not, where.&quot;</p>
<p><strong>It had no thresholds.</strong> Thirty-one numbers, no indication of which ones were fine. A reader had to hold the healthy range for every metric in their head to extract any signal at all. That&#39;s not a dashboard, that&#39;s a quiz. And when everything requires interpretation, people stop interpreting.</p>
<p><strong>Nobody owned any of it.</strong> It was &quot;the dashboard.&quot; Group ownership of a number is the same as no ownership of a number, and it shows up as a specific failure: a metric goes bad, everyone sees it, everyone assumes someone else is on it, and it stays bad for a month in full view of the entire company.</p>
<h2 id="what-replaced-it">What replaced it</h2>
<p>A weekly post in a shared channel. Eleven numbers. Plain text. Generated by a cron job at 8am Monday.</p>
<p>Each line looks like this:</p>
<pre><code>onboarding · median time to first import
  4.1 days (target &lt; 3)  ▲ 0.6 from last week   owner: @dana</code></pre>
<p>That&#39;s it. The number, the target, the delta, and a human being&#39;s name.</p>
<p>It is dramatically uglier than the wall of tiles. It is also read by everybody, every week, and it has produced more course corrections in two months than the dashboard did in its entire lifespan.</p>
<h2 id="what-made-the-difference">What made the difference</h2>
<p><strong>The target.</strong> A number without a target is trivia. Adding &quot;target &lt; 3&quot; converts every line into a yes-or-no question that anyone can answer in half a second without knowing anything about the business. This one change did more than the other three combined.</p>
<p><strong>The delta.</strong> Direction beats level almost every time. A metric sitting outside its target but improving for six straight weeks needs no intervention. A metric comfortably inside its target that has moved the wrong way three weeks running is the most valuable thing on the page — it&#39;s a problem you get to fix while it&#39;s still small.</p>
<p><strong>The name.</strong> Not a team, not a function. A person. It ends the diffusion of responsibility instantly, and — this surprised me — the owners like it. Being publicly accountable for a number turns out to be much less stressful than being vaguely accountable for an area, because a number tells you when you&#39;re done.</p>
<p><strong>The push.</strong> The dashboard waited to be visited. The post arrives. That distinction is the entire ballgame: the gauge that requires a decision to look at it will eventually stop being looked at, and it will stop precisely during the busy weeks when the readings matter most.</p>
<h2 id="the-uncomfortable-finding">The uncomfortable finding</h2>
<p>Going from thirty-one numbers to eleven meant deleting twenty numbers that were real, accurate, and genuinely interesting.</p>
<p>That was harder than it should have been, and the argument for keeping each one was always the same: &quot;but what if we need it?&quot; The answer is that it still exists. It&#39;s queryable. Nothing was deleted from the warehouse — it was removed from the <em>attention surface</em>, which is a completely different and far scarcer resource.</p>
<p>The wall of tiles wasn&#39;t a measurement system. It was a hedge against the discomfort of choosing. Picking eleven numbers means saying out loud which parts of the business you&#39;re watching, which means being wrong in public when the failure comes from somewhere you weren&#39;t looking. Thirty-one tiles let you avoid that by watching everything, which is the same as watching nothing while feeling responsible.</p>
<h2 id="the-rule-we-kept">The rule we kept</h2>
<p><strong>A gauge that doesn&#39;t change a decision isn&#39;t a gauge.</strong> It&#39;s a fact, and facts are cheap now — the marginal cost of computing another number rounds to zero, which is exactly why discipline about which ones you <em>display</em> matters more than it used to.</p>
<p>Before a number goes on the weekly post, it has to survive one question: <em>what would we do differently if this moved?</em> If nobody can answer, it doesn&#39;t go on. It can live in the warehouse with the rest of the facts, available to anyone who has a reason to ask.</p>
<p>The pipe is supposed to be clear. Clear is not the same as crowded.</p>]]></content:encoded>
      <category>field note</category>
      <category>metrics</category>
      <category>transparency</category>
    </item>
    <item>
      <title>Put a gauge on every joint</title>
      <link>https://theclearpipe.com/blog/put-a-gauge-on-every-joint/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/put-a-gauge-on-every-joint/</guid>
      <pubDate>Tue, 30 Jun 2026 13:00:00 GMT</pubDate>
      <description>A metric is not a gauge. A gauge is automatic, positioned at a seam, owned by someone, and readable by the people it affects — including customers.</description>
      <content:encoded><![CDATA[<p>Plumbers don&#39;t put pressure gauges in the middle of a straight run. They put them at the joints, because joints are where pressure changes and where failures start.</p>
<p>The same is true of businesses, and it&#39;s the single most common instrumentation mistake I see. Companies measure <em>activities</em> — calls made, tickets closed, features shipped — because activities happen inside a team and a team can report them. Almost nobody measures the seams between teams, which is precisely where the work gets stuck.</p>
<h2 id="what-separates-a-gauge-from-a-metric">What separates a gauge from a metric</h2>
<p>Plenty of numbers get called metrics. Very few of them are gauges. Four properties make the difference.</p>
<p><strong>A gauge is automatic.</strong> If a human assembles it, it isn&#39;t a gauge — it&#39;s a report, and reports have an author, a schedule, and a mood. Numbers produced by hand get produced late, get produced selectively under pressure, and stop entirely when the person who produced them is busy. Which is exactly when you need them.</p>
<p><strong>A gauge sits at a joint.</strong> It measures the flow <em>between</em> two segments, not the activity inside one. &quot;Tickets closed&quot; is inside. &quot;Median hours from ticket created to first human response&quot; is a joint — it spans the seam between intake and resolution, and it&#39;s the one a customer would recognize.</p>
<p><strong>A gauge has an owner.</strong> Not a viewer — an owner. A named role that is accountable for the reading and expected to act when it moves. An unowned dashboard is decoration; it will be watched attentively for two weeks and then never again.</p>
<p><strong>A gauge is readable by the people it affects.</strong> Internally, at minimum. Ideally by customers too. A number that only leadership can see will be optimized for leadership, and you will get a metric that goes up while the underlying thing gets worse.</p>
<h2 id="pick-the-number-a-customer-would-recognize">Pick the number a customer would recognize</h2>
<p>The best gauges describe an experience someone is actually having.</p>
<p>Not &quot;pipeline velocity&quot; — <em>how many days from the demo to a signed contract.</em> Not &quot;support efficiency&quot; — <em>what fraction of tickets get a real answer the same day.</em> Not &quot;model performance&quot; — <em>how often does the agent&#39;s recommendation survive human review.</em></p>
<p>The test: read the number out loud to a customer. If they&#39;d recognize it as a description of their own experience, it&#39;s a good gauge. If they&#39;d need a glossary, you&#39;re measuring your internal process rather than the flow through it — and internal-process numbers are the ones that drift furthest from reality before anyone notices.</p>
<h2 id="three-gauges-per-segment-maximum">Three gauges per segment, maximum</h2>
<p>The failure mode after &quot;no instrumentation&quot; is &quot;too much instrumentation,&quot; and it arrives faster than you&#39;d think. A dashboard with forty tiles is a dashboard nobody reads, which is functionally identical to no dashboard while costing considerably more to maintain.</p>
<p>Three per segment, chosen deliberately:</p>
<ol><li><strong>Throughput</strong> — how much is getting through per unit time.</li><li><strong>Latency</strong> — how long a unit takes to get through, measured at the median <em>and</em> at the 90th percentile. The median tells you about a normal day; P90 tells you about the customer who&#39;s about to leave.</li><li><strong>Quality</strong> — the rate at which output comes back. Rework, refunds, reopened tickets, escalations, human overrides of an agent&#39;s decision.</li></ol>
<p>Three numbers per segment across eight segments is twenty-four numbers, which is roughly the ceiling of what an organization can actually hold in its head. Beyond that, you&#39;re not measuring more — you&#39;re diluting attention, and attention is the scarce input that makes measurement worth anything.</p>
<h2 id="publish-the-readings">Publish the readings</h2>
<p>Here&#39;s where the law of clarity earns its keep, and where most companies quietly opt out.</p>
<p>A gauge that leadership reads privately is an early-warning system for exactly one group of people. A gauge published where the whole company can see it becomes something better: shared context. The person upstream of the clog finds out about it at the same moment as the person downstream, without a meeting, and the conversation starts from an agreed number instead of two competing impressions.</p>
<p>Publishing to customers is the harder version and the more valuable one. When an operational number is public, you can&#39;t quietly let it slide. You&#39;ll fix it, because the alternative is watching it sit there in public. That pressure is not a bug — it&#39;s the mechanism. Systems that are visible get maintained. Systems that are hidden get explained.</p>
<h2 id="start-with-three-gauges-not-thirty">Start with three gauges, not thirty</h2>
<p>If you&#39;re beginning from nothing, don&#39;t build a measurement program. Build three gauges this week:</p>
<ul><li><strong>Time from a customer asking for something to them getting it.</strong> Any customer, any request, measured end to end across every internal handoff.</li><li><strong>The size of your largest queue.</strong> Whatever is waiting on a human right now, counted. Queue length is the earliest signal of a clog and almost nobody watches it.</li><li><strong>Your rework rate.</strong> How often does completed work come back. This is your quality gauge, and it&#39;s usually the one nobody has ever computed.</li></ul>
<p>Three numbers, produced automatically, posted somewhere everyone can see, owned by a named role.</p>
<p>You&#39;ll learn more about your business in the first two weeks of watching those three than in a year of quarterly reviews — because a quarterly review is an argument about what happened, and a gauge is just what&#39;s happening.</p>]]></content:encoded>
      <category>playbook</category>
      <category>metrics</category>
      <category>transparency</category>
    </item>
    <item>
      <title>Cut your company into segments</title>
      <link>https://theclearpipe.com/blog/cut-your-company-into-segments/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/cut-your-company-into-segments/</guid>
      <pubDate>Wed, 24 Jun 2026 13:00:00 GMT</pubDate>
      <description>A practical exercise for turning an org chart into a pipe. Four columns, one afternoon, and a list of every place your business is held together by a person rather than an interface.</description>
      <content:encoded><![CDATA[<p>The org chart is a map of who reports to whom. It tells you almost nothing about how work moves, which is why it&#39;s useless for finding clogs. A pipe diagram tells you how work moves and says nothing about reporting lines, which is why I draw one for every company I&#39;m involved in.</p>
<p>Here&#39;s the exercise. It takes an afternoon and it is uncomfortable in a productive way.</p>
<h2 id="step-1-follow-one-unit-of-work-end-to-end">Step 1: Follow one unit of work end to end</h2>
<p>Pick something real that your business does repeatedly. A customer signing up. An invoice getting paid. A song getting released. Not the idealized version from the process doc — the actual version, the one that happened last Tuesday.</p>
<p>Now trace it. Every hand it passed through, every system it entered, every point where it sat and waited. Write each one down in order. Don&#39;t group, don&#39;t clean it up, don&#39;t skip the step where someone copied a value from one tool into another. That step is the most important thing on the page.</p>
<p>Most people expect eight steps and find twenty-three.</p>
<h2 id="step-2-for-each-step-fill-in-four-columns">Step 2: For each step, fill in four columns</h2>
<ul><li><strong>In</strong> — what must exist for this step to start?</li><li><strong>Out</strong> — what exists when it&#39;s done that didn&#39;t before?</li><li><strong>Owner</strong> — which role, not which person, is accountable?</li><li><strong>Gauge</strong> — what number would tell you this step is healthy, and where do you read it today?</li></ul>
<p>Fill these in honestly. The honesty is the whole exercise; a tidy chart of what should be true is worth nothing.</p>
<p>You will find three kinds of rows, and each one means something specific.</p>
<p><strong>Complete rows are segments.</strong> Defined in, defined out, a role that owns it, a number you can actually read. These are the parts of your business that can be scaled, delegated, automated, or replaced without an act of archaeology. Protect them.</p>
<p><strong>Rows with a blurry In or Out are situations.</strong> Work arrives here by custom rather than by definition — someone notices, or gets pinged, or checks a shared inbox. These are your clog candidates. They can&#39;t be handed off because there&#39;s nothing to hand.</p>
<p><strong>Rows with a person&#39;s name in the Owner column are single points of failure.</strong> Not because that person is bad — usually the opposite; they&#39;re your best person, which is exactly how they ended up holding it. But a step owned by a name rather than a role is a step that leaves when they do.</p>
<h2 id="step-3-circle-every-empty-gauge-cell">Step 3: Circle every empty Gauge cell</h2>
<p>This is the part that stings.</p>
<p>In most companies I&#39;ve run this on, somewhere between half and three-quarters of the Gauge column comes back empty, or comes back with an answer like &quot;we&#39;d know if it was broken.&quot; That&#39;s not a gauge. That&#39;s a hope with a job title.</p>
<p>An empty gauge cell means that step is dark. Not necessarily broken — dark. It might be running beautifully. You don&#39;t know, and neither does anyone else, and the first news you&#39;ll get is the news that arrives after a customer notices.</p>
<p>Every empty cell is a to-do item. It doesn&#39;t need to be a dashboard. It needs to be a number, produced automatically, that a named role looks at on a stated cadence. &quot;Median hours from signup to first successful import, posted in #ops every Monday&quot; is a complete gauge. It cost an afternoon to build and it will pay for itself the first time it moves.</p>
<h2 id="step-4-find-the-seam-that-hurts">Step 4: Find the seam that hurts</h2>
<p>Look at where work <em>waits</em> between rows. Not inside a step — between them. Handoffs are where companies leak, and the diagram makes them visible for the first time.</p>
<p>Ask two questions at each seam:</p>
<ul><li><strong>Does the receiving step have everything it needs the moment work arrives?</strong> If the answer involves anyone going back to ask a question, the upstream Out and the downstream In don&#39;t match. That mismatch is a fitting that doesn&#39;t fit, and it will cost you a little bit of every single unit of work forever.</li><li><strong>Would anyone notice if work stopped arriving here?</strong> If a queue can quietly go empty — or quietly grow — with no alarm, that seam is dark.</li></ul>
<p>Fix the fittings before you touch anything else. It&#39;s cheaper than reorganizing, it doesn&#39;t require anyone to change jobs, and it compounds: every unit of work through that seam gets faster from then on.</p>
<h2 id="what-you-do-with-the-diagram">What you do with the diagram</h2>
<p>Three things, in order.</p>
<ol><li><strong>Instrument the dark steps.</strong> Cheapest, fastest, highest leverage. You cannot prioritize what you cannot see, so this comes before any restructuring.</li><li><strong>Convert situations into segments.</strong> Write the In and Out explicitly. Publish them where the people doing the work can see them. This is not documentation for its own sake — the definition is what makes the step replaceable, and replaceable is the goal.</li><li><strong>Widen the constraint.</strong> Only now. With gauges in place and interfaces defined, the actual bottleneck is visible, and it&#39;s frequently not the one everybody assumed.</li></ol>
<h2 id="why-this-is-worth-an-afternoon">Why this is worth an afternoon</h2>
<p>Because from here on, growth is assembly.</p>
<p>When your business is a list of segments with defined fittings and live gauges, adding capacity is a decision rather than a project. You know which segment is at its limit, because the gauge says so. You know what a replacement has to accept and produce, because the In and Out are written down. You can hand a segment to a new hire, a vendor, or an agent, and evaluate the result against the same number you were already watching.</p>
<p>That&#39;s what &quot;everything connects&quot; buys you. Not elegance — optionality.</p>]]></content:encoded>
      <category>playbook</category>
      <category>operations</category>
      <category>segments</category>
    </item>
    <item>
      <title>Clogged or dark — the only two ways a business fails</title>
      <link>https://theclearpipe.com/blog/clogged-or-dark/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/clogged-or-dark/</guid>
      <pubDate>Fri, 19 Jun 2026 13:00:00 GMT</pubDate>
      <description>Every failure I have watched up close reduces to one of two conditions. The pipe stopped moving, or nobody could see inside it. The diagnosis matters because the fixes are opposites.</description>
      <content:encoded><![CDATA[<p>I&#39;ve been part of enough companies — mine and other people&#39;s — to have collected a decent sample of failures. For a long time I filed each one separately: the bad hire, the pricing mistake, the channel that dried up, the product nobody wanted.</p>
<p>Then I started sorting them by <em>mechanism</em> rather than by story, and the pile collapsed into two.</p>
<p><strong>The pipe clogged.</strong> Volume arrived and something couldn&#39;t pass it. Sales closed deals that delivery couldn&#39;t fulfill. Support tickets outran the people answering them. The founder became the bottleneck for every decision and the whole company waited on one calendar.</p>
<p><strong>The pipe went dark.</strong> Nobody could see what was happening inside, so problems compounded silently until they surfaced as a catastrophe. Churn that was visible in usage data for five months and in the P&amp;L for one. A vendor quietly failing SLA. An agent making the same wrong call four thousand times because no one was reading the log.</p>
<p>That&#39;s it. That&#39;s the taxonomy. Every other explanation I&#39;ve heard is one of these two wearing a costume.</p>
<h2 id="the-diagnosis-matters-because-the-treatments-are-opposite">The diagnosis matters because the treatments are opposite</h2>
<p>This isn&#39;t a cute framing exercise. Misdiagnosing which failure you have is how companies spend a year making things worse.</p>
<p>A clog is a <strong>capacity and interface</strong> problem. The fix is structural: find the segment that can&#39;t pass volume, and either widen it, split it, or replace it. More people won&#39;t help if the constraint is a serial approval step. Better tooling won&#39;t help if the constraint is that only one person knows how the thing works.</p>
<p>Darkness is an <strong>observation</strong> problem. The fix is instrumentation: put a gauge at the joint, publish the reading, and make someone accountable for looking at it. Restructuring won&#39;t help. Reorgs are the standard response to darkness, and they&#39;re almost always wrong — you can&#39;t fix a visibility problem by rearranging the people who can&#39;t see.</p>
<p>Here&#39;s the failure pattern I&#39;ve watched most often: a company goes dark, the symptoms surface as slowness, leadership diagnoses a clog, and responds by adding capacity. More headcount, more tooling, more process. The pipe gets wider <em>and</em> darker, because every new segment is another place you aren&#39;t measuring. Six months later the same crisis arrives, larger.</p>
<h2 id="how-to-tell-them-apart">How to tell them apart</h2>
<p>Clogs and darkness feel similar from the inside — both present as &quot;things are taking longer than they should.&quot; Three questions separate them.</p>
<p><strong>1. Can you name the constraint?</strong> If someone can point at a specific step and say &quot;everything queues here,&quot; you have a clog. If the answer is a shrug, or five people each name a different step, you&#39;re dark. You can&#39;t fix what you can&#39;t locate, and the inability to locate it <em>is</em> the finding.</p>
<p><strong>2. How did you learn about the last problem?</strong> If a gauge told you, you&#39;re lit. If a customer told you, you&#39;re dark. If you learned about it from a customer telling a <em>different</em> customer in public, you&#39;re dark and the darkness is now expensive.</p>
<p><strong>3. What happens if the person who owns this step is out for two weeks?</strong> If the answer is &quot;we&#39;re fine, it&#39;s documented and the handoff is defined,&quot; that&#39;s a segment. If the answer is &quot;we&#39;d be in real trouble,&quot; that&#39;s a situation — and situations are the raw material of both failure modes. They clog because they can&#39;t scale past one person&#39;s throughput, and they go dark because that person&#39;s knowledge isn&#39;t observable from outside their head.</p>
<h2 id="the-uncomfortable-version">The uncomfortable version</h2>
<p>Most companies are dark and don&#39;t know it, because darkness disguises itself as competence.</p>
<p>When you can&#39;t see inside your pipe, you rely on the people running each segment to tell you how it&#39;s going. Those people are not lying. They&#39;re reporting the view from where they stand, which is a view of their own segment, on a normal day, with the exceptions rounded off. Aggregate five of those reports and you get a picture of a company that&#39;s doing fine — assembled entirely from partial truths, none of which anyone would defend as a complete account.</p>
<p>The tell is the <em>shape</em> of your bad news. In a lit company, bad news arrives early, small, and specific: &quot;conversion on the trial-to-paid step dropped four points last week.&quot; In a dark company, bad news arrives late, large, and vague: &quot;Q3 came in soft.&quot;</p>
<p>If your bad news is always a surprise, you don&#39;t have a bad-luck problem. You have an instrumentation problem.</p>
<h2 id="both-laws-one-diagnosis">Both laws, one diagnosis</h2>
<p>This is why the two laws of the clear pipe are laws and not preferences.</p>
<p><em>Pipes connect</em> is the defense against clogging. A business made of segments with defined inputs and outputs can be widened at exactly the point that needs widening, because you know where the fittings are.</p>
<p><em>Glass reveals</em> is the defense against darkness. A business you can see into tells you which segment needs the work, in time to do the work.</p>
<p>Neither one saves you alone. A perfectly modular company that nobody monitors will fail silently, on schedule. A perfectly transparent company built out of one irreplaceable person will fail loudly, on schedule, with excellent dashboards documenting the whole descent.</p>
<p>You need the pipe to connect, and you need it to be clear. That&#39;s the entire thesis, and every post here is a footnote to it.</p>]]></content:encoded>
      <category>thesis</category>
      <category>diagnosis</category>
      <category>operations</category>
    </item>
    <item>
      <title>What we mean by a clear pipe</title>
      <link>https://theclearpipe.com/blog/what-we-mean-by-a-clear-pipe/</link>
      <guid isPermaLink="true">https://theclearpipe.com/blog/what-we-mean-by-a-clear-pipe/</guid>
      <pubDate>Mon, 15 Jun 2026 13:00:00 GMT</pubDate>
      <description>Every business is a pipe. Things go in one end, come out the other, and the interesting question is what happens in between — and whether anyone can see it.</description>
      <content:encoded><![CDATA[<p>Every business is a pipe. Attention goes in one end. Money comes out the other. In between there is a run of segments — marketing, sales, delivery, support, billing — and each one either moves the contents along or holds them up.</p>
<p>That&#39;s not a metaphor I picked because it sounded good on a landing page. I picked it because it&#39;s the only model I&#39;ve found that explains failure as well as it explains success. When a company is working, the pipe is flowing. When it isn&#39;t, one of exactly two things has gone wrong: the pipe is clogged, or the pipe has gone dark.</p>
<p>Everything on this site — the book, the portfolio, this blog — is an attempt to take that seriously enough to build on.</p>
<h2 id="the-two-laws">The two laws</h2>
<p><strong>Pipes connect.</strong> A segment of pipe is useful because it snaps onto another segment. It has a defined inlet and a defined outlet, and it does not care what&#39;s upstream or downstream as long as the fitting matches. Build your company that way and growth stops being reinvention and starts being assembly. You add a segment. You swap a segment. You run two in parallel when volume demands it.</p>
<p><strong>Glass reveals.</strong> A clear pipe lets anyone look in at any point and see what&#39;s actually moving. Not a summary of what moved last quarter. Not a number that a person assembled by hand on a Thursday. The thing itself, in flow, visible to the people who depend on it — including the customer.</p>
<p>Those two laws are simple enough to sound obvious and hard enough that almost nobody runs their company by them.</p>
<h2 id="why-connection-is-the-harder-discipline">Why connection is the harder discipline</h2>
<p>Most companies are not built out of segments. They&#39;re built out of <em>situations</em>. Someone needed a thing done, so a person started doing it, and over time that person accumulated a job that no one else can perform because no one ever defined what goes in or what comes out.</p>
<p>You can spot this immediately. Ask a team what their inputs are and watch what happens. If the answer is a list — &quot;a signed contract, the onboarding form, and the account ID&quot; — you have a segment. If the answer is a story about how work usually arrives, you have a situation.</p>
<p>Situations don&#39;t connect. They can&#39;t be extended, tested, replaced, or automated, because there&#39;s no fitting on either end. A company made of situations grows by adding people who each learn a private version of the process. A company made of segments grows by adding pipe.</p>
<p>The practical test I use: <strong>can I describe this part of the business as a function?</strong> Inputs, outputs, and a promise about what happens in between. If I can&#39;t write that sentence, the segment doesn&#39;t exist yet — I just have people being helpful near each other.</p>
<h2 id="why-clarity-is-the-harder-sell">Why clarity is the harder sell</h2>
<p>Connection is a design problem. Clarity is a nerve problem.</p>
<p>Making your business visible means accepting that people will see it on a bad day. The dashboard that shows a great month also shows the month where onboarding took nineteen days. The audit log that proves your agent made a good call also preserves the one where it didn&#39;t. Every company says it wants transparency until transparency has a cost, and then it discovers a sudden enthusiasm for &quot;context.&quot;</p>
<p>But opacity has a cost too, and it&#39;s larger — it&#39;s just deferred and diffuse, so nobody bills you for it directly. Opaque processes can&#39;t be debugged, because you can&#39;t fix what you can&#39;t observe. Opaque metrics can&#39;t be trusted, because the only proof is the assertion of the person reporting them. Opaque products lose to transparent ones the moment a customer has a choice, because trust compounds and mystery doesn&#39;t.</p>
<blockquote><p>What can be seen can be trusted, fixed, and scaled. What can&#39;t be seen gets replaced by something that can.</p></blockquote>
<h2 id="why-now">Why now</h2>
<p>This model has always been right, in the way that &quot;eat well and sleep enough&quot; has always been right. What changed is that it became <em>cheap</em>.</p>
<p>Instrumenting every joint in a business used to be a project. You needed a data team, a warehouse, a quarter, and the political capital to make five departments agree on what a &quot;customer&quot; is. Making a process explicit enough to hand off used to mean writing documentation that went stale before it was read.</p>
<p>Now, an agent can read the process, run the process, and log the process — and the log <em>is</em> the documentation. The cost of making a business legible has fallen through the floor, which means opacity is no longer a constraint you inherit. It&#39;s a choice you&#39;re making.</p>
<p>That&#39;s the bet behind everything here. Not that AI makes companies faster — it does, and that&#39;s the least interesting thing about it. The bet is that AI makes companies <em>legible</em>, and legible companies beat opaque ones over any timeframe that matters.</p>
<h2 id="what-this-blog-is">What this blog is</h2>
<p>A working log. I&#39;m building four companies on this model — Largo, Richie, OnChainMind, and PLAY.PAUSE.PLAI. — and writing the book that explains it. This is where the parts that don&#39;t fit in either one go: the playbooks, the teardowns, the things that broke, and the gauges we ended up adding after they broke.</p>
<p>Published in the open, on the same principle as everything else. If the thesis is that clarity beats opacity, the site had better be able to show its own work.</p>]]></content:encoded>
      <category>thesis</category>
      <category>two laws</category>
      <category>operating system</category>
    </item>
  </channel>
</rss>
