---
title: "Two Readers Were Hiding Inside Every Status Note I Wrote"
canonical: https://dxdev.com/everyday-ai/i-couldnt-read-my-own-note-days-later/
datePublished: 2026-08-04
---
Three days later, I hit a comment I had left myself, and I couldn't read it. I remembered writing it. I still had to stop, slow down, and [decode it like it belonged to someone else](/blog/surface-format-matches-audience/).

That was the tell. If the person who wrote a sentence can't parse it back cold, nobody reading it after them stood a chance.

## Two readers, and I kept writing for both at once

Every note I write has one real reader in mind, and it's always one of two kinds. Either a person skimming for a quick sense of where things stand, or a system that's going to act on the exact details later and needs the precise value, not a paraphrase of it. The mistake was writing as if both wanted the same thing. A person wants three seconds and a plain sentence. A system wants the exact number, because it's going to use that number, not just nod along at it.

Once I noticed it in that one comment, I started seeing it everywhere. Notes that were supposed to be a quick status update were full of the kind of precise detail only a system would ever need to act on. Each one was meant for a fast human read and had slowly filled up with the wrong kind of content, because writing both at once had felt efficient at the time.

It wasn't efficient. It cost twice. A person had to mentally strip out the technical detail to get the gist. And folding exact values into plain prose is how they get lost or garbled on the way in.

## Picking the reader first

The fix was to decide, before typing anything, who owns that particular surface, and to keep the two kinds of writing apart from then on. A status update that a person will skim gets written so someone unfamiliar with the details could still follow it in one read, with no lookups needed. Anything a system needs to act on precisely, an exact number or a specific setting, goes somewhere built for that.

The exact detail never disappears. It moves to the place built for the reader who needs it, instead of sitting in the note meant for someone glancing past it in three seconds.

## The part nobody automated

A person still decides which surface is for skimming and which is for exact values, and that decision has to happen before anything gets written, not after something turns out unreadable. What can be automated is catching the mixed cases and cleaning them up once the two kinds are told apart. Deciding where that line goes stays a human call, every time.

Before you write a status note, decide who it's for: someone skimming for a quick answer, or something that's going to act precisely on what you wrote. Then read it back cold a few days later. If you have to stop and decode it, so will everyone after you.