Build1 distinct publisher2 min readUpdated
Rands published his in March 2018, then spent parts of a month explaining what it was not. The writing did the work; sending it down the org chart did the damage.
The Engineer · Build desk
Compiled by The EngineerSomething wrong?How this is made
The mechanism here is an ordinary proxy problem. Two things could count as the output of a manager readme, and only one of them is countable: whether a document exists, and whether the manager actually worked out what they do to the people around them. Rands is clear which one paid off for him. The task was to reflect on what mattered to him as a leader, and getting it out of his head and onto the page forced him to think the subject through [6]. When the practice spread by imitation among the managers on his team, the file was the only visible part, so the file is what got shipped [7].
Then there is the reading problem, which depends entirely on direction. Rands's own entries are not policies, they are involuntary reactions. Hand him a task and he has already re-graded you on every prior task, and that grade quietly sets how much he hovers [12]. Let the team drift off a plan he never said out loud and the lists with boxes appear, and the boxes must be checked [13]. Read sideways by a peer, that is useful context. Read downward by someone whose compensation you set, the same sentence arrives as an instruction with no verb attached. Rands says the recipients were rightly furious and that the document can read like a manifesto [9][10]; what they were handed was a list of ways to not irritate their boss, with no standing to change any item on it.
Which is why the feedback pattern is the real finding. Of the three sections he names, habits, values, and Nuance and Errata, exactly one drew substantive response despite all the noise around the format [14][15][19]. It came from a General Counsel at a previous company, quoting the line about going quiet in groups larger than eight [16], who wrote "Now I understand you" [17]. A lateral reader, self-selected, using the text to reinterpret behaviour he had already observed. Nobody with something at stake wrote back.
That fits Rands's own standard, that leaders lead by mandate poorly and by example well, and that people watch how you act and decide for themselves whether it works [18]. A readme sent to reports has to compete with the behaviour they can see, and it only ever loses that argument: every gap between the stated principle and the Tuesday meeting is now documented in the manager's own words. Sent to a peer, there is no gap to audit, only a person to understand. The writing survived the fad in good shape. The distribution never had a case.
Follow any of these and your For You feed starts watching them — no settings page required.
Ranked by verification strength, evidence, and original report placement.
Rands was at Slack when the Manager Readme craze hit; managers on his team followed his lead, wrote their own, and then sent those Readmes to their teams.
Rands does not know how those managers framed the document when they sent it, but says he knows how it was received: "What the hell am I supposed to do with this?"
Rands wrote his own Manager Readme in March 2018 and enjoyed the process.
Rands published his Readme but says he did not think the point was to share it; the point was to write it.
Rands says the employees who received Readmes from their manager were rightly furious.
Rands says the document can read like a manifesto.
Evidence-backed comparisons of source perspectives and observed adoption signals. Read the methodology
Which Builder, Operator, and Investor concerns the observed source mix emphasized—not a truth score.
Evidence, demonstrated adoption, hype gap, incentives, and confidence are assessed independently, each on its own current evidence. How these are measured.
Single first-person account, quoted but uncorroborated
Everything rests on one essay by the participant. The verifiable pieces are strong in kind — a dated publication, verbatim quotes from his own Readme, and a quoted email reply from a former colleague's General Counsel — but there is no second publisher, no recipient testimony, and no record of the Slack managers' documents. Claims about reception and about the fad's arc are recollection.
One team's cascade, no counts
The only disclosed adoption is qualitative: the author's Readme plus an unspecified number of managers on his team at Slack writing and sending their own. Broader uptake is asserted as a fad with no counts, survey, or platform data, and the practice is described as already faded.
Modest generalization beyond one case
The piece is deflationary rather than promotional — it argues a popular artifact was misused and calls the author's own version dated. The mild overstatement is scope: a causal diagnosis of why the practice failed, and a three-year fad cadence for management trends generally, are drawn from one manager's experience on one team with no outcome data.
Personal-brand blog, no commercial stake disclosed
Self-published on the author's own long-running blog, which benefits from authority-building and internal archive traffic — the piece explicitly invites readers to click links showing they have been reading about his tics for years. There is no vendor, sponsor, product, or funding interest in the supplied text, and the author criticizes his own earlier artifact, which cuts against a promotional read.
Internally consistent, externally unverified
The narrative is coherent, specifically dated, and quotes primary material the author controls, so confidence in what he says he did and wrote is reasonable. Confidence in the wider claims — recipient fury, the fad's arc, the general failure mechanism — is limited by having exactly one self-interested account and no corroborating publisher in the cluster.
security
A staging password went into a Google Doc, and Google's autocomplete found it first1 distinct publisher
build
A batch job that returns false on failure makes your CloudWatch alarm decorative1 distinct publisher
security
Sophos: Fake AI Installers Drove 30 of 38 AI-Linked MDR Cases, With Claude the Favourite Costume1 distinct publisher
build
An agent built and deleted a prod stack. The alert fired on time and changed nothing1 distinct publisher
Distinct publishers with included, body-backed reporting in this cluster.
1 article · August 22, 2026