Lexicon
The book's own words
A book that coins its own terms owes you a glossary. These are the ones Project Ariadne uses as if you already knew them — each with the chapters where it is coined or earns its keep. Every one of them is a story compressed into a name.
- The thread #
-
The book’s own metaphor and the name of each chapter’s closing paragraph: not a map of the labyrinth — there is none — but a set of principles to hold onto when you’re lost.
Introduction, Epilogue
- Ariadne #
-
The sports-betting platform this book is named after: five teams that became nine, three stacks, millions spent, scrapped and restarted from scratch. The labyrinth the thread was for.
Introduction, Part IV opener, Chapters 8, 18–21
- The day of nothing #
-
A full working day, at Ariadne’s peak, producing zero, because everything I could touch was waiting on someone who would not decide.
Introduction, Chapter 20
- The database admin #
-
The one person allowed to touch Ariadne’s database; a queue of one that set the speed of the whole platform.
Chapters 8, 19
- Stefan #
-
The colleague who has quietly become a single point of failure: leaves on good terms, with cake, and eleven pages that answer nothing. Every team has one; on a long enough project, everyone becomes one.
Chapter 16
- The five percent / code blindness #
-
When something is familiar you stop seeing it; you see maybe five percent and your memory paints the rest. A guess, not a measurement, and the reason a newcomer can find in a week what four seniors missed for three years.
Chapters 5, 26
- The five-second rule #
-
Open a function. If a competent developer can’t tell you what it does in five seconds, it’s clever, and clever is the problem.
Chapter 1
- Do we need this now? #
-
The four-word question, asked out loud before any piece of work.
Chapter 1
- The twenty-line rule #
-
A function should fit in one glance. Held with ninety percent firmness.
Chapter 2
- The cabinet, the junk drawer, the newspaper rule #
-
Names nested like labeled drawers;
utilsas the drawer that means “I didn’t decide“; the most important thing at the top of every file.Chapter 2
- Why-comments #
-
The only comment worth writing: what the code cannot say — the incident, the ticket number, the cliff someone already drove off.
Chapter 3
- The boy-scout rule / leave it better #
-
Every file you pass through, a little better than you found it; kaizen at the scale of a file.
Chapter 4
- The health grade, the confusion log, the direction map #
-
Three instruments against blindness: an A-to-F per module argued over twice a year; everything that confused the newcomer, read by the team at day thirty; one page of where the architecture is heading, checked against reality each quarter.
Chapters 4, 5, 13
- Step nineteen #
-
The runbook step that was wrong for two releases and nobody noticed until the substitute deployed on a beach day. Any human step standing between a team and production.
Chapter 7
- Every change is releasable #
-
The main branch is always in a state you’d ship.
Chapter 7
- Cost of delay #
-
Finished work sitting unshipped is value already paid for and not collected — and learning already earned and not received.
Chapter 6
- The pin #
-
The question the machine chapters leave standing: if any change can ship any afternoon, what is the sprint for?
Chapters 7, 9, 17
- The sticky note #
-
“Deployments are painful,” which attended thirty retrospectives and changed nothing. A doer would have needed one.
Chapter 9
- Keep the appointments, kill the liturgy #
-
The test for any recurring meeting: did the machine improve because we held it?
Chapters 9, 12
- The collective brain #
-
A team is one brain distributed across several skulls; its intelligence is the parts times the bandwidth between them; trust is the protocol.
Chapter 10
- The pit stop #
-
Specialists moving as one organism on trust that was drilled, not hoped for.
Chapter 10
- The North Star / VTFM #
-
A direction clear enough to steer by, laddered down — Vision, Themes, Focus areas, Metrics — until it touches the ticket.
Chapter 11
- FIKA, the GSD day, the innovation week, the happiness index #
-
The rituals: agenda-less hours on the calendar; a monthly day for papercuts; a week in seven to build what you want; a crude score whose only value is its trend.
Chapter 12
- The welcoming buddy, the 90-day plan, the guide #
-
One named human for the newcomer; a one-page path through the fog; the prophet who knows everything and wants to spread it, proud of becoming unnecessary.
Chapter 13
- The one rule #
-
Nobody yells at anybody. The only rule in the book held with one hundred percent firmness.
Chapter 14
- The chimp #
-
The fast, ancient thinker that answers first when a review comment lands wrong. Embrace it; never let it publish.
Chapter 14
- Whiteboard prices #
-
The same disagreement costs a sentence at the whiteboard, a meeting mid-implementation, and a relationship at the review.
Chapter 14
- The beer test #
-
Would you choose to spend an unpaid hour with this person? Chemistry’s crudest measure, and its trap when it comes to mean “looks like us.”
Chapter 15
- The Code Vault #
-
One known place for the team’s externalized memory: question-shaped answers, demand-grown, reader-repaired, small and alive.
Chapter 16
- The red sprint #
-
The sprint that ends in failure, and what the organization does about it — the tell.
Chapter 18
- The four deaths #
-
One login feature that died four ways: the dependency, the undefined requirement, the late veto, the cross-team collision. None had a Scrum solution.
Chapter 18
- "Done" meant five things #
-
Five teams, five sincere definitions, one word. The reason is people.
Chapter 18
- The decision void / the sawn-in-half chair #
-
Nobody whose job is to decide; ownership handed down while authority stays up.
Chapter 20
- The engineer in a suit #
-
The best engineer you have, promoted into a job he is bad at and hates, and lost twice.
Chapter 21
- The heresy #
-
The product owner should be a senior developer.
Chapter 21
- No dogma #
-
Every principle in this book is a default, not a doctrine — including that one.
Chapters 2, 22, Interlude IV
- The why-station #
-
The question no pipeline asks: what problem does this solve, for whom, and how will we know?
Chapter 23
- Never trust the client #
-
Distrust the data, distrust the stated solution, trust the lived problem absolutely. Never trust the keyboard; trust the Tuesday.
Chapter 25
- Psychic weight #
-
Every open loop occupies a sliver of attention continuously; the cure is capture you can trust.
Chapter 28
- Monday vision, Friday reflection; the five-year game #
-
Ten minutes at each end of the week; once a year, five years forward and five back across the sections of a life.
Chapter 29
- The booklet of hope #
-
A store of the why and the good, kept outside yourself for the days you can’t generate it.
Chapter 31
These forty-one are the back matter of the printed book, reproduced here because a glossary is a hypertext object that has spent its whole life printed flat. Three chapters are free to read, and the terms in them link back here.